●Change8

Migrating to Poetry 2.2.0

Version 2.2.0 introduces 2 breaking changes. This guide details how to update your code.

Released: 9/14/2025

2
Breaking Changes
3
Migration Steps
7
Affected Symbols

⚠️ Check Your Code

If you use any of these symbols, you need to read this guide:

poetry showpoetry newpoetry installinstaller.no-binaryinstaller.only-binary[project.license]poetry-core

Breaking Changes

●Issue #1

Dependency group names are now normalized, which may affect how groups are referenced if they contained non-standard characters.

●Issue #2

installer.no-binary and installer.only-binary logic changed: explicit package names now take precedence over the :all: keyword.

Migration Steps

  1. 1
    Update project licenses to use valid SPDX expressions instead of table values to avoid deprecation warnings.
  2. 2
    Review dependency group names for normalization changes if using non-standard naming conventions.
  3. 3
    Ensure dulwich is updated to >=0.24.0.

Release Summary

This release introduces support for PEP 735 dependency groups and PEP 639 license clarity, adds JSON output to 'poetry show', and officially supports Python 3.14.

Need More Details?

View the full release notes and all changes for Poetry 2.2.0.

View Full Changelog