Практическая проверка Python 3.15 RC1: как проверить importlib.metadata MetadataNotFound для dist-info без metadata file при переходе на Python 3.15. Изолированный fixture, отрицательный контроль, заранее заданный критерий и безопасный пакет диагностики.
Пустой объект скрывает повреждение
В Python 3.15 metadata() и Distribution.metadata выбрасывают MetadataNotFound, если metadata directory существует, но самого metadata file нет; раньше возвращался пустой объект. Это подтверждает только границу функции, а не наличие проблемы в конкретном проекте. Практический симптом уже: Инструмент считает сломанный dist-info легальным пакетом с пустыми name/version и продолжает строить SBOM или отчёт зависимостей с фиктивной записью. До изменения кода зафиксируйте версию runtime, способ установки, один ожидаемый результат и один отрицательный исход. RC1 остаётся предварительным выпуском: его проверяют в отдельной среде, не ставят поверх рабочего interpreter и не используют один удачный запуск как разрешение на migration.
Три вида dist-info
Рекомендуемый fixture: создать отдельный temp sys.path с minimal dist-info directory сначала без METADATA, затем с минимальным валидным METADATA; вызвать metadata() и Distribution.metadata. Дайте ему метку T23-16, отдельный temp root и короткий deadline. Входы должны быть синтетическими, повторяемыми и минимальными; каждый новый запуск получает новые объекты и процесс, если cache или global state способны изменить наблюдение. До опыта запишите точную команду и ожидаемый class результата. Не включайте рабочие конфиги, адреса, токены, персональные строки, production PID или полные environment dumps.
Новый процесс против cache
Опровергающий маршрут: добавить полностью отсутствующий distribution и валидный directory; очищать importlib.metadata caches между A-B-A2 или запускать каждый case в новом процессе. Собирайте строки формата «dist-info | METADATA есть | name/version | API | результат | exception class | запись попала в отчёт». Порядок control A, target B, fresh control A2 обнаруживает загрязнение fixture: если A2 расходится с A, итог нельзя помечать passed. Пустое поле не равно нулю, отсутствие exception не доказывает правильную семантику, а изменение двух параметров сразу лишает опыт диагностической силы. Соседние причины получают отдельные строки, а не удобное общее объяснение.
Классификация для SBOM
Зелёный критерий сформулирован заранее: повреждённая директория классифицируется как MetadataNotFound, валидная возвращает поля, отсутствующий distribution не склеивается с damaged case. Ветка not reproduced означает только отсутствие симптома в этой версии fixture; blocked означает нехватку capability или источника; failed control возвращает расследование к стенду. Стоп-линия: {item['stop']}. Нельзя добиваться зелёного результата отключением проверки, broad except, ростом лимита, повторением до случайного успеха или подменой предварительного release стабильным обещанием. После теста удаляются только созданные temp-ресурсы.
Почему нельзя создавать пустой METADATA
Для maintainer или поддержки подготовьте: имена синтетических dist-info, два безопасных METADATA, API calls, exception repr и cache strategy без полного списка установленных пакетов. Добавьте label T23-16, московский timestamp, точную версию RC и формулировку критерия «повреждённая директория классифицируется как MetadataNotFound, валидная возвращает поля, отсутствующий distribution не склеивается с damaged case». Секреты, IP, hostnames, usernames, абсолютные домашние пути и полные логи удалите. Официальные источники подтверждают изменение «В Python 3.15 metadata() и Distribution.metadata выбрасывают MetadataNotFound, если metadata directory существует, но самого metadata file нет; раньше возвращался пустой объект.», но не подтверждают результат вашего теста, частоту проблемы или необходимость менять production. Такой пакет позволяет воспроизвести одну ветку, не раскрывая данные и не смешивая её с соседними issues.
Материал подготовлен редакцией VOne с помощью ИИ по открытым официальным и первичным источникам; факты, даты и ссылки перепроверены. Реальные пользовательские данные не использовались.
Источники и проверка
- Python 3.15.0rc1 release проверено 2026-08-29
- What’s New in Python 3.15 проверено 2026-08-29
- CPython issue #143387 on missing distribution metadata проверено 2026-08-29
Информация актуальна на дату публикации. Правила сервисов, приложений и сетей могут меняться.