Устаревшие функции

Планируется удалить в Python 3.13

Модули (см. PEP 594):

• aifc
• audioop
• cgi
• cgitb
• chunk
• crypt
• imghdr
• mailcap
• msilib
• nis
• nntplib
• ossaudiodev
• pipes
• sndhdr
• spwd
• sunau
• telnetlib
• uu
• xdrlib

Другие модули:

• lib2to3 и программа 2to3 (gh-84540)

API:

• configparser.LegacyInterpolation (gh-90765)
• locale.resetlocale() (gh-90817)
• turtle.RawTurtle.settiltangle() (gh-50096)
• unittest.findTestCases() (gh-50096)
• unittest.getTestCaseNames() (gh-50096)
• unittest.makeSuite() (gh-50096)
• unittest.TestProgram.usageExit() (gh-67048)
• webbrowser.MacOSX (gh-86421)
• Цепочки дескрипторов classmethod (gh-89519)

• Устаревшие методы importlib.resources:

  • contents()
  • is_resource()
  • open_binary()
  • open_text()
  • path()
  • read_binary()
  • read_text()

  Вместо них используйте importlib.resources.files(). См. importlib-resources: переход с устаревшего интерфейса (gh-106531)

Планируется удалить в Python 3.14

• argparse: параметры type, choices и metavar функции argparse.BooleanOptionalAction устарели и будут удалены в версии 3.14. (Предложено Никитой Соболевым в gh-92248.)

• ast: следующие возможности были объявлены устаревшими в документации начиная с Python 3.8; теперь при обращении к ним или их использовании во время выполнения выдаётся предупреждение DeprecationWarning, и в Python 3.14 они будут удалены:

  • ast.Num
  • ast.Str
  • ast.Bytes
  • ast.NameConstant
  • ast.Ellipsis

  Вместо них используйте ast.Constant. (Предложено Сергеем Сторчаком в gh-90953.)

• asyncio:

  • Классы наблюдателей дочерних процессов MultiLoopChildWatcher, FastChildWatcher, AbstractChildWatcher и SafeChildWatcher устарели и будут удалены в Python 3.14. (Предложено Кумаром Адитьей в gh-94597.)
  • asyncio.set_child_watcher(), asyncio.get_child_watcher(), asyncio.AbstractEventLoopPolicy.set_child_watcher() и asyncio.AbstractEventLoopPolicy.get_child_watcher() устарели и будут удалены в Python 3.14. (Предложено Кумаром Адитьей в gh-94597.)
  • Метод get_event_loop() стандартной политики цикла событий теперь выдаёт предупреждение DeprecationWarning, если текущий цикл событий не задан и метод решает создать его. (Предложено Сергеем Сторчаком и Гвидо ван Россумом в gh-100160.)
• collections.abc: устаревший тип ByteString. Предпочтительно использовать Sequence или Buffer. Для аннотаций типов предпочтительно использовать объединение, например bytes | bytearray, или collections.abc.Buffer. (Предложено Шантану Джейном в gh-91896.)
• email: параметр isdst функции email.utils.localtime() объявлен устаревшим. (Предложено Аланом Уильямсом в gh-72346.)
• importlib: система импорта перестанет устанавливать или учитывать __package__ и __cached__ (gh-97879).

• Устаревшие классы importlib.abc:

  • importlib.abc.ResourceReader
  • importlib.abc.Traversable
  • importlib.abc.TraversableResources

  Вместо них используйте классы importlib.resources.abc:

  • importlib.resources.abc.Traversable
  • importlib.resources.abc.TraversableResources

  (Предложено Джейсоном Р. Кумбсом и Хьюго ван Кеменаде в gh-93963.)

• itertools поддерживал операции копирования, глубокого копирования и сериализации с помощью pickle без документирования; эта поддержка была неэффективной, исторически содержала ошибки и была непоследовательной. Она будет удалена в версии 3.14, что позволит значительно сократить объём кода и затраты на его сопровождение. (Предложено Рэймондом Хеттингером в gh-101588.)
• multiprocessing: метод запуска по умолчанию будет заменён на более безопасный в Linux, BSD и других POSIX-платформах, кроме macOS, где сейчас используется 'fork' (gh-84559). Предупреждение во время выполнения сочли слишком обременительным, поскольку предполагается, что большинству кода это не важно. Используйте API get_context() или set_start_method(), чтобы явно указать, когда вашему коду требуется 'fork'. См. раздел Контексты и методы запуска.
• pathlib: передача дополнительных аргументов в is_relative_to() и relative_to() объявлена устаревшей.
• pkgutil: find_loader() и get_loader() теперь вызывают предупреждение DeprecationWarning; вместо них используйте importlib.util.find_spec(). (Предложено Никитой Соболевым в gh-97850.)

