Устаревания¶Deprecations

Запланировано к удалению в Python 3.16¶Pending removal in Python 3.16

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

  • Установка __loader__ в модуле при отсутствии __spec__.loader устарела. В Python 3.16 __loader__ перестанет устанавливаться или учитываться системой импорта или стандартной библиотекой.

• array:

  • Код формата 'u' (wchar_t) устарел в документации начиная с Python 3.3 и во время выполнения начиная с Python 3.13. Используйте код формата 'w' (Py_UCS4) для символов Unicode.

• asyncio:

  • asyncio.iscoroutinefunction() устарело и будет удалено в Python 3.16; используйте inspect.iscoroutinefunction() вместо этого. (Предложено Jiahao Li и Kumar Aditya в gh-122875.)

  • Система политик asyncio устарела и будет удалена в Python 3.16. В частности, следующие классы и функции устарели:

    • asyncio.AbstractEventLoopPolicy

    • asyncio.DefaultEventLoopPolicy

    • asyncio.WindowsSelectorEventLoopPolicy

    • asyncio.WindowsProactorEventLoopPolicy

    • asyncio.get_event_loop_policy()

    • asyncio.set_event_loop_policy()

    Для использования нужной реализации цикла событий следует применять asyncio.run() или asyncio.Runner с параметром loop_factory.

    Например, чтобы использовать asyncio.SelectorEventLoop в Windows:

    import asyncio
    
    async def main():
        ...
    
    asyncio.run(main(), loop_factory=asyncio.SelectorEventLoop)
    

    (Предложено Kumar Aditya в gh-127949.)

• builtins:

  • Поразрядная инверсия для булевых типов, ~True или ~False устарела начиная с Python 3.12, поскольку даёт неожиданные и неинтуитивные результаты (-2 и -1). Используйте not x для логического отрицания булевого значения. В редких случаях, когда требуется поразрядная инверсия базового целого числа, явно преобразуйте в int (~int(x)).

• functools:

  • Вызов реализации functools.reduce() на Python с function или sequence в качестве именованных аргументов устарел начиная с Python 3.14.

• logging:

  • Поддержка пользовательских обработчиков логирования с аргументом strm устарела и запланирована к удалению в Python 3.16. Вместо этого определяйте обработчики с аргументом stream. (Предложено Mariusz Felisiak в gh-115032.)

• mimetypes:

  • Допустимые расширения начинаются с точки ‘.’ или пусты для mimetypes.MimeTypes.add_type(). Расширения без точки устарели и будут вызывать ValueError в Python 3.16. (Предложено Hugo van Kemenade в gh-75223.)

• shutil:

  • Исключение ExecError устарело начиная с Python 3.14. Оно не используется ни одной функцией в shutil начиная с Python 3.4 и теперь является псевдонимом RuntimeError.

• symtable:

  • Метод Class.get_methods устарел начиная с Python 3.14.

• sys:

  • Функция _enablelegacywindowsfsencoding() устарела начиная с Python 3.13. Используйте переменную окружения PYTHONLEGACYWINDOWSFSENCODING.

• sysconfig:

  • Функция sysconfig.expand_makefile_vars() устарела начиная с Python 3.14. Используйте аргумент vars из sysconfig.get_paths().

• tarfile:

  • Недокументированный и неиспользуемый атрибут TarFile.tarfile устарел начиная с Python 3.13.

Запланировано к удалению в Python 3.17¶Pending removal in Python 3.17

• datetime:

  • strptime() вызовы со строкой формата, содержащей %e (день месяца) без указания года. Это объявлено устаревшим начиная с Python 3.15. (Автор: Stan Ulbrych в gh-70647.)

• collections.abc:

  • collections.abc.ByteString запланирован к удалению в Python 3.17.

    Используйте isinstance(obj, collections.abc.Buffer) для проверки, реализует ли obj протокол буфера во время выполнения. Для использования в аннотациях типов используйте Buffer или объединение, которое явно указывает типы, поддерживаемые вашим кодом (например, bytes | bytearray | memoryview).

    ByteString изначально задумывался как абстрактный класс, который должен был служить супертипом как для bytes, так и для bytearray. Однако, поскольку у ABC никогда не было методов, знание того, что объект является экземпляром ByteString, никогда не давало полезной информации об объекте. Другие распространённые типы буферов, такие как memoryview, также никогда не рассматривались как подтипы ByteString (ни во время выполнения, ни статическими проверками типов).

    См. PEP 688 для получения подробностей. (Автор: Shantanu Jain в gh-91896.)

