Registry / devops / poetry-plugin-freeze

poetry-plugin-freeze

library1.2.0pypypiunverified

A Poetry plugin that freezes a wheel's dependency versions based on the current lock file, ensuring reproducible builds. Version 1.2.0 supports both Poetry v1 and v2, and requires Python ≥3.9.

devops workflow

pip install poetry-plugin-freeze==1.2.0

github ↗package ↗

INSTALL

IMPORT

SIG · POETRY-PLUGIN-FREE

poetry-plugin-freeze

devopspythonv1.2.0

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

After installing the plugin, use `poetry freezer freeze` to embed pinned dependency versions from the lock file into a wheel.

poetry self add poetry-plugin-freeze poetry build # To freeze dependencies for a specific wheel: poetry freezer freeze --file dist/*.whl --lock poetry.lock --output frozen_wheel.whl

Debug

Known issues

breakingPoetry v2 support requires plugin version >=1.2.0. Older versions (<=1.1.0) are incompatible with Poetry v2.

fix

Upgrade to poetry-plugin-freeze==1.2.0 or later.

affects: <=1.1.0

gotchaThe plugin does NOT freeze dev dependencies. Only main dependencies from the lock file are included.

fix

Ensure your dev dependencies are not needed for runtime wheel execution, or use a different approach to freeze them.

affects: all

deprecatedThe plugin is installed via `poetry self add`, not `pip install`. Using `pip install` will install the package but it won't be recognized as a Poetry plugin until you also run `poetry self add`.

fix

Run `poetry self add poetry-plugin-freeze` after `pip install` or directly `poetry self add`.

affects: all

Errors

Common errors & fixes

ModuleNotFoundError: No module named 'poetry.plugins'

Trying to import the plugin directly in Python code. This is a CLI plugin, not a Python library.

fix

Do not import it; use as a Poetry CLI command: `poetry freezer`.

Poetry cannot find the plugin after pip install

The plugin must be installed into Poetry's environment via `poetry self add`, not just `pip install`.

fix

Run `poetry self add poetry-plugin-freeze` to register the plugin.

ValueError: Unsupported poetry version

Using an older plugin version with Poetry v2.

fix

Upgrade to poetry-plugin-freeze==1.2.0 which supports Poetry v2.

Upgrade

Version history

1.2.0latest on PyPI · released Feb 13, 2025

Audit

Dependencies

No dependency data recorded yet.

Agent activity

25 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/cloud-custodian/poetry-plugin-freeze ↗

packagehttps://pypi.org/project/poetry-plugin-freeze/ ↗