Package: poetry-plugin-freeze
Freeze Wheel PluginPoetry plugin for creating frozen wheels using lockfiles.WhyA common issue when publishing a Python application's release into PyPI, is whether or not the dependencies specified will continue to work over time. This tends to happen due to a confluence of reasons, poor dependency specification, bad observance of semantic versioning, or poor release management by the dependency. That translates to a reality where installing an older release of the application is unlikely to work, due to changes in the underlying dependency graph.The dependency ecosystem is both complex and fragile. The emergence of lock files to ensure repeatability is testimony both to the problem and one solution. Yet when we go to publish in the packaging ecosystem we do so with non frozen dependencies specifications not with lockfiles. That means the testing pipelines that goes to produce and validate a release is against a lockfile but the release artifact is divorced of the lockfile contents, and starts to diverge from the moment of publication.The various language package distribution channels (npm, pypi, rubygems, etc) are used for two different primary distribution purposes, for both libraries and applications. Generally speaking the extant behavior is reasonable for a library. Libraries should be relatively liberal on their own dependencies baring perhaps major versions to minimize conflicts for applications depending on them and ideally consist of minimal dependencies graphs. But for applications distribution, repeatable and verifyable installs are fundamental goals with potentially large dependency graphs. Using a frozen dependency graph versus version specifications is the only way to ensure repeatiblity of installation over time. Fundamentally the two different distribution purposes have different audiences, ie.  libraries have developers and applications as consumers, applications have users as consumers.WhatA post build / pre publish command to allow for creating wheels with frozen dependencies. Basically we update wheel metadata for Requires-Dist to replace the pyproject.toml based version specification to a frozen (ie. ==version) one based on the version from the poetry lock information.Note we can't use poetry to publish because the frozen wheel because it uses metadata from pyproject.toml instead
of frozen wheel metadata.Optional DependenciesFrozen wheel metadata will containProvides-Extraentries for anyextra / optional dependencies. FrozenRequires-Distlines will specifyextranames _for packages that appear only in the optional/extra dependency graph.If a package appears as both a nested "main" dependency and also as an "extra" dependency, itsRequires-Distentry in the frozen wheelwill notspecify an extra name.To define this behavior in relation to poetry'sexport plugin, these two flows should result in the same installed package set:#ExportFlowpoetry export -f requirements.txt > requirements.txt && pip install -r requirements.txt#Freeze-wheelFlowpoetry build && poetry freeze-wheel && pip install my_frozen_wheelAnd introducing extras:#ExportFlowpoetry export --extras gcp -f requirements.txt && pip install -r requirements.txt#Freeze-wheelFlowpoetry build && poetry freeze-wheel && pip install my_frozen_wheel[gcp]The difference is in when to choose which extras to install -exportdoes that at freeze time.freeze-wheelembeds the extracontextat freeze time, but defers the actual extra selection until install time.Usage# install pluginpoetryselfaddpoetry-plugin-freeze# build per normalpoetrybuild# add freeze steppoetryfreeze-wheel# Note we can't use poetry to publish because it uses metadata from pyproject.toml instead# of frozen wheel metadata.# publish per normaltwineuploaddist/*.whlMono-Repo SupportTo support mono repos consisting of multiple libraries/applications, when creating a frozen wheel, main group dependencies specified by path can be optionally substituted out for references to their release artifact versions.This assumes automation to run build and publish across the various subpackages, ie typically via make or just.