• encodings:

  • Передача кодировок, не являющихся ASCII, в encodings.normalize_encoding() объявлена устаревшей и запланирована к удалению в Python 3.17. (Автор: Stan Ulbrych в gh-136702.)

• webbrowser:

  • webbrowser.MacOSXOSAScript объявлен устаревшим в пользу webbrowser.MacOS. (gh-137586)

• typing:

  • До Python 3.14 старые объединения реализовывались с помощью приватного класса typing._UnionGenericAlias. Этот класс больше не нужен для реализации, но он сохранён для обратной совместимости, его удаление запланировано на Python 3.17. Пользователям следует использовать документированные вспомогательные средства интроспекции, такие как typing.get_origin() и typing.get_args(), вместо того чтобы полагаться на детали приватной реализации.

  • typing.ByteString, устаревший с Python 3.9, запланирован к удалению в Python 3.17.

    Используйте isinstance(obj, collections.abc.Buffer) для проверки, реализует ли obj протокол буфера во время выполнения. Для использования в аннотациях типов используйте Buffer или объединение, которое явно указывает типы, поддерживаемые вашим кодом (например, bytes | bytearray | memoryview).

    ByteString изначально задумывался как абстрактный класс, который должен был служить супертипом как для bytes, так и для bytearray. Однако, поскольку у ABC никогда не было методов, знание того, что объект является экземпляром ByteString, никогда не давало полезной информации об объекте. Другие распространённые типы буферов, такие как memoryview, также никогда не рассматривались как подтипы ByteString (ни во время выполнения, ни статическими проверками типов).

    См. PEP 688 для получения подробностей. (Автор: Shantanu Jain в gh-91896.)

• tkinter:

  • Методы tkinter.Variable: trace_variable(), trace() (псевдоним trace_variable()), trace_vdelete() и trace_vinfo(), устаревшие с Python 3.14, запланированы к удалению в Python 3.17. Используйте trace_add(), trace_remove() и trace_info() вместо них. (Автор: Serhiy Storchaka в gh-120220.)

Запланировано удаление в Python 3.18¶Pending removal in Python 3.18

• Больше не принимает логическое значение, если ожидается файловый дескриптор. (Автор: Serhiy Storchaka в gh-82626.)

• decimal:

  • Нестандартный и недокументированный Decimal спецификатор формата 'N', который поддерживается только в реализации C модуля decimal, устарел с Python 3.13. (Автор: Serhiy Storchaka в gh-89902.)

• Устаревшие элементы, определённые PEP 829:

  • Строки import в файлах name.pth молча игнорируются.

  (Вклад: Barry Warsaw в gh-148641.)

Запланировано к удалению в Python 3.19¶Pending removal in Python 3.19

• ctypes:

  • Неявное переключение на совместимую с MSVC структуру путём установки _pack_ без _layout_ на платформах, отличных от Windows.

• hashlib:

  • В конструкторах хеш-функций, таких как new(), или прямых конструкторах, названных по имени хеша, таких как md5() и sha256(), их необязательный параметр начальных данных мог также передаваться как именованный аргумент с именем data= или string= в различных реализациях hashlib.

    Поддержка имени именованного аргумента string теперь устарела и будет удалена в Python 3.19.

    До Python 3.13 именованный параметр string не поддерживался правильно в зависимости от реализации хеш-функций на стороне бэкенда. Предпочтительно передавать начальные данные как позиционный аргумент для максимальной обратной совместимости.

• http.cookies:

  • http.cookies.Morsel.js_output() устарело и будет удалено в Python 3.19.

  • http.cookies.BaseCookie.js_output() устарело и будет удалено в Python 3.19.

• imaplib:

  • Изменение IMAP4.file теперь устарело и будет удалено в Python 3.19. Это свойство теперь не используется, и изменение его значения не приводит к автоматическому закрытию текущего файла.

    До Python 3.14 это свойство использовалось для реализации соответствующих методов read() и readline() для IMAP4, но с тех пор это уже не так.

Ожидается удаление в Python 3.20¶Pending removal in Python 3.20

• Вызов метода __new__() объекта struct.Struct без аргумента format устарел и будет удалён в Python 3.20. Вызов __init__() метода для инициализированных объектов Struct устарел и будет удалён в Python 3.20.

  (Вклад: Sergey B Kirpichev и Serhiy Storchaka в gh-143715.)

