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

Запланировано к удалению в Python 3.13¶Pending Removal in 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: Migrating from Legacy (gh-106531)

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

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

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

  • ast.Num

  • ast.Str

  • ast.Bytes

  • ast.NameConstant

  • ast.Ellipsis

  Вместо этого используйте ast.Constant. (Автор: Serhiy Storchaka в gh-90953.)

• asyncio:

  • Классы наблюдателя дочерних процессов MultiLoopChildWatcher, FastChildWatcher, AbstractChildWatcher и SafeChildWatcher устарели и будут удалены в Python 3.14. (Автор: Kumar Aditya в gh-94597.)

  • asyncio.set_child_watcher(), asyncio.get_child_watcher(), asyncio.AbstractEventLoopPolicy.set_child_watcher() и asyncio.AbstractEventLoopPolicy.get_child_watcher() объявлены устаревшими и будут удалены в Python 3.14. (Автор: Kumar Aditya, gh-94597.)

  • Метод get_event_loop() политики цикла событий по умолчанию теперь генерирует DeprecationWarning, если текущий цикл событий не установлен и он решает создать новый. (Авторы: Serhiy Storchaka и Guido van Rossum, gh-100160.)

• collections.abc: Устарел ByteString. Рекомендуется Sequence или Buffer. Для использования в typing предпочтите объединение, например bytes | bytearray, или collections.abc.Buffer. (Автор: Shantanu Jain, gh-91896.)

• email: объявлен устаревшим параметр isdst в email.utils.localtime(). (Автор: Alan Williams, 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

  (Авторы: Jason R. Coombs и Hugo van Kemenade в gh-93963.)

• itertools имел недокументированную, неэффективную, исторически ошибочную и непоследовательную поддержку операций copy, deepcopy и pickle. Это будет удалено в версии 3.14 для значительного сокращения объёма кода и нагрузки по сопровождению. (Автор: Raymond Hettinger, 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() вместо этого. (Автор: Nikita Sobolev, gh-97850.)

• pty:

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

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

• sqlite3:

  • version и version_info.

  • execute() и executemany(), если используются именованные заполнители и параметры являются последовательностью, а не dict.

• typing: ByteString, устаревший начиная с Python 3.9, теперь вызывает DeprecationWarning при использовании.

• urllib: urllib.parse.Quoter объявлен устаревшим: он не был задуман как публичный API. (Автор: Gregory P. Smith, gh-88168.)

Запланировано к удалению в Python 3.15¶Pending Removal in 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(). (Автор: Hugo van Kemenade, gh-111187.)

• pathlib: pathlib.PurePath.is_reserved() устарел и запланирован к удалению в Python 3.15. Начиная с Python 3.13, используйте os.path.isreserved для обнаружения зарезервированных путей в Windows.

• platform: java_ver() устарел и будет удалён в 3.15. Он был в основном не протестирован, имел запутанный API и был полезен только для поддержки Jython. (Автор: Nikita Sobolev, gh-116349.)

• sysconfig:

  • Аргумент check_home функции sysconfig.is_python_build() считается устаревшим начиная с Python 3.12.

• threading: Передача любых аргументов в threading.RLock() теперь устарела. Версия на C допускает любое количество args и kwargs, но они просто игнорируются. Версия на Python не допускает никаких аргументов. Все аргументы будут удалены из threading.RLock() в Python 3.15. (Автор: Nikita Sobolev, 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 с 0 полями, используйте class NT(NamedTuple): pass или NT = NamedTuple("NT", []).

• typing.TypedDict: При использовании функционального синтаксиса для создания класса TypedDict, отсутствие значения у параметра fields (TD = TypedDict("TD")) устарело. Передача None в параметр fields (TD = TypedDict("TD", None)) также устарела. Оба варианта будут запрещены в Python 3.15. Чтобы создать класс TypedDict с 0 полями, используйте class TD(TypedDict): pass или TD = TypedDict("TD", {}).

• wave: Устарели методы getmark(), setmark() и getmarkers() классов wave.Wave_read и wave.Wave_write. Они будут удалены в Python 3.15. (Автор: Victor Stinner, gh-105096.)

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

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

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

• array: array.array тип 'u' (wchar_t): используйте тип 'w' вместо него (Py_UCS4).

• builtins: ~bool, побитовая инверсия для bool.

• symtable: Устарел symtable.Class.get_methods() из-за отсутствия интереса. (Автор: Bénédikt Tran, gh-119698.)

Запланировано к удалению в будущих версиях¶Pending Removal in Future Versions

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

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

• Код формата 'u' для array (gh-57281)

• builtins:

  • bool(NotImplemented).

  • Генераторы: сигнатура 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.

  • Делегирование int() методу __trunc__().

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

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

• 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 для возвращаемых значений.

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

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

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

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

• Модули sre_compile, sre_constants и sre_parse.

• 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).

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

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

  • splitattr()

  • splithost()

  • splitnport()

  • splitpasswd()

  • splitport()

  • splitquery()

  • splittag()

  • splittype()

  • splituser()

  • splitvalue()

  • to_bytes()

• urllib.request: Стиль вызова запросов URLopener и FancyURLopener устарел. Используйте более новые функции и методы urlopen().

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

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

• zipimport.zipimporter.load_module() устарело: используйте exec_module() вместо него.

Устаревшие возможности C API¶C API Deprecations