Explicitly depend on poetry-plugin-export

[johnthagen]

See

• https://python-poetry.org/blog/announcing-poetry-1.2.0/#migration-of-the-poetry-export-command

To reflect this, and to accelerate development of the main Poetry project, it has been migrated into a separate repo and is distributed separately as poetry-plugin-export.

To ease the transition, the plugin is installed by default for the 1.2 release. Future releases of Poetry will deprecate this automatic install, and require the user to explicitly install the plugin.

Since nox-poetry depends on poetry-plugin-export, it should document that users must install it or install it as a dependency (if that is supported for poetry plugins? A user might have to opt into this).

[johnthagen]

Note that this will become a more pressing issue because as of Poetry 1.7.0:

Print a future warning that poetry-plugin-export will not be installed by default anymore

• print a future warning that poetry-plugin-export will not be installed by default anymore python-poetry/poetry#8562

And perhaps soon:

• remove circular dependency on export plugin python-poetry/poetry#5980

[johnthagen]

A potential Poetry feature that would really help solve this for nox-poetry users is:

• How do I make part of and auto-enable plugins in my project python-poetry/poetry#5729
• poc: isolated project plugins & tools python-poetry/poetry#5740

[johnthagen]

Poetry 2.0 will have this and when it is released, we will need to update the docs here to instruct people on how to add the export plugin as a required plugin for their project

• Project plugins and forcing a minimum poetry version python-poetry/poetry#9547

[bosd]

What do we need to do to silence this warning and keep our projects running?

[johnthagen]

For Poetry <2.0, this is documented here: https://python-poetry.org/docs/plugins#using-plugins

Since it is another manual bootstrapping step, however, I'm personally allowing the warning to print until Poetry 2.0 is released and plugins can be explicitly declared as a dependency for a project, which scales much better with multiple team members.