• Атрибуты __version__, version и VERSION были объявлены устаревшими в этих модулях стандартной библиотеки и будут удалены в Python 3.20. Вместо них используйте sys.version_info.

  • argparse

  • csv

  • ctypes

  • ctypes.macholib

  • decimal (используйте decimal.SPEC_VERSION вместо)

  • http.server

  • imaplib

  • ipaddress

  • json

  • logging (__date__ также устарел)

  • optparse

  • pickle

  • platform

  • re

  • socketserver

  • tabnanny

  • tarfile

  • tkinter.font

  • tkinter.ttk

  • wsgiref.simple_server

  • xml.etree.ElementTree

  • xml.sax.expatreader

  • xml.sax.handler

  • zlib

  (Вклад: Hugo van Kemenade и Stan Ulbrych в gh-76007.)

• Устаревшие элементы, определённые PEP 829:

  • Предупреждения выводятся для строк import, найденных в name.pth файлах.

  • Файлы name.pth больше не декодируются в кодировке локали по умолчанию. Они ДОЛЖНЫ быть закодированы в utf-8-sig.

  (Вклад: Barry Warsaw в gh-148641.)

• ast:

  • Создание экземпляров абстрактных узлов AST (таких как ast.AST или ast.expr) устарело и будет вызывать ошибку в Python 3.20.

Будет удалено в будущих версиях¶Pending removal in future versions

Следующие API будут удалены в будущем, хотя на данный момент нет запланированной даты их удаления.

• argparse:

  • Вложение групп аргументов и вложение взаимоисключающих групп устарело.

  • Передача недокументированного именованного аргумента prefix_chars в add_argument_group() теперь устарела.

  • Конвертер типов argparse.FileType устарел.

• builtins:

  • Генераторы: сигнатура throw(type, exc, tb) и athrow(type, exc, tb) устарела: используйте throw(exc) и athrow(exc) вместо неё, сигнатуру с одним аргументом.

  • В настоящее время Python принимает числовые литералы, за которыми сразу следуют ключевые слова, например 0in x, 1or x, 0if 1else 2. Это допускает запутанные и неоднозначные выражения вроде [0x1for x in y] (которое может быть интерпретировано как [0x1 for x in y] или [0x1f or x in y]). Выдаётся предупреждение синтаксиса, если за числовым литералом сразу следует одно из ключевых слов and, else, for, if, in, is и or. В будущем выпуске это будет изменено на синтаксическую ошибку. (gh-87999)

  • Поддержка методов __index__() и __int__(), возвращающих не-int тип: эти методы должны будут возвращать экземпляр строгого подкласса int.

  • Поддержка метода __float__(), возвращающего строгий подкласс float: эти методы должны будут возвращать экземпляр float.

  • Поддержка метода __complex__(), возвращающего строгий подкласс complex: эти методы должны будут возвращать экземпляр complex.

  • Передача комплексного числа в качестве аргумента real или imag в конструкторе complex() теперь устарела; его следует передавать только как единственный позиционный аргумент. (Автор: Сергей Сторчака в gh-109218.)

• calendar: константы calendar.January и calendar.February устарели и заменены на calendar.JANUARY и calendar.FEBRUARY. (Автор: Prince Roshan в gh-103636.)

• codecs: используйте open() вместо codecs.open(). (gh-133038)

• codeobject.co_lnotab: используйте метод codeobject.co_lines() вместо этого.

• datetime:

  • utcnow(): используйте datetime.datetime.now(tz=datetime.UTC).

  • utcfromtimestamp(): используйте datetime.datetime.fromtimestamp(timestamp, tz=datetime.UTC).

• gettext: значение множественного числа должно быть целым числом.

• importlib:

  • cache_from_source(): параметр debug_override устарел: используйте параметр optimization вместо него.

• importlib.metadata:

  • EntryPoints: интерфейс кортежа.

  • Неявное None для возвращаемых значений.

• logging: метод warn() устарел начиная с Python 3.3, используйте warning() вместо него.

• mailbox: использование StringIO в режиме ввода и текстовом режиме устарело, используйте BytesIO и двоичный режим.

• os: вызов os.register_at_fork() в многопоточном процессе.

