●Change8

Migrating to Poetry 2.1.3

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

Released: 5/4/2025

1
Breaking Changes
1
Migration Steps
3
Affected Symbols

⚠️ Check Your Code

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

importlib_metadatapoetry.env.activatepoetry.core.markers

Breaking Changes

●Issue #1

importlib-metadata version 8.7 introduced a breaking change; Poetry now requires importlib-metadata<8.7 on Python 3.9 to maintain compatibility.

Migration Steps

  1. 1
    For projects using Python 3.9, pin importlib-metadata to a version lower than 8.7 (e.g., add `importlib-metadata<8.7` to your dependencies).

Release Summary

This release pins importlib-metadata<8.7 for Python 3.9 due to upstream breaking changes and includes numerous bug fixes across Poetry and poetry-core.

Need More Details?

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

View Full Changelog