В 544 заброшенных пакетах PyPI нашли импорты удалённых модулей Python
py-code.org проверил последние релизы 354 763 проектов PyPI на импорты distutils, imp, cgi и ещё 22 удалённых модулей.
Проект py-code.org опубликовал исследование о том, сколько пакетов на PyPI сломалось после чистки стандартной библиотеки в Python 3.12 и 3.13. Среди 60 000 самых популярных проектов авторы нашли 852 пакета с незащищённым импортом удалённого модуля, причём 544 из них не выпускали релизов два года. За 30 дней до 13 ноября 2026 года, когда снимался срез, эти 544 проекта скачали 126 млн раз.
Для разработчиков это означает скрытый риск при обновлении: ошибка ModuleNotFoundError: No module named 'distutils' или 'imp' может прийти из транзитивной зависимости, которую тянет за собой другой пакет. Кроме того, по мнению авторов исследования, такой импорт служит простым индикатором заброшенности: если пакет давно не поддерживают, то и будущие уязвимости в нём чинить некому.
Ключевые выводы
- В индексе 354 763 проекта: удалённые в 3.12 и 3.13 модули импортируют 3763 из них (1,1%), а у 1623 импорт в собственном коде не защищён ни try/except, ни проверкой версии, ни объявленной зависимостью с копией модуля.
import noseиimport botoпадают на Python 3.12 и новее; вместе у пакетов 5,2 млн скачиваний в месяц при последних релизах 2015 и 2018 годов.- Для 890 проектов из 1623 достаточно установить setuptools: он по-прежнему поставляет distutils.
- pydub (7,5 млн скачиваний в месяц) падает на 3.13, хотя импорт обёрнут в try/except: запасной
import pyaudioopтоже не находит модуль. - Проверить свои зависимости можно поиском на py-code.org, командой
uvx py-code-org who-uses impили SQL-запросом к датасету.
Что удалили из стандартной библиотеки и что нашёл сканер?
Python 3.12 убрал distutils (PEP 632), а также imp, asyncore, asynchat и smtpd. Следующий релиз, Python 3.13, удалил ещё 20 модулей: lib2to3 и 19 «мёртвых батареек» из PEP 594, включая cgi, pipes, audioop, telnetlib, imghdr и crypt. Перед удалением каждый из этих 25 модулей оставался в статусе устаревшего минимум два релиза.
Чтобы оценить масштаб проблемы, py-code.org проиндексировал код последнего релиза для 354 763 проектов: всех пакетов с обновлениями с 13 ноября 2025 года по 13 ноября 2026 года, а также 60 000 самых скачиваемых независимо от даты. Авторы отобрали проекты с импортом любого из 25 удалённых модулей, заново скачали их архивы и разобрали каждый .py-файл через модуль ast без запуска кода. Импорт считался защищённым, если он находился в блоке try с перехватом ImportError, ModuleNotFoundError или Exception, в ветке except как запасной вариант или под проверкой версии Python. Тесты, setup.py, документация и примеры в расчёт не брались.
Чаще всего встречается distutils: его импортируют 2565 проектов, из которых у 973 импорт не защищён. Далее следуют cgi (455 и 248), imp (614 и 246), imghdr (114 и 85) и telnetlib (85 и 60). При этом модуль nis не использует ни один проект в индексе.
Почему ошибка с distutils появляется не у всех?
Из всех удалённых модулей только distutils часто исчезает незаметно для разработчика. Как отмечается в документации к Python 3.12, сторонний пакет Setuptools продолжает поставлять этот модуль, поэтому при его наличии import distutils работает и на 3.12, и на 3.13. Проблема возникает в чистых средах без setuptools: начиная с Python 3.12 команда python -m venv больше не ставит его по умолчанию, из-за чего ошибка проявляется в свежем venv, slim-образе Docker или окружении uv.
Среди популярных пакетов, которые запрашивают distutils прямо при импорте, авторы выделяют docker-pycreds (5,2 млн скачиваний в месяц, последний релиз в 2018 году), aioredis (1,3 млн, 2021), arsenic (1,2 млн, 2021), GPUtil (0,9 млн, 2018) и python-editor (0,7 млн, 2019). Поскольку у 890 проектов из 1623 все незащищённые импорты связаны исключительно с distutils, временно починить их можно одной командой:
Для долгосрочного решения в собственном коде py-code.org рекомендует перейти на актуальные аналоги: shutil.which вместо distutils.spawn.find_executable, packaging.version вместо distutils.version и sysconfig вместо distutils.sysconfig.
Какие известные пакеты падают прямо при импорте?
С модулем imp такой страховки нет: по умолчанию его ничего не подменяет, поэтому незащищённый import imp падает на любом Python начиная с 3.12. Наглядный пример дают два до сих пор востребованных пакета. У тестового раннера nose, которому на смену пришёл pytest, 1,8 млн скачиваний в месяц при последнем релизе в 2015 году: import nose загружает nose.importer, который начинается с import imp. Старый SDK для AWS boto, заменённый на boto3, собирает 3,4 млн скачиваний (последний релиз в 2018 году) и ломается аналогично через boto.plugin.
Переход на Python 3.13 добавляет новые поломки прямо при импорте: из-за cgi падают coreapi (0,5 млн, 2017) и htmlmin (0,7 млн, 2017), причём последний даже не использует импортированный модуль, а pgpy (0,8 млн, 2022) ломается из-за imghdr. У coloredlogs (21,6 млн) и humanfriendly (26,7 млн) сами библиотеки импортируются штатно, однако их консольные команды на 3.13 падают из-за import pipes.
Отдельный пример с pydub показывает, что даже защитная обёртка не гарантирует работу. В файле pydub/utils.py импорт написан через запасной вариант:
На Python 3.13 падает и основной импорт, и запасной, поскольку модуль по абсолютному имени pyaudioop не находится (так это описывают авторы исследования), и в итоге import pydub завершается ошибкой No module named 'pyaudioop'. У этого пакета 7,5 млн скачиваний в месяц при последнем релизе в 2021 году, а проблему решает установка audioop-lts. По формальным правилам сканера такой импорт считается защищённым, поэтому pydub не вошёл в статистику 1623 проектов: часть реальных поломок сканер пропускает.
Самые скачиваемые проекты без релизов с ноября 2024 года и с незащищённым импортом
10 сервисов, 4 столбца
Листайте столбцы →Смахните влевоВсе 4 столбца
py-code.org, срез на 13 ноября 2026 года
В то же время авторы уточняют, что незащищённый импорт не всегда означает полную неработоспособность пакета. Например, у future проблемные вызовы находятся в копиях модулей email и утилитах futurize и pasteurize, тогда как сам import future проходит успешно. Похожим образом pip по умолчанию использует sysconfig и обращается к коду с distutils только при особой настройке дистрибутива. Все примеры падающих пакетов авторы проверили по исходному коду релизов, не устанавливая и не запуская их.
При чём тут безопасность?
Сам по себе импорт удалённого модуля уязвимостью не считается. Однако в py-code.org обращают внимание на другое: мейнтейнер видел бы предупреждения об устаревании два релиза подряд, а правка обычно укладывается в одну строку. Если этого не произошло, пакет, скорее всего, заброшен, так что некому будет закрыть в нём новую уязвимость. В качестве иллюстрации авторы приводят два случая: в 2022 году злоумышленник перерегистрировал просроченный почтовый домен автора пакета ctx, сбросил пароль на PyPI и выложил вредоносные версии для кражи переменных окружения, а у pycrypto (последний релиз в 2014 году) патч для переполнения кучи CVE-2013-7459 лежит в репозитории, но так и не вышел в релиз.
Авторы допускают, что часть из 126 млн скачиваний приходится на транзитивные установки: устаревший пакет подтягивается как зависимость другого, и тот, кто запускает установку, может о нём не знать. Точной разбивки на прямые и транзитивные загрузки в исследовании нет.
Как проверить свой проект?
Самый быстрый способ проверить проект, по совету авторов: запустить тесты на Python 3.13 в чистом виртуальном окружении без setuptools. Узнать, какие пакеты импортируют конкретный удалённый модуль, можно без установки через поиск на py-code.org или командой в терминале:
Если проблемная зависимость обнаружена, есть три варианта действий:
- Заменить заброшенный пакет поддерживаемым аналогом: pytest вместо nose, boto3 вместо boto, redis-py вместо aioredis (последний уже влит в redis-py).
- Добавить в зависимости PyPI-пакет с копией удалённого модуля, если чужой код менять нельзя:
legacy-cgiилиstandard-cgiдляcgi,audioop-ltsдляaudioop,zombie-impдляimp, а такжеstandard-pipes,standard-imghdrиstandard-telnetlib. Большую часть этих замен перечисляют заметки к Python 3.13. - Перенести нужный фрагмент кода к себе в проект и поправить импорт вручную, если от пакета требуется лишь небольшая функция.
При обновлении собственного кода imp заменяется на importlib.import_module, importlib.util.spec_from_file_location и importlib.reload, pipes на subprocess и shlex.quote, cgi.escape на html.escape, а asyncore и asynchat на asyncio.
Все скрипты и результаты доступны в репозитории pypi-data/blog, а сам индекс выложен в виде датасета на Hugging Face, что позволяет воспроизвести расчёты или отфильтровать их по своему списку зависимостей. Главное ограничение методики, которое отмечают сами авторы, связано со статическим анализом синтаксического дерева без запуска кода: сканер пропускает ложные обёртки вроде pydub и может учесть импорт внутри невызываемой функции.
Источники: py-code.org: PyPI code that breaks on Python 3.12 and 3.13, GitHub: pypi-data/blog, скрипты и результаты исследования, What's New in Python 3.12, What's New in Python 3.13, PEP 594: Removing dead batteries from the standard library, PEP 632: Deprecate distutils module