• os.path: os.path.commonprefix() устарела, используйте os.path.commonpath() для префиксов путей. Функция os.path.commonprefix() объявлена устаревшей из-за вводящего в заблуждение названия и модуля. Эта функция небезопасна для использования в качестве префиксов путей, несмотря на то что находится в модуле для работы с путями, что означает, что легко случайно внести уязвимости обхода путей в программы на Python, используя эту функцию.

• pydoc.ErrorDuringImport: кортежное значение для параметра exc_info устарело, используйте экземпляр исключения.

• re: теперь применяются более строгие правила для числовых ссылок на группы и имён групп в регулярных выражениях. В качестве числовой ссылки теперь принимается только последовательность цифр ASCII. Имя группы в байтовых шаблонах и строках замены теперь может содержать только буквы ASCII, цифры и знак подчёркивания. (Автор: Сергей Сторчака в gh-91760.)

• shutil: параметр onerror метода rmtree() устарел в Python 3.12; используйте параметр onexc вместо него.

• ssl: опции и протоколы:

  • ssl.SSLContext без аргумента протокол устарело.

  • ssl.SSLContext: set_npn_protocols() и selected_npn_protocol() устарели: используйте ALPN вместо них.

  • ssl.OP_NO_SSL*: опции

  • ssl.OP_NO_TLS*: опции

  • ssl.PROTOCOL_SSLv3

  • ssl.PROTOCOL_TLS

  • ssl.PROTOCOL_TLSv1

  • ssl.PROTOCOL_TLSv1_1

  • ssl.PROTOCOL_TLSv1_2

  • ssl.TLSVersion.SSLv3

  • ssl.TLSVersion.TLSv1

  • ssl.TLSVersion.TLSv1_1

• threading: методы

  • threading.Condition.notifyAll(): используйте notify_all().

  • threading.Event.isSet(): используйте is_set().

  • threading.Thread.isDaemon(), threading.Thread.setDaemon(): используйте атрибут threading.Thread.daemon.

  • threading.Thread.getName(), threading.Thread.setName(): используйте атрибут threading.Thread.name.

  • threading.currentThread(): используйте threading.current_thread().

  • threading.activeCount(): используйте threading.active_count().

• typing.Text (gh-92332).

• Внутренний класс typing._UnionGenericAlias больше не используется для реализации typing.Union. Для сохранения совместимости с пользователями, использующими этот закрытый класс, будет предоставлена прослойка совместимости как минимум до Python 3.17. (Автор: Jelle Zijlstra, gh-105499.)

• unittest.IsolatedAsyncioTestCase: возврат значения, не являющегося None, из тестового примера устарел.

• urllib.parse устаревшие функции: используйте urlparse() вместо них.

  • splitattr()

  • splithost()

  • splitnport()

  • splitpasswd()

  • splitport()

  • splitquery()

  • splittag()

  • splittype()

  • splituser()

  • splitvalue()

  • to_bytes()

• wsgiref: SimpleHandler.stdout.write() не должна выполнять частичную запись.

• xml.etree.ElementTree: проверка истинностного значения Element устарела. В будущем выпуске она всегда будет возвращать True. Вместо этого используйте явные проверки len(elem) или elem is not None.

• sys._clear_type_cache() устарело: используйте sys._clear_internal_caches() вместо него.

Мягкие устаревания¶Soft deprecations

Планов по удалению мягко устаревших API нет.

• re.match() и re.Pattern.match() теперь мягко устарели в пользу новых API re.prefixmatch() и re.Pattern.prefixmatch(), которые были добавлены как альтернативные, более явные имена. Они предназначены для устранения путаницы относительно того, что означает match, следуя мантре Дзена Python «Явное лучше неявного». Большинство других библиотек регулярных выражений используют API с именем match для обозначения того, что в Python всегда называлось search.

  Мы не планируем удалять старое имя match(), так как оно используется в коде более 30 лет. Код, поддерживающий старые версии Python, должен продолжать использовать match(), а в новом коде следует предпочитать prefixmatch(). См. prefixmatch() vs. match().

  (Авторы: Gregory P. Smith, gh-86519, и Hugo van Kemenade, gh-148100.)

• Использование 'F' и 'D' кодов типа форматирования модуля struct теперь мягко устарело в пользу двухбуквенных форм 'Zf' и 'Zd'. (Вклад: Sergey B Kirpichev в gh-121249.)

Устаревания в C API¶C API deprecations