• pty:

  • master_open(): используйте pty.openpty().
  • slave_open(): используйте pty.openpty().

• sqlite3:

  • version и version_info.
  • execute() и executemany(), если используются именованные заполнители, а parameters является последовательностью, а не dict.
• typing: использование ByteString, объявленного устаревшим начиная с Python 3.9, теперь вызывает предупреждение DeprecationWarning.
• urllib: urllib.parse.Quoter объявлен устаревшим, поскольку не предназначался для использования в качестве публичного API. (Предложено Грегори П. Смитом в gh-88168.)

Планируется удалить в Python 3.15

• http.server.CGIHTTPRequestHandler будет удалён вместе со связанным флагом --cgi у python -m http.server. Он устарел и редко использовался. Прямой замены нет. Для взаимодействия веб-сервера с обработчиком запросов подойдёт что угодно, кроме CGI.

• importlib:

  • Метод load_module(): вместо него используйте exec_module().
• locale: locale.getdefaultlocale() была объявлена устаревшей в Python 3.11, и изначально её планировали удалить в Python 3.13 (gh-90817), однако удаление отложили до Python 3.15. Вместо неё используйте locale.setlocale(), locale.getencoding() и locale.getlocale(). (Предложено Хьюго ван Кеменаде в gh-111187.)
• pathlib: pathlib.PurePath.is_reserved() объявлен устаревшим и будет удалён в Python 3.15. Начиная с Python 3.13 для проверки путей, зарезервированных в Windows, используйте os.path.isreserved.
• platform: java_ver() объявлена устаревшей и будет удалена в версии 3.15. Она практически не тестировалась, имела запутанный API и была полезна только для поддержки Jython. (Предложено Никитой Соболевым в gh-116349.)

• sysconfig:

  • Аргумент check_home функции sysconfig.is_python_build() объявлен устаревшим начиная с Python 3.12.
• threading: передача любых аргументов в threading.RLock() теперь считается устаревшей. Версия на C принимает любое количество позиционных и именованных аргументов, но просто игнорирует их. Версия на Python не принимает никаких аргументов. В Python 3.15 все аргументы будут удалены из threading.RLock(). (Предложено Никитой Соболевым в gh-102029.)

• typing.NamedTuple:

  • Недокументированный синтаксис с именованными аргументами для создания классов NamedTuple (NT = NamedTuple("NT", x=int)) объявлен устаревшим и будет запрещён в версии 3.15. Вместо него используйте синтаксис на основе классов или функциональный синтаксис.

• types:

  • types.CodeType: обращение к co_lnotab было объявлено устаревшим в PEP 626 начиная с версии 3.10; его планировали удалить в 3.12, но надлежащее предупреждение DeprecationWarning появилось только в 3.12. Может быть удалено в версии 3.15. (Предложено Никитой Соболевым в gh-101866.)

• typing:

  • При создании класса NamedTuple с помощью функционального синтаксиса объявлено устаревшим не передавать значение параметру fields (NT = NamedTuple("NT")). Также объявлена устаревшей передача None параметру fields (NT = NamedTuple("NT", None)). Оба варианта будут запрещены в Python 3.15. Чтобы создать класс NamedTuple с нулём полей, используйте class NT(NamedTuple): pass или NT = NamedTuple("NT", []).
• typing.TypedDict: при создании класса TypedDict с помощью функционального синтаксиса объявлено устаревшим не передавать значение параметру fields (TD = TypedDict("TD")). Также объявлена устаревшей передача None параметру fields (TD = TypedDict("TD", None)). Оба варианта будут запрещены в Python 3.15. Чтобы создать класс TypedDict с нулём полей, используйте class TD(TypedDict): pass или TD = TypedDict("TD", {}).
• wave: методы getmark(), setmark() и getmarkers() классов wave.Wave_read и wave.Wave_write объявлены устаревшими. Они будут удалены в Python 3.15. (Предложено Виктором Стиннером в gh-105096.)

Планируется удалить в Python 3.16

• Система импорта:

  • Установка __loader__ для модуля без установки __spec__.loader объявлена устаревшей. В Python 3.16 система импорта и стандартная библиотека перестанут устанавливать или учитывать __loader__.
• array: тип 'u' array.array (wchar_t): вместо него используйте тип 'w' (Py_UCS4).
• builtins: ~bool, побитовая инверсия для bool.
• symtable: метод symtable.Class.get_methods() объявлен устаревшим из-за отсутствия интереса к нему. (Предложено Бенедиктом Траном в gh-119698.)

Будут удалены в будущих версиях

Устаревшие элементы C API