Poetry 2.5 став швидшим і безпечнішим: важливе оновлення для Python-розробників

Python Poetry 2.5 отримав офіційну підтримку Python 3.15, серію прискорень і важливі виправлення роботи з обліковими даними приватних репозиторіїв. Це не революційна зміна синтаксису, але практичне оновлення для команд, які керують залежностями, віртуальними середовищами та публікацією Python-пакетів через один інструмент.

Офіційна підтримка Python 3.15

Poetry 2.5 і компонент poetry-core додають Python 3.15 до підтримуваних версій та автоматично створюваних класифікаторів пакета. Для бібліотек це важливо: метадані коректно повідомляють індексам і користувачам, з якими версіями інтерпретатора сумісний проєкт.

Оновлення не робить старий код автоматично сумісним із Python 3.15. Перед зміною мінімальної або максимальної версії все одно потрібно перевірити власні тести й залежності. Якщо частина бібліотек ще не випустила сумісні збірки, поспішне оновлення робочого середовища може зламати встановлення.

Менше очікування під час роботи із залежностями

Розробники оптимізували обробку сторінок репозиторіїв і посилань на пакети, розв’язання залежностей, вибір та встановлення wheel-файлів. Poetry також рідше запускає окремі процеси для визначення параметрів віртуального середовища, відкладає завантаження бібліотеки requests і кешує скомпільовані валідатори JSON Schema.

Точних універсальних цифр прискорення release notes не наводять, тому обіцяти однаковий виграш кожному проєкту не можна. Найбільша різниця ймовірна у великих графах залежностей, під час роботи з кількома індексами або частих чистих установлень у CI.

Виправлення для облікових даних

Окремий блок змін стосується безпеки репозиторіїв. Poetry більше не надсилає облікові дані, налаштовані для HTTPS-репозиторію, через звичайне HTTP-з’єднання. Також виправлено випадки, коли за наявності кількох сховищ на одному хості могли використовуватися дані доступу не від того репозиторію, а Git-залежність з однаковим шляхом на іншому хості могла отримати чужі облікові дані.

Після оновлення все одно варто переглянути конфігурацію. Секрети не слід зберігати у відкритих файлах репозиторію; для CI краще використовувати сховище секретів і короткоживучі токени. Якщо доступ до пакета працює лише через HTTP, проблема лежить не в Poetry — саме джерело потрібно перевести на захищене з’єднання.

Що ще виправили

Версія 2.5 коректніше працює з конфліктними вимогами, які фактично взаємовиключні через маркери середовища, з різними extras одного пакета та з додатковими групами залежностей. Виправлено встановлення GUI-скриптів і сценаріїв типу file, активацію середовища під час використання --directory, пошук застарілих пакетів у джерелах з пріоритетом explicit і низку складних випадків порівняння версій у poetry-core.

З’явилося налаштування installer.builtin-uninstall: воно дозволяє видаляти пакети вбудованим механізмом замість виклику pip uninstall. Це опція, а не причина негайно змінювати стабільний процес встановлення; спочатку її краще перевірити на тестовому середовищі.

Як оновлюватися без сюрпризів

• Закріпіть версію Poetry у CI. Локальне середовище та сервер складання мають використовувати однаковий випуск.
• Створіть тестову гілку. Запустіть poetry lock, порівняйте зміни lock-файла і виконайте повний набір тестів.
• Перевірте приватні індекси. Особливо конфігурації з кількома шляхами на одному домені.
• Не видаляйте старий кеш одразу. Спершу переконайтеся, що чисте встановлення відтворюється на всіх підтримуваних системах.
• Оновіть до 2.5.1. Patch-випуск з’явився невдовзі після 2.5.0 і містить додаткові виправлення; для нового встановлення варто брати актуальну стабільну версію гілки 2.5.

Кому оновлення найкорисніше

Poetry 2.5 особливо цікавий командам із великими lock-файлами, приватними пакетними індексами та планами тестувати Python 3.15. Невеликі проєкти теж отримають виправлення, але не обов’язково помітять різницю у швидкості. Як і будь-який інструмент керування залежностями, Poetry слід оновлювати разом із перевіркою результату, а не лише за номером версії.

Висновок: головна цінність релізу — поєднання продуктивності та коректнішої роботи з секретами. Це не гучна функція для кінцевого користувача, зате саме такі зміни зменшують час складання й ризик непередбачуваної поведінки в реальних Python-проєктах.

Перекладено й адаптовано за офіційними release notes Python Poetry 2.5.0 від 19 вересня 2026 року. Текст першоджерела охоплений MIT License. Обкладинка: MikeRun / Wikimedia Commons, CC BY-SA 4.0; адаптація зображення поширюється на тих самих умовах.