●Change8

Migrating to Poetry 2.1.0

Version 2.1.0 introduces 1 breaking change. This guide details how to update your code.

Released: 2/15/2025

1
Breaking Changes
2
Migration Steps
8
Affected Symbols

⚠️ Check Your Code

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

poetry buildpoetry newpoetry showpoetry initpoetry addpoetry env activatefindpythonpoetry-core

Breaking Changes

●Issue #1

The 'poetry new' command now defaults to the 'src' layout. Projects relying on the previous flat layout default will need to explicitly configure the structure or move files if they expected the old behavior.

Migration Steps

  1. 1
    Update scripts using 'poetry new' to account for the new 'src' layout default.
  2. 2
    Update 'poetry source add' commands to include a '--priority' flag to avoid deprecation warnings.

Release Summary

This release introduces experimental Python installation management, makes the build system agnostic, and changes the default project layout to 'src'. It also includes significant performance improvements for dependency locking and numerous bug fixes related to PEP compliance and environment handling.

Need More Details?

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

View Full Changelog