Что нового в Python 3.15¶What’s new in Python 3.15

PEP 810: Явные ленивые импорты¶PEP 810: Explicit lazy imports

Крупные приложения на Python часто страдают от медленного запуска. A значительный вклад в эту проблему вносит система импорта: при импорте модуля Python должен найти файл, прочитать его с диска, скомпилировать в байткод и выполнить весь код верхнего уровня. Для приложений с глубокими деревьями зависимостей этот процесс может занимать секунды, даже когда большая часть импортированного кода в конкретном запуске никогда не используется.

Разработчики обходили это, перенося импорты внутрь функций, используя importlib для загрузки модулей по требованию, или перестраивая код, чтобы избежать ненужных зависимостей. Эти подходы работают, но делают код сложнее для чтения и поддержки, разбрасывают операторы импорта по всей кодовой базе и требуют дисциплины для последовательного применения.

Python теперь предлагает более чистое решение через явные lazy импорты с использованием нового мягкого ключевого слова lazy. Когда импорт помечается как ленивый, Python откладывает фактическую загрузку модуля до первого использования импортированного имени. Это даёт преимущества организации: объявление всех импортов в начале файла, при этом затраты на загрузку возникают только для модулей, которые действительно используются.

Ключевое слово lazy работает как с операторами import, так и from ... import . При записи lazy import heavy_module Python не загружает модуль немедленно. Вместо этого он создаёт легковесный объект-прокси. Фактическая загрузка модуля происходит прозрачно при первом обращении к имени:

lazy import json
lazy from pathlib import Path

print("Starting up...")  # json и pathlib ещё не загружены

data = json.loads('{"key": "value"}')  # здесь загружается json
p = Path(".")  # здесь загружается pathlib

Этот механизм особенно полезен для приложений, которые импортируют много модулей на верхнем уровне, но могут использовать лишь часть из них в конкретном запуске. Отложенная загрузка снижает задержку запуска без необходимости перестройки кода или разбросанных по кодовой базе условных импортов.

В случае, если загрузка лениво импортированного модуля завершается ошибкой (например, если модуль не существует), Python возбуждает исключение в точке первого использования, а не во время импорта. Связанная трассировка включает как место, где было использовано имя, так и исходный оператор импорта, что упрощает диагностику и отладку сбоя.

Для случаев, когда нужно включить ленивую загрузку глобально без изменения исходного кода, Python предоставляет опцию командной строки -X lazy_imports и переменную окружения PYTHON_LAZY_IMPORTS. Обе принимают два значения: all делает все импорты ленивыми по умолчанию, а normal (по умолчанию) учитывает ключевое слово lazy в исходном коде. Функции sys.set_lazy_imports() и sys.get_lazy_imports() позволяют изменять и запрашивать этот режим во время выполнения.

Для более избирательного контроля sys.set_lazy_imports_filter() принимает вызываемый объект, который определяет, должен ли конкретный модуль загружаться лениво. Фильтр получает три аргумента: имя импортирующего модуля (или None), имя импортируемого модуля и fromlist (или None для обычных импортов). Он должен возвращать True, чтобы разрешить ленивый импорт, или False, чтобы принудительно загрузить сразу. Это позволяет, например, сделать ленивыми только модули вашего приложения, оставив сторонние зависимости обычными:

import sys

def myapp_filter(importing, imported, fromlist):
    return imported.startswith("myapp.")
sys.set_lazy_imports_filter(myapp_filter)
sys.set_lazy_imports("all")

import myapp.slow_module  # ленивый (соответствует фильтру)
import json               # жадный (не соответствует фильтру)

Сам тип прокси доступен как types.LazyImportType для кода, которому нужно программно обнаруживать ленивые импорты.

Существуют некоторые ограничения на то, где можно использовать ключевое слово lazy. Ленивые импорты разрешены только на уровне модуля; использование lazy внутри функции, тела класса или блока try/except/finally приводит к SyntaxError. Ни звёздочные импорты, ни future-импорты не могут быть ленивыми (lazy from module import * и lazy from __future__ import ... оба приводят к SyntaxError).

Для кода, который не может напрямую использовать ключевое слово lazy (например, при поддержке версий Python старше 3.15, но с использованием ленивых импортов на 3.15+), модуль может определить __lazy_modules__ как контейнер строк с полными именами модулей. Обычные операторы import для этих модулей затем обрабатываются как ленивые, с той же семантикой, что и ключевое слово lazy:

__lazy_modules__ = ["json", "pathlib"]

import json     # ленивый
import os       # всё ещё жадный

(Вклад Пабло Галиндо Сальгадо и Дино Виланда в gh-142349.)

PEP 814: Добавление встроенного типа frozendict¶PEP 814: Add frozendict built-in type

Новый неизменяемый тип, frozendict, добавлен в модуль builtins. Он не допускает изменений после создания. frozendict не является подклассом dict; он наследует напрямую от object. frozendict является хешируемым, пока все его ключи и значения хешируемы. frozendict сохраняет порядок вставки, но при сравнении порядок не учитывается.

Например:

>>> a = frozendict(x=1, y=2)
>>> a
frozendict({'x': 1, 'y': 2})
>>> a['z'] = 3
Traceback (most recent call last):
  File "<python-input-2>", line 1, in <module>
    a['z'] = 3
    ~^^^^^
TypeError: 'frozendict' object does not support item assignment
>>> b = frozendict(y=2, x=1)
>>> hash(a) == hash(b)
True
>>> a == b
True

Следующие модули стандартной библиотеки были обновлены для поддержки frozendict: copy, decimal, json, marshal, plistlib (только для сериализации), pickle, pprint и xml.etree.ElementTree.

eval() и exec() принимают frozendict для globals, и type() и str.maketrans() принимают frozendict для dict.

Код, проверяющий тип dict с помощью isinstance(arg, dict), может быть обновлён до isinstance(arg, (dict, frozendict)), чтобы также принимать тип frozendict, или до isinstance(arg, collections.abc.Mapping), чтобы также принимать другие отображающие типы, такие как MappingProxyType.

(Вклад Виктора Стиннера и Донхи На в gh-141510.)

PEP 661: Добавление встроенного типа sentinel¶PEP 661: Add sentinel built-in type

Новый тип sentinel добавлен в модуль builtins для создания уникальных sentinel-значений с кратким представлением. Sentinel-объекты сохраняют идентичность при копировании, поддерживают использование в выражениях типов с оператором | и могут быть сериализованы, если они импортируемы по модулю и имени.

(PEP от Таля Эйната; вклад Йелле Зийлстры в gh-148829.)

PEP 799: Выделенный пакет профилирования¶PEP 799: A dedicated profiling package

Добавлен новый модуль profiling, чтобы организовать встроенные средства профилирования Python в едином согласованном пространстве имён. Этот модуль содержит:

• profiling.tracing: детерминированная трассировка вызовов функций (перенесено из cProfile).

• profiling.sampling: новый статистический профилировщик с семплингом (назван Tachyon).

Модуль cProfile остаётся псевдонимом для обратной совместимости. Модуль profile устарел и будет удалён в Python 3.17.

(Авторы: Pablo Galindo и László Kiss Kollár в gh-138122.)

Tachyon: высокочастотный статистический профилировщик с семплингом¶Tachyon: High frequency statistical sampling profiler

Новый статистический профилировщик с семплингом (Tachyon) добавлен как profiling.sampling. Этот профилировщик позволяет выполнять анализ производительности запущенных процессов Python с низкими накладными расходами, не требуя изменения кода или перезапуска процесса.

В отличие от детерминированных профилировщиков (таких как profiling.tracing), которые инструментируют каждый вызов функции, профилировщик с семплингом периодически собирает стек-трейсы из запущенных процессов. Такой подход обеспечивает практически нулевые накладные расходы при частоте семплинга до 1 000 000 Гц, что делает его самым быстрым профилировщиком с семплингом для Python (на момент его создания) и идеальным для отладки проблем производительности в рабочих средах. Эта возможность особенно ценна для отладки проблем производительности в production-системах, где традиционные подходы к профилированию оказываются слишком навязчивыми.

Ключевые возможности:

• Профилирование с нулевыми накладными расходами: Подключение к любому запущенному процессу Python без влияния на его производительность. Идеально подходит для отладки в production, когда нельзя позволить себе перезапуск или замедление приложения.

• Не требует изменения кода: Профилирует существующие приложения без перезапуска. Для начала сбора данных достаточно указать профилировщику PID запущенного процесса.

• Гибкие режимы целевого профилирования:

  • Профилирование запущенных процессов по PID (attach) – подключение к уже запущенным приложениям

  • Запуск и профилирование скриптов напрямую (run) – профилирование с самого начала выполнения

  • Запуск и профилирование модулей (run -m) – профилирование пакетов, запускаемых как python -m module

  • Захват однократного снимка запущенного процесса (dump) – вывод стек-трейса в стиле traceback для каждого потока (или всех задач asyncio с --async-aware). Полезно для исследования зависших процессов.

• Несколько режимов профилирования: Выберите, что измерять, в зависимости от исследуемой проблемы производительности:

  • Стенное время (Wall clock time) (--mode wall, по умолчанию): Измеряет реальное прошедшее время, включая ввод-вывод, ожидание сети и блокирующие операции. Используйте этот режим, чтобы понять, где программа проводит календарное время, включая время ожидания внешних ресурсов.

  • Время CPU (--mode cpu): Измеряет только активное время выполнения на CPU, исключая ожидание ввода-вывода и блокировки. Используйте этот режим для выявления узких мест, связанных с загрузкой CPU, и оптимизации вычислительной работы.

  • Время удержания GIL (--mode gil): Измеряет время, проведённое с удержанием глобальной блокировки интерпретатора Python (GIL). Используйте этот режим, чтобы определить, какие потоки доминируют по использованию GIL в многопоточных приложениях.

  • Время обработки исключений (--mode exception): Собирает семплы только из потоков с активным исключением. Используйте этот режим для анализа накладных расходов на обработку исключений.

• Профилирование с учётом потоков: Возможность профилировать все потоки (-a) или только главный поток – необходимо для понимания поведения многопоточных приложений.

• Несколько форматов вывода: Выберите визуализацию, которая лучше всего подходит для вашего рабочего процесса:

  • --pstats: Подробная табличная статистика, совместимая с pstats. Показывает временные характеристики на уровне функций с прямыми и кумулятивными семплами. Лучше всего подходит для детального анализа и интеграции с существующими инструментами профилирования Python.

  • --collapsed: Создаёт свёрнутые стек-трейсы (одна строка на стек). Этот формат специально разработан для создания флейм-графиков с помощью внешних инструментов, таких как скрипты FlameGraph Брендана Грегга или speedscope.

  • --flamegraph: Создаёт автономный интерактивный HTML-флейм-график с использованием D3.js. Открывается прямо в браузере для немедленного визуального анализа. Флейм-графики показывают иерархию вызовов, где ширина представляет затраченное время, что позволяет легко заметить узкие места с первого взгляда.

  • --gecko: Генерирует формат Gecko Profiler, совместимый с Firefox Profiler. Загрузите результат в Firefox Profiler для расширенного анализа на основе временной шкалы с такими возможностями, как графики стеков, маркеры и сетевая активность.

  • --heatmap: Создаёт интерактивную HTML-визуализацию в виде тепловой карты с количеством семплов на уровне строк. Создаёт директорию с тепловыми картами для каждого файла, точно показывающую, где тратится время на уровне исходного кода.

• Интерактивный режим в реальном времени: TUI-профилировщик в реальном времени с интерфейсом наподобие top (--live). Отслеживайте производительность во время работы приложения с интерактивной сортировкой и фильтрацией.

• Профилирование с учётом асинхронности: Профилирование async/await кода с восстановлением стеков на основе задач (--async-aware). Позволяет увидеть, какие корутины потребляют время, с возможностью показывать только выполняющиеся задачи или все задачи, включая ожидающие.

• Профилирование на уровне опкодов: Сбор информации об опкодах байткода для профилирования на уровне инструкций (--opcodes). Показывает, какие инструкции байткода выполняются, включая специализации от адаптивного интерпретатора.

См. profiling.sampling для получения полной документации, включая все доступные форматы вывода, режимы профилирования и параметры конфигурации.

(Авторы: Pablo Galindo и László Kiss Kollár в gh-135953 и gh-138122.)

PEP 831: Указатели фреймов включены по умолчанию¶PEP 831: Frame pointers enabled by default

CPython теперь собирается с указателями фреймов по умолчанию на платформах, которые их поддерживают. Для этого используются флаги компилятора -fno-omit-frame-pointer и -mno-omit-leaf-frame-pointer, что ускоряет и повышает надёжность размотки нативного стека для системных профилировщиков, отладчиков, инструментов анализа сбоев и средств наблюдения на основе eBPF.

Флаги доступны через sysconfig, поэтому модули расширения, собранные инструментами, которые используют конфигурацию сборки Python, наследуют указатели фреймов по умолчанию. Это распространение сделано намеренно: для смешанного профилирования Python/нативного кода требуется непрерывная цепочка указателей фреймов через интерпретатор, модули расширения, встраиваемые приложения и нативные библиотеки.

(Авторы: Pablo Galindo Salgado и Savannah Ostrowski в gh-149201; PEP 831 написан Pablo Galindo Salgado, Ken Jin, Savannah Ostrowski и Diego Russo.)

PEP 798: Распаковка в генераторах списков¶PEP 798: Unpacking in comprehensions

Генераторы списков, множеств и словарей, а также выражения-генераторы теперь поддерживают распаковку с * и **. Это расширяет синтаксис распаковки из PEP 448 на генераторы, предоставляя новый синтаксис для объединения произвольного количества итерируемых объектов или словарей в единую плоскую структуру. Этот новый синтаксис является прямой альтернативой вложенным генераторам, itertools.chain() и itertools.chain.from_iterable(). Например:

>>> lists = [[1, 2], [3, 4], [5]]
>>> [*L for L in lists]  # эквивалентно [x for L in lists for x in L]
[1, 2, 3, 4, 5]

>>> sets = [{1, 2}, {2, 3}, {3, 4}]
>>> {*s for s in sets}  # эквивалентно {x for s in sets for x in s}
{1, 2, 3, 4}

>>> dicts = [{'a': 1}, {'b': 2}, {'a': 3}]
>>> {**d for d in dicts}  # эквивалентно {k: v for d in dicts for k,v in d.items()}
{'a': 3, 'b': 2}

Выражения-генераторы также могут использовать распаковку для получения значений из нескольких итерируемых объектов:

>>> gen = (*L for L in lists)  # эквивалентно (x for L in lists for x in L)
>>> list(gen)
[1, 2, 3, 4, 5]

Это изменение также распространяется на асинхронные выражения-генераторы, так что, например, (*a async for a in agen()) эквивалентно (x async for a in agen() for x in a).

(Автор: Adam Hartz в gh-143055.)

PEP 829: Файлы конфигурации запуска пакетов¶PEP 829: Package startup configuration files

Загружаемые модулем site, когда -S не указан, файлы .pth могут содержать строки, которые как расширяют sys.path, так и выполняют произвольный код, если строка начинается с import (с последующим пробелом или табуляцией). Последняя функциональность может быть проблематичной, поскольку сложно точно знать, что именно выполняется при запуске Python.

В качестве шага по улучшению возможности аудита исполняемого кода до запуска, Python 3.15 вводит файлы .start, которые содержат спецификации точек входа в виде pkg.mod:callable, где pkg.mod – это путь импорта к указанной вызываемой сущности. При запуске Python вызываемая сущность находится и вызывается без аргументов.

Строки import в файлах .pth объявлены устаревшими без предупреждения. Если найден соответствующий файл .start, строки import в файлах .pth игнорируются. Для строк расширения sys.path в файлах .pth изменений нет.

Модуль site также предоставляет site.StartupState для пакетной обработки запуска для нескольких каталогов сайтов, гарантируя, что все статические расширения путей применяются до выполнения любого кода запуска. site.main() неявно использует экземпляр этого класса для пакетной обработки всех файлов конфигурации запуска при обычном запуске интерпретатора. Вызывающим сторонам, которым нужно такое же пакетное поведение, можно напрямую создать StartupState и управлять им с помощью addsitedir(), addusersitepackages() и addsitepackages(), а затем вызвать process() один раз в конце пакетной обработки.

(Автор: Barry Warsaw в gh-148641 и gh-150228.)

PEP 803 – Стабильный ABI для сборок со свободными потоками¶PEP 803 – Stable ABI for free-threaded builds

Расширения C, предназначенные для Стабильного ABI, теперь могут быть скомпилированы для нового Стабильного ABI для сборок со свободными потоками (также известного как abi3t), что делает их совместимыми с сборками со свободными потоками CPython. Обычно это требует нетривиальных изменений в исходном коде; в частности:

• Переход на API, введённый в PEP 697 (Python 3.12), такой как отрицательные basicsize и PyObject_GetTypeData(), вместо того чтобы делать PyObject частью структуры экземпляра; и

• Переход от функции PyInit_ к новому хуку экспорта PyModExport_*, введённому для этой цели в PEP 793, с новой структурой PySlot, введённой в PEP 820.

Обратите внимание, что Стабильный ABI не предоставляет всей функциональности CPython. Расширения, которые не могут переключиться на abi3t, должны продолжать собираться для существующего Стабильного ABI (abi3) и версионно-специфичного ABI для свободных потоков (cp315t) по отдельности.

Стабильный ABI для сборок со свободными потоками обычно следует выбирать в инструменте сборки (например, Setuptools, meson-python, scikit-build-core или Maturin). На момент написания эти инструменты не поддерживали abi3t. Если это относится к вашему инструменту, компилируйте для cp315t отдельно. Если вы не используете инструмент сборки – или пишете такой инструмент – вы можете выбрать abi3t, установив макрос Py_TARGET_ABI3T, как описано в Компиляция для Стабильного ABI.

Доступно практическое руководство по миграции для перехода на abi3t.

PEP 788: Защита C API от завершения работы интерпретатора¶PEP 788: Protecting the C API from interpreter finalization

В C API завершение работы интерпретатора может быть проблематичным для многих расширений, потому что присоединение состояния потока навсегда зависает поток, что приводит к взаимоблокировкам и другим ложным проблемам. Кроме того, исторически было невозможно безопасно проверить, жив ли интерпретатор, прежде чем использовать его, что приводило к сбоям, когда один поток одновременно удаляет интерпретатор, а другой пытается к нему присоединиться.

Теперь есть несколько новых наборов API для обхода этих проблем:

• Охранники интерпретатора, которые предотвращают завершение работы интерпретатора.

• Представления интерпретатора, которые обеспечивают потокобезопасный доступ к интерпретатору, который может одновременно завершать работу или быть удалён.

• Новые API для автоматического присоединения и отсоединения состояний потоков со встроенной защитой от финализации.

Кроме того, API из семейства PyGILState (в первую очередь PyGILState_Ensure() и PyGILState_Release()) стали мягко устаревшими. Не планируется удалять их, существующий код продолжит работать, но в будущих версиях Python не будет новых API PyGILState.

(Автор: Peter Bierma, gh-149101.)

Улучшенные сообщения об ошибках¶Improved error messages

• Интерпретатор теперь даёт более полезные подсказки в исключениях AttributeError при обращении к несуществующему атрибуту объекта, если похожий атрибут доступен через один из его членов.

  Например, если у объекта есть атрибут, который сам предоставляет запрошенное имя, сообщение об ошибке предложит обратиться к нему через этот внутренний атрибут:

  @dataclass
  class Circle:
     radius: float
  
     @property
     def area(self) -> float:
        return pi * self.radius**2
  
  class Container:
     def __init__(self, inner: Circle) -> None:
        self.inner = inner
  
  circle = Circle(radius=4.0)
  container = Container(circle)
  print(container.area)
  

  Теперь выполнение этого кода выдаёт более понятную подсказку:

  Traceback (most recent call last):
    File "/home/pablogsal/github/python/main/lel.py", line 42, in <module>
      print(container.area)
            ^^^^^^^^^^^^^^
  AttributeError: 'Container' object has no attribute 'area'. Did you mean '.inner.area' instead of '.area'?
  

• Когда AttributeError встроенного типа не находит близкого совпадения по расстоянию Левенштейна, сообщение об ошибке теперь проверяет статическую таблицу распространённых имён методов из других языков (JavaScript, Java, Ruby, C#) и предлагает эквивалент на Python:

  >>> [1, 2, 3].push(4)
  Traceback (most recent call last):
  ...
  AttributeError: 'list' object has no attribute 'push'. Did you mean '.append'?
  
  >>> 'hello'.toUpperCase()
  Traceback (most recent call last):
  ...
  AttributeError: 'str' object has no attribute 'toUpperCase'. Did you mean '.upper'?
  

  Если эквивалент на Python – языковая конструкция, а не метод, подсказка описывает её напрямую:

  >>> {}.put("a", 1)
  Traceback (most recent call last):
  ...
  AttributeError: 'dict' object has no attribute 'put'. Use d[k] = v.
  

  Когда изменяемый метод вызывается для неизменяемого типа, подсказка предлагает соответствующий изменяемый вариант:

  >>> (1, 2, 3).append(4)
  Traceback (most recent call last):
  ...
  AttributeError: 'tuple' object has no attribute 'append'. Did you mean to use a 'list' object?
  

  Эти подсказки также работают для подклассов встроенных типов.

  (Автор: Matt Van Horn, gh-146406.)

• Теперь интерпретатор пытается дать подсказку, когда delattr() завершается ошибкой из-за отсутствующего атрибута. Если используется имя атрибута, очень похожее на существующий атрибут, интерпретатор предложит правильное имя атрибута в сообщении об ошибке. Например:

  >>> class A:
  ...     pass
  >>> a = A()
  >>> a.abcde = 1
  >>> del a.abcdf
  Traceback (most recent call last):
  ...
  AttributeError: 'A' object has no attribute 'abcdf'. Did you mean: 'abcde'?
  

  (Авторы: Nikita Sobolev и Pranjal Prajapati, gh-136588.)

• Несколько сообщений об ошибках, некорректно использовавших термин «argument», исправлены. (Автор: Stan Ulbrych, gh-133382.)

math.integer¶

Этот модуль предоставляет доступ к математическим функциям для целочисленных аргументов (PEP 791). (Разработано Serhiy Storchaka в gh-81313.)

argparse¶

• Действие BooleanOptionalAction теперь поддерживает длинные опции с одним дефисом и альтернативные символы префикса. (Разработано Serhiy Storchaka в gh-138525.)

• Изменено значение по умолчанию параметра suggest_on_error функции argparse.ArgumentParser на True. Это включает предложения для неправильно набранных аргументов по умолчанию. (Разработано Jakob Schluse в gh-140450.)

• Добавлена поддержка разметки обратными кавычками в тексте описания ArgumentParser и эпилога для выделения встроенного кода при включённом цветном выводе. (Разработано Savannah Ostrowski в gh-142390.)

• Расширена разметка обратными кавычками на текст аргумента help и добавлена поддержка двойных обратных кавычек (стиль RST inline-literal). (Разработано Hugo van Kemenade в gh-149375.)

array¶

• Поддержка типов C float complex и double complex: символы форматирования 'Zf' и 'Zd' соответственно. (Разработано Victor Stinner в gh-146151 и gh-148675.)

• Поддержка полуточных чисел (16-битный формат двоичного обмена IEEE 754): символ форматирования 'e'. (Разработано Sergey B Kirpichev в gh-146238.)

• Тип array.typecodes изменён с str на tuple для поддержки кодов типов длиннее 1 символа (Zf и Zd). (Разработано Victor Stinner в gh-148675.)

ast¶

• Добавлен параметр color в dump(). Если True, возвращаемая строка подсвечивается синтаксически с помощью ANSI-escape последовательностей. Если False (по умолчанию), цветной вывод всегда отключён. (Разработано Stan Ulbrych в gh-148981.)

• Вывод командной строки теперь по умолчанию подсвечивается синтаксически. Это можно контролировать с помощью переменных окружения. (Разработано Stan Ulbrych в gh-148981.)

asyncio¶

• Добавлен TaskGroup.cancel для возможности досрочного завершения группы задач, например, когда цель задач достигнута или их услуги больше не нужны. Ранее для этого требовался неинтуитивный шаблонный код, например, дополнительная задача, вызывающая пользовательское исключение, которое затем подавлялось при выходе из группы задач. (Разработано John Belmonte в gh-127214.)

base64¶

• Добавлен параметр pad в z85encode(). (Разработано Hauke Dämpfling в gh-143103.)

• Добавлен параметр padded в b32encode(), b32decode(), b32hexencode(), b32hexdecode(), b64encode(), b64decode(), urlsafe_b64encode() и urlsafe_b64decode(). (Разработано Serhiy Storchaka в gh-73613.)

• Добавлен параметр wrapcol в b16encode(), b32encode(), b32hexencode(), b64encode(), b85encode() и z85encode(). (Разработано Serhiy Storchaka в gh-143214 и gh-146431.)

• Добавлен параметр ignorechars в b16decode(), b32decode(), b32hexdecode(), b64decode(), b85decode() и z85decode(). (Вклад Serhiy Storchaka в gh-144001 и gh-146431.)

• Добавлен параметр canonical в b32decode(), b32hexdecode(), b64decode(), urlsafe_b64decode(), a85decode(), b85decode() и z85decode(), для отклонения кодировок с ненулевыми битами заполнения или другими неканоническими формами. (Вклад Gregory P. Smith в gh-146311.)

binascii¶

• Добавлены функции для кодирования Base32:

  • b2a_base32() и a2b_base32()

  (Вклад James Seo в gh-146192.)

• Добавлены функции для кодирования Ascii85, Base85 и Z85:

  • b2a_ascii85() и a2b_ascii85()

  • b2a_base85() и a2b_base85()

  (Вклад James Seo и Serhiy Storchaka в gh-101178.)

• Добавлен параметр padded в b2a_base32(), a2b_base32(), b2a_base64() и a2b_base64(). (Вклад Serhiy Storchaka в gh-73613.)

• Добавлен параметр wrapcol в b2a_base64(). (Вклад Serhiy Storchaka в gh-143214.)

• Добавлен параметр alphabet в b2a_base64() и a2b_base64(). (Вклад Serhiy Storchaka в gh-145980.)

• Добавлен параметр ignorechars в a2b_hex(), unhexlify() и a2b_base64(). (Вклад Serhiy Storchaka в gh-144001 и gh-146431.)

• Добавлен параметр canonical в a2b_base64(), для отклонения кодировок с ненулевыми битами заполнения. (Вклад Gregory P. Smith в gh-146311.)

calendar¶

• Командной строки calendar текстовый вывод стал более цветным. Это можно настроить с помощью переменных окружения. (Вклад Hugo van Kemenade в gh-148352.)

• Командной строки calendar HTML-вывод теперь принимает опцию «год-месяц»: python -m calendar -t html 2009 06. (Вклад Pål Grønås Drange в gh-140212.)

• Страницы календаря, создаваемые классом calendar.HTMLCalendar, теперь поддерживают тёмный режим и были перенесены на стандарт HTML5 для улучшения доступности. (Вклад Jiahao Li и Hugo van Kemenade в gh-137634.)

collections¶

• Добавлены collections.Counter.__xor__() и collections.Counter.__ixor__() для вычисления симметрической разности между объектами Counter. (Вклад Raymond Hettinger в gh-138682.)

concurrent.futures¶

• Улучшено сообщение об ошибке при внезапном завершении дочернего процесса в concurrent.futures.ProcessPoolExecutor. Теперь результирующий traceback будет показывать PID и код выхода завершившегося процесса. (Вклад Jonathan Berg в gh-139486.)

contextlib¶

• Добавлена поддержка произвольных дескрипторов __enter__(), __exit__(), __aenter__() и __aexit__() в ExitStack и contextlib.AsyncExitStack, для согласованности с операторами with и async with. (Вклад Serhiy Storchaka в gh-144386.)

• ContextDecorator и AsyncContextDecorator (а следовательно contextmanager() и asynccontextmanager(), используемые как декораторы) теперь распознают функции-генераторы, корутинные функции и асинхронные функции-генераторы и держат контекстный менеджер открытым на протяжении итерации или ожидания. Ранее контекстный менеджер закрывался сразу после создания объекта генератора или корутины. (Вклад Alex Grönholm & Gregory P. Smith в gh-125862.)

dataclasses¶

• Аннотации для сгенерированных методов __init__ больше не включают внутренние имена типов.

dbm¶

• Добавлены новые методы reorganize() в dbm.dumb и dbm.sqlite3 для восстановления неиспользуемого свободного пространства, ранее занятого удалёнными записями. (Вклад Andrea Oliveri в gh-134004.)

difflib¶

• Введён необязательный параметр color в difflib.unified_diff(), позволяющий цветной вывод, аналогичный git diff. Это можно настроить с помощью переменных окружения. (Вклад Douglas Thor в gh-133725.)

• Улучшен стиль HTML-страниц diff, создаваемых классом difflib.HtmlDiff, и вывод перенесён на стандарт HTML5. (Вклад Jiahao Li в gh-134580.)

email¶

• Генераторы электронной почты теперь вызывают ошибку, когда EmailMessage не может быть точно свёрнут из-за не-ASCII адреса электронной почты (почтового ящика) в заголовке адреса. Варианты поддержки интернационализации адресов электронной почты (EAI) обсуждаются в EmailPolicy.utf8. (Вклад R David Murray и Mike Edmunds в gh-122540.)

faulthandler ¶

• Добавлен параметр max_threads в faulthandler.enable(), faulthandler.dump_traceback(), faulthandler.dump_traceback_later(), и faulthandler.register(). (Автор: Eric Froemling в gh-149085.)

functools¶

• singledispatchmethod() теперь поддерживает не-дескрипторные вызываемые объекты. (Автор: Serhiy Storchaka в gh-140873.)

• singledispatchmethod() теперь выполняет диспетчеризацию по второму аргументу, если он оборачивает обычный метод и вызывается как атрибут класса. (Автор: Bartosz Sławecki в gh-143535.)

gc¶

• Python 3.14.0–3.14.4 поставлялся с новым инкрементальным сборщиком мусора. Однако из-за ряда сообщений о значительном потреблении памяти в производственных средах было решено вернуться к поколенческому GC из версии 3.13. Этот GC используется в Python 3.14.5 и новее, а также в Python 3.15.

hashlib¶

• Гарантирует, что хэш-функции, которые должны быть всегда доступны, существуют как атрибуты hashlib, даже если они не будут работать во время выполнения из-за отсутствия реализаций бэкенда. Например, hashlib.md5 больше не будет вызывать AttributeError, если OpenSSL недоступен, а Python был собран без поддержки MD5. (Автор: Bénédikt Tran в gh-136929.)

http.client¶

• Новый параметр max_response_headers, передаваемый только по ключевому слову, добавлен в конструкторы HTTPConnection и HTTPSConnection. Этот параметр переопределяет максимальное количество разрешённых заголовков ответа по умолчанию. (Автор: Alexander Enrique Urieles Nieto в gh-131724.)

http.server¶

• Логирование BaseHTTPRequestHandler, используемое интерфейсом командной строки, по умолчанию выполняется с цветами. Это можно настраивать с помощью переменных среды. (Автор: Hugo van Kemenade в gh-146292.)

• Добавлены default_content_type и опция командной строки --content-type, позволяющие настраивать заголовок Content-Type по умолчанию для файлов с неизвестными расширениями. (Авторы: John Comeau и Hugo van Kemenade в gh-113471.)

• Добавлен новый именованный аргумент extra_response_headers в SimpleHTTPRequestHandler для поддержки пользовательских заголовков в HTTP-ответах. (Автор: Anton I. Sipos в gh-135057.)

• Добавлена опция -H/--header в python -m http.server интерфейс командной строки для поддержки пользовательских заголовков в HTTP-ответах. (Автор: Anton I. Sipos в gh-135057.)

importlib.metadata¶

• Ранее при обращении к каталогу метаданных дистрибутива, не содержащему файла метаданных, metadata() и Distribution.metadata() возвращали пустой объект PackageMetadata, как если бы файл был, но пуст. Теперь выбрасывается исключение MetadataNotFound. См. importlib_metadata#493 для контекста и обоснования, а также gh-143387 для обоснования вопросов совместимости. (Автор: Jason R. Coombs.)

inspect¶

• Добавлены параметры inherit_class_doc и fallback_to_class_doc для getdoc(). (Автор: Serhiy Storchaka в gh-132686.)

json¶

• Добавлен параметр array_hook в функции load() и loads(): он позволяет задать колбэк для типов литералов массивов JSON, чтобы настраивать списки Python в результирующем декодированном объекте. Передача комбинированного frozendict в параметр object_pairs_hook и tuple в array_hook даст глубоко вложенную неизменяемую структуру Python, представляющую данные JSON. (Автор: Joao S. O. Bueno в gh-146440.)

locale¶

• setlocale() теперь поддерживает языковые коды с модификаторами @. Модификаторы @ больше не отбрасываются молча в getlocale(), а включаются в языковой код. (Автор: Serhiy Storchaka в gh-137729.)

• Отмена устаревания функции locale.getdefaultlocale(). (Автор: Victor Stinner в gh-130796.)

math¶

• Добавлены функции math.isnormal() и math.issubnormal(). (Автор: Sergey B Kirpichev в gh-132908.)

• Добавлены функции math.fmax(), math.fmin() и math.signbit(). (Автор: Bénédikt Tran в gh-135853.)

mimetypes¶

• Добавлено больше MIME-типов. (Авторы: Benedikt Johannes, Charlie Lin, Foolbar, Gil Forcada и John Franey в gh-144217, gh-145720, gh-140937, gh-139959, gh-145698, gh-145718, gh-145918 и gh-144213.)

• Переименован application/x-texinfo в application/texinfo. (Автор: Charlie Lin в gh-140165.)

• Изменён MIME-тип для файлов .ai на application/pdf. (Автор: Stan Ulbrych в gh-141239.)

mmap¶

• mmap.mmap теперь имеет параметр trackfd в Windows; если он равен False, дескриптор файла, соответствующий fileno, не будет дублироваться. (Предложено Serhiy Storchaka в gh-78502.)

• Добавлен метод mmap.mmap.set_name() для аннотирования анонимного отображения памяти, если ядро Linux поддерживает PR_SET_VMA_ANON_NAME (Linux 5.17 или новее). (Предложено Donghee Na в gh-142419.)

os¶

• Добавлена os.statx() в ядре Linux версий 4.11 и новее с glibc версий 2.28 и новее. (Предложено Jeffrey Bosboom и Victor Stinner в gh-83714.)

• Функция os.makedirs() теперь имеет параметр parent_mode, который позволяет задавать режим для промежуточных каталогов. Это можно использовать для воспроизведения поведения Python 3.6 и более ранних версий, передав parent_mode=mode. (Предложено Zackery Spytz и Gregory P. Smith в gh-86533.)

os.path¶

• Добавлена поддержка режима «все, кроме последнего» в realpath(). (Предложено Serhiy Storchaka в gh-71189.)

• Параметр strict в os.path.realpath() принимает новое значение, os.path.ALLOW_MISSING. При его использовании ошибки, отличные от FileNotFoundError, будут возбуждаться повторно; результирующий путь может отсутствовать, но будет свободен от символических ссылок. (Предложено Petr Viktorin для CVE 2025-4517.)

pdb¶

• Использовать новую интерактивную оболочку в качестве оболочки ввода по умолчанию для pdb. (Предложено Tian Gao в gh-145379.)

pickle¶

• Добавлена поддержка сериализации закрытых методов и вложенных классов. (Предложено Zackery Spytz и Serhiy Storchaka в gh-77188.)

pickletools¶

• Вывод интерфейса командной строки pickletools по умолчанию раскрашен. Это можно настроить с помощью переменных окружения. (Предложено Hugo van Kemenade в gh-149026.)

pprint¶

• Добавлен именованный аргумент expand для pprint.pprint(), pprint.pformat(), pprint.pp(). Если он истинен, вывод будет форматироваться аналогично pretty-printed json.dumps(), когда указан indent. (Предложено Stefan Todoran, Semyon Moroz и Hugo van Kemenade в gh-112632.)

• Добавлена поддержка t-строк в pprint. (Предложено Loïc Simon и Hugo van Kemenade в gh-134551.)

re¶

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

resource¶

• Добавлены новые константы: RLIMIT_NTHR, RLIMIT_UMTXP, RLIMIT_THREADS, RLIM_SAVED_CUR и RLIM_SAVED_MAX. (Предложено Serhiy Storchaka в gh-137512.)

shelve¶

• Добавлен новый метод reorganize() к shelve, используемый для восстановления неиспользуемого свободного пространства, ранее занятого удалёнными записями. (Предложено Andrea Oliveri в gh-134004.)

• Добавлена поддержка пользовательских функций сериализации и десериализации в модуле shelve. (Предложено Furkan Onder в gh-99631.)

shutil¶

• shutil.copyfile() теперь также вызывает SpecialFileError для сокетов и файлов устройств. (Предложено Savannah Ostrowski в gh-142693.)

socket¶

• Добавлены константы для протокола ISO-TP CAN. (Предложено Patrick Menschel и Stefan Tatschner в gh-86819.)

sqlite3¶

• У интерфейса командной строки есть несколько новых возможностей:

  • Автодополнение ключевых слов SQL по <tab>. (Предложено Long Tan в gh-133393.)

  • Приглашения, сообщения об ошибках и справочный текст теперь раскрашены. Эта функция включена по умолчанию; подробнее см. Управление цветом. (Предложено Stan Ulbrych и Łukasz Langa в gh-133461.)

  • Автодополнение таблиц, индексов, триггеров, представлений, столбцов, функций и схем по <tab>. (Предложено Long Tan в gh-136101.)

ssl¶

• Указывает через ssl.HAS_PSK_TLS13, поддерживает ли модуль ssl «внешние PSK» в TLSv1.3, как описано в RFC 9258. (Автор: Will Childs-Klein в gh-133624.)

• Добавлены новые методы для управления группами, используемыми для согласования ключей SSL

  • ssl.SSLContext.set_groups() задаёт группы, разрешённые для согласования ключей, расширяя предыдущий метод ssl.SSLContext.set_ecdh_curve(). Этот новый API позволяет перечислять несколько групп и поддерживает группы с фиксированным полем и постквантовые группы в дополнение к кривым ECDH. Этот метод также можно использовать для управления тем, какие доли ключа отправляются при рукопожатии TLS.

  • ssl.SSLSocket.group() возвращает группу, выбранную для согласования ключей на текущем соединении после завершения рукопожатия TLS. Этот вызов требует OpenSSL 3.2 или новее.

  • ssl.SSLContext.get_groups() возвращает список всех доступных групп согласования ключей, совместимых с минимальной и максимальной версиями TLS, установленными в контексте. Этот вызов требует OpenSSL 3.5 или новее.

  (Автор: Ron Frederick в gh-136306.)

• Добавлен новый метод ssl.SSLContext.set_ciphersuites() для установки шифров TLS 1.3. Для TLS 1.2 и старше следует продолжать использовать ssl.SSLContext.set_ciphers(). Оба вызова можно выполнять в одном контексте, и выбранный набор шифров будет зависеть от версии TLS, согласованной при установке соединения. (Автор: Ron Frederick в gh-137197.)

• Добавлены новые методы для управления алгоритмами подписи:

  • ssl.get_sigalgs() возвращает список всех доступных алгоритмов подписи TLS. Этот вызов требует OpenSSL 3.4 или новее.

  • ssl.SSLContext.set_client_sigalgs() задаёт алгоритмы подписи, разрешённые для аутентификации клиента на основе сертификата.

  • ssl.SSLContext.set_server_sigalgs() задаёт алгоритмы подписи, разрешённые для завершения рукопожатия TLS сервером.

  • ssl.SSLSocket.client_sigalg() возвращает алгоритм подписи, выбранный для аутентификации клиента на текущем соединении. Этот вызов требует OpenSSL 3.5 или новее.

  • ssl.SSLSocket.server_sigalg() возвращает алгоритм подписи, выбранный для завершения сервером рукопожатия TLS на текущем соединении. Этот вызов требует OpenSSL 3.5 или новее.

  (Автор: Ron Frederick в gh-138252.)

подпроцесс¶subprocess

• subprocess.Popen.wait(): если timeout не равно None и платформа поддерживает это, используется эффективный механизм, управляемый событиями, для ожидания завершения процесса:

  • Linux >= 5.3 использует os.pidfd_open() + select.poll().

  • macOS и другие варианты BSD используют select.kqueue() + KQ_FILTER_PROC + KQ_NOTE_EXIT.

  • Windows продолжает использовать WaitForSingleObject (без изменений).

  Если ни один из этих механизмов недоступен, функция возвращается к tрадиционному циклу ожидания (неблокирующий вызов и короткие паузы). (Автор: Giampaolo Rodola в gh-83069.)

symtable¶

• Добавлены методы symtable.Function.get_cells() и symtable.Symbol.is_cell(). (Автор: Yashp002 в gh-143504.)

sys¶

• Добавлено пространство имён sys.abi_info для улучшения доступа к информации об ABI. (Автор: Klaus Zimmermann в gh-137476.)

sys.monitoring¶

• События другие (PY_THROW, PY_UNWIND, RAISE, EXCEPTION_HANDLED и RERAISE) теперь можно включать и отключать для каждого объекта кода. Возврат DISABLE из колбэка для одного из этих событий отключает событие для всего объекта кода (для текущего инструмента), а не вызывает исключение ValueError, как в предыдущих версиях. (Автор: Gabriele N. Tornetta в gh-146182.)

tarfile¶

• data_filter() теперь нормализует цели символических ссылок для предотвращения атак с обходом пути. (Вклад Petr Viktorin в gh-127987 и CVE 2025-4138.)

• extractall() теперь пропускает исправление атрибутов каталога, если каталог был удалён или заменён файлом другого типа. (Вклад Petr Viktorin в gh-127987 и CVE 2024-12718.)

• extract() и extractall() теперь (повторно) применяют фильтр извлечения при замене ссылки (жёсткой или символической) копией другого члена архива, а также при исправлении атрибутов каталога. Первое вызывает новое исключение LinkFallbackError. (Вклад Petr Viktorin для CVE 2025-4330 и CVE 2024-12718.)

• extract() и extractall() больше не извлекают отклонённые элементы, когда errorlevel() равно нулю. (Вклад Matt Prodani и Petr Viktorin в gh-112887 и CVE 2025-4435.)

• extract() и extractall() теперь заменяют косые черты на обратные косые черты в целях символических ссылок в Windows, чтобы предотвратить создание повреждённых ссылок. (Автор: Christoph Walcher в gh-57911.)

threading¶

• Добавлены serialize_iterator, synchronized_iterator() и concurrent_tee() для поддержки конкурентного доступа к генераторам и итераторам. (Автор: Raymond Hettinger в gh-124397.)

timeit¶

• Вывод интерфейса командной строки timeit по умолчанию цветной. Это можно контролировать с помощью переменных окружения. (Автор: Hugo van Kemenade в gh-146609.)

• Интерфейс командной строки теперь по умолчанию раскрашивает трассировки ошибок. Это можно настроить с помощью переменных окружения. (Автор: Yi Hong в gh-139374.)

• Сделать целевое время timeit.Timer.autorange() настраиваемым и добавить опцию --target-time в интерфейс командной строки. (Автор: Alessandro Cucci и Miikka Koskinen в gh-80642.)

tkinter¶

• Метод tkinter.Text.search() теперь поддерживает два дополнительных аргумента: nolinestop, позволяющий продолжать поиск через границы строк; и strictlimits, ограничивающий поиск заданным диапазоном. (Автор: Rihaan Meher в gh-130848.)

• Был добавлен новый метод tkinter.Text.search_all(). Этот метод позволяет искать все совпадения с шаблоном с использованием опций -all и -overlap Tcl. (Автор: Rihaan Meher в gh-130848.)

• Добавлены новые методы pack_content(), place_content() и grid_content(), которые используют новые имена команд Tk (представленные в Tk 8.6) вместо методов *_slaves(), использующих устаревшие имена. (Автор: Serhiy Storchaka в gh-143754.)

• Добавлены атрибуты Event: user_data для виртуальных событий Tk и detail для событий Enter, Leave, FocusIn, FocusOut и ConfigureRequest. (Автор: Matthias Kievernagel и Serhiy Storchaka в gh-47655.)

tokenize¶

• Вывод tokenize интерфейса командной строки по умолчанию раскрашивается. Это можно настроить с помощью переменных окружения. (Автор: Hugo van Kemenade в gh-148991.)

tomllib¶

• Модуль tomllib теперь поддерживает TOML 1.1.0. Это обновление обратно совместимо, то есть все корректные документы TOML 1.0.0 разбираются так же, как и раньше.

  Изменения, согласно официальному журналу изменений TOML:

  • Разрешены переводы строк и конечные запятые во встроенных таблицах.

    Раньше встроенная таблица должна была быть в одной строке и не могла заканчиваться конечной запятой. Теперь это ограничение снято, так что следующее допустимо:

    tbl = {
       key      = "a string",
       moar-tbl =  {
          key = 1,
       },
    }
    

  • Добавлена нотация \xHH для базовых строк для кодовых точек ниже 255, и управляющая последовательность \e для символа экранирования:

    null = "null byte: \x00; letter a: \x61"
    csi = "\e["
    

  • Секунды в значениях даты-времени и времени теперь необязательны. Следующие теперь допустимы:

    dt = 2010-02-03 14:15
    t  = 14:15
    

  (Автор: Taneli Hukkinen в gh-142956.)

types¶

• Предоставлен прокси-тип с сквозной записью locals() как types.FrameLocalsProxyType. Он представляет тип атрибута frame.f_locals, как описано в PEP 667.

typing¶

• PEP 747: Добавлено TypeForm, новая специальная форма для аннотирования значений, которые сами являются выражениями типов. TypeForm[T] означает «объект формы типа, описывающий T (или тип, присваиваемый T)». Во время выполнения TypeForm(x) просто возвращает x, что позволяет явно аннотировать значения формы типа без изменения поведения.

  Это помогает библиотекам, которые принимают предоставленные пользователем выражения типов (например, классы int, str | None, TypedDict или list[int]), предоставлять точные сигнатуры:

  from typing import Any, TypeForm
  
  def cast[T](typ: TypeForm[T], value: Any) -> T: ...
  

  (Автор: Jelle Zijlstra в gh-145033.)

• PEP 728: Добавлена поддержка в TypedDict для аргументов класса closed и extra_items. Закрытый TypedDict не допускает дополнительных ключей, кроме указанных в теле класса, в то время как TypedDict с extra_items допускает произвольные дополнительные элементы, значения которых относятся к указанному типу. (Автор: Angela Liss в gh-137840.)

• Код вида class ExtraTypeVars(P1[S], Protocol[T, T2]): ... теперь вызывает TypeError, потому что S не указан в параметрах Protocol. (Автор: Nikita Sobolev в gh-137191.)

• Код вида class B2(A[T2], Protocol[T1, T2]): ... теперь корректно обрабатывает порядок параметров типа: это (T1, T2), а не (T2, T1), как ранее ошибочно определялось во время выполнения. (Автор: Nikita Sobolev в gh-137191.)

• PEP 800: Добавлен @typing.disjoint_base, новый декоратор, помечающий класс как непересекающуюся базу. Это расширенная возможность, предназначенная в первую очередь для того, чтобы проверяющие типы могли точно отражать семантику времени выполнения типов, определённых как встроенные или в скомпилированных расширениях. Если класс C является непересекающейся базой, то дочерние классы этого класса не могут наследовать от других непересекающихся баз, которые не являются родительскими или дочерними классами C. (Автор: Jelle Zijlstra в gh-148639.)

• TypeVarTuple теперь принимает именованные аргументы bound, covariant, contravariant и infer_variance, соответствующие интерфейсу TypeVar и ParamSpec. Семантика bound остаётся неопределённой в спецификации.

unicodedata¶

• База данных Unicode обновлена до версии 17.0.0.

• Добавлены функции unicodedata.isxidstart() и unicodedata.isxidcontinue() для проверки, может ли символ начинать или продолжать идентификатор в соответствии с Приложением №31 к Стандарту Unicode. (Автор: Stan Ulbrych в gh-129117.)

• Добавлена функция iter_graphemes() для перебора графемных кластеров в соответствии с правилами, определёнными в Приложении №29 к Стандарту Unicode, «Сегментация текста Unicode». Добавлены функции grapheme_cluster_break(), indic_conjunct_break() и extended_pictographic() для получения свойств символа, связанных с указанным алгоритмом. (Автор: Serhiy Storchaka и Guillaume Sanchez в gh-74902.)

• Добавлена функция block(), возвращающая блок Юникода для заданного символа. (Автор: Stan Ulbrych в gh-66802.)

unittest¶

• unittest.TestCase.assertLogs() теперь принимает форматтер для управления форматированием сообщений. (Автор: Garry Cairns в gh-134567.)

• unittest.TestCase.assertWarns() и unittest.TestCase.assertWarnsRegex() больше не подавляют предупреждения, не соответствующие указанной категории или регулярному выражению. Теперь поддерживаются вложенные менеджеры контекста. (Автор: Serhiy Storchaka в gh-143231.)

urllib.parse¶

• Добавлен параметр missing_as_none в функции urlsplit(), urlparse() и urldefrag(). Добавлен параметр keep_empty в функции urlunsplit() и urlunparse(). Это позволяет различать пустые и неопределённые компоненты URI, а также сохранять пустые компоненты. (Автор: Serhiy Storchaka в gh-67041.)

venv¶

• На платформах POSIX каталоги platlib будут создаваться при необходимости во время создания виртуальных окружений, вместо использования символической ссылки lib64 -> lib. Это означает, что purelib и platlib виртуальных окружений больше не используют общий каталог lib на платформах, где sys.platlibdir не равно lib. (Автор: Rui Xi в gh-133951.)

warnings¶

• Улучшена фильтрация по модулю в warnings.warn_explicit(), если не передан аргумент module. Теперь регулярное выражение модуля в фильтре предупреждений проверяется не только на соответствие имени файла с удалённым .py, но и на соответствие именам модулей, построенным начиная с разных родительских каталогов файла (с удалёнными /__init__.py, .py и, в Windows, .pyw). (Автор: Serhiy Storchaka в gh-135801.)

wave¶

• Добавлена поддержка WAVE-аудио в формате IEEE с плавающей точкой (WAVE_FORMAT_IEEE_FLOAT) в wave.

• Добавлены wave.Wave_read.getformat(), wave.Wave_write.getformat(), и wave.Wave_write.setformat() для явной обработки формата кадров.

• wave.Wave_write.setparams() принимает как кортежи из 7 элементов, включающие format, так и кортежи из 6 элементов для обратной совместимости (по умолчанию WAVE_FORMAT_PCM).

• Вывод WAVE_FORMAT_IEEE_FLOAT теперь включает чанк fact, как требуется для не-PCM форматов WAVE.

(Авторы: Lionel Koenig и Michiel W. Beijen в gh-60729.)

webbrowser¶

• На macOS новый класс webbrowser.MacOS открывает URL через /usr/bin/open вместо создания и выполнения AppleScript через osascript. Браузер по умолчанию определяется из файла настроек LaunchServices с помощью plistlib, с com.apple.Safari в качестве запасного варианта на свежих установках. Для URL, отличных от HTTP(S), используется open -b <bundle-id>, чтобы направить URL через браузер, а не через обработчик файлов ОС, предотвращая атаки с внедрением файлов. (Автор: Jeff Lyon в gh-137586.)

xml¶

• Добавлена функция xml.is_valid_name() для проверки, может ли строка использоваться как имя элемента или атрибута в XML. (Автор: Serhiy Storchaka в gh-139489.)

• Добавлена функция xml.is_valid_text(), позволяющая проверить, может ли строка использоваться в XML-документе. (Автор: Serhiy Storchaka в gh-139489.)

xml.parsers.expat¶

• Добавлены SetAllocTrackerActivationThreshold() и SetAllocTrackerMaximumAmplification() в объекты xmlparser для настройки защиты от непропорционально большого использования динамической памяти внутри парсера Expat. (Автор: Bénédikt Tran в gh-90949.)

• Добавлены SetBillionLaughsAttackProtectionActivationThreshold() и SetBillionLaughsAttackProtectionMaximumAmplification() в объекты xmlparser для настройки защиты от атак «billion laughs». (Автор: Bénédikt Tran в gh-90949.)

zlib¶

• Разрешено объединение двух контрольных сумм Adler-32 с помощью adler32_combine(). (Авторы: Callum Attryde и Bénédikt Tran в gh-134635.)

• Разрешено объединение двух контрольных сумм CRC-32 с помощью crc32_combine(). (Автор: Bénédikt Tran в gh-134635.)

base64 & binascii¶

• Базовая реализация base64 в CPython теперь кодирует в 2 раза быстрее и декодирует в 3 раза быстрее благодаря простым оптимизациям конвейеризации CPU. (Авторы: Gregory P. Smith и Serhiy Storchaka в gh-143262.)

• Реализация кодирования Ascii85, Base85 и Z85 переписана на C. Кодирование и декодирование теперь на два порядка быстрее и потребляют на два порядка меньше памяти. (Авторы: James Seo и Serhiy Storchaka в gh-101178.)

• Реализация Base32 переписана на C. Кодирование и декодирование теперь на два порядка быстрее. (Автор: James Seo в gh-146192.)

csv¶

• csv.Sniffer.sniff() определение разделителя теперь работает до 1.6 раз быстрее. (Автор: Maurycy Pawłowski-Wieroński в gh-137628.)

Улучшенный JIT-компилятор¶Upgraded JIT compiler

Результаты набора тестов pyperformance показывают 8-9% среднее геометрическое улучшение производительности JIT по сравнению со стандартным интерпретатором CPython, собранным со всеми оптимизациями, на x86-64 Linux. На AArch64 macOS JIT имеет 12-13% ускорение по сравнению с интерпретатором с хвостовыми вызовами со всеми включёнными оптимизациями. Ускорение сборок с JIT относительно сборок без JIT варьируется от примерно 15% замедления до более чем 100% ускорения (без учёта микробенчмарка unpack_sequence) на системах x86-64 Linux и AArch64 macOS.

Основные улучшения JIT:

• Новый интерфейс трассировки

• Базовая регистровая аллокация в JIT

• Больше оптимизаций JIT

• More JIT optimizations

• GDB and GNU backtrace() unwinding support

• Улучшенная генерация машинного кода

LLVM 21 build-time dependency

The JIT compiler now uses LLVM 21 for build-time stencil generation. As always, LLVM is only needed when building CPython with the JIT enabled; end users running Python do not need LLVM installed. Instructions for installing LLVM can be found in the JIT compiler documentation for all supported platforms. (Contributed by Savannah Ostrowski in gh-140973.)

A new tracing frontend

The JIT compiler now supports significantly more bytecode operations and control flow than in Python 3.14, enabling speedups on a wider variety of code. For example, simple Python object creation is now understood by the 3.15 JIT compiler. Overloaded operations and generators are also partially supported. This was made possible by an overhauled JIT tracing frontend that records actual execution paths through code, rather than estimating them as the previous implementation did. (Contributed by Ken Jin in gh-139109. Support for Windows added by Mark Shannon in gh-141703.)

Basic register allocation in the JIT

A basic form of register allocation has been added to the JIT compiler’s optimizer. This allows the JIT compiler to avoid certain stack operations altogether and instead operate on registers. This allows the JIT to produce more efficient traces by avoiding reads and writes to memory. (Contributed by Mark Shannon in gh-135379.)

More JIT optimizations

Теперь выполняется больше распространения констант. Это означает, что когда JIT-компилятор обнаруживает, что определённый пользовательский код приводит к константам, код может быть упрощён JIT. (Авторы: Ken Jin и Savannah Ostrowski в gh-132732.)

Счётчики ссылок избегаются везде, где это безопасно. Это в целом снижает стоимость большинства операций в Python. (Авторы: Ken Jin, Donghee Na, Zheao Li, Hai Zhu, Savannah Ostrowski, Reiden Ong, Noam Cohen, Tomas Roun, PuQing, Cajetan Rodrigues и Sacul в gh-134584.)

Отслеживая уникальные ссылки на объекты, оптимизатор JIT теперь может исключать обновления счётчика ссылок и выполнять операции на месте с int и float. (Авторы: Reiden Ong и Pieter Eendebak в gh-143414 и gh-146306.)

Поддержка раскрутки стека в GDB и GNU gh-131798

GDB and GNU backtrace() unwinding support

The JIT compiler now publishes unwind information for generated machine code to the GDB interface on supported Linux ELF platforms. When libgcc frame registration is available, the same unwind information is also registered for GNU backtrace() stack walkers. This allows native debuggers, crash handlers, and diagnostic tools using these mechanisms to unwind through JIT frames instead of stopping at generated code. (Contributed by Diego Russo and Pablo Galindo Salgado in gh-146071 and gh-149104.)

Better machine code generation

The JIT compiler’s machine code generator now produces better machine code for x86-64 and AArch64 macOS and Linux targets. In general, users should experience lower memory usage for generated machine code and more efficient machine code versus 3.14. (Contributed by Brandt Bucher in gh-136528 and gh-135905. Implementation for AArch64 contributed by Mark Shannon in gh-139855. Additional optimizations for AArch64 contributed by Mark Shannon and Diego Russo in gh-140683 and gh-142305.)

Maintainability

The JIT optimizer’s operations have been simplified. This was made possible by a refactoring of JIT data structures. (Contributed by Zhongtian Zheng in gh-148211 and Hai Zhu in gh-143421.)

ast¶

• Конструкторы узлов AST теперь вызывают TypeError, когда пропущен обязательный аргумент или передан именованный аргумент, не соответствующий полю узла AST. Ранее в этих случаях начиная с Python 3.13 вызывалось DeprecationWarning. (Авторы: Brian Schubert и Jelle Zijlstra в gh-137600 и gh-105858.)

collections.abc¶

• collections.abc.ByteString удалён из collections.abc.__all__. collections.abc.ByteString устарел начиная с Python 3.12, и запланирован к удалению в Python 3.17.

ctypes¶

• Удалена недокументированная функция ctypes.SetPointerType(), которая была устаревшей начиная с Python 3.13. (Автор: Bénédikt Tran в gh-133866.)

• Изменены _type_ c_float_complex, c_double_complex и c_longdouble_complex с F, D и G на Zf, Zd и Zg для совместимости с numpy. (Автор: Victor Stinner в gh-148675.)

datetime¶

• strptime() теперь возбуждает ValueError, если строка формата содержит %d (день месяца) без указания года. Это поведение устарело начиная с Python 3.13. (Авторы: Stan Ulbrych и Gregory P. Smith в gh-70647.)

glob¶

• Удалены недокументированные функции glob.glob0() и glob.glob1(), которые были устаревшими начиная с Python 3.13. Используйте glob.glob() и передайте каталог в его аргумент root_dir. (Автор: Barney Gale в gh-137466.)

http.server¶

• Удалены класс CGIHTTPRequestHandler и флаг --cgi из интерфейса командной строки python -m http.server. Они были объявлены устаревшими в Python 3.13. (Автор: Bénédikt Tran в gh-133810.)

importlib.resources¶

• Удалён устаревший параметр package из функции importlib.resources.files(). (Автор: Semyon Moroz в gh-138044.)

pathlib¶

• pathlib.Path.mkdir() теперь имеет параметр parent_mode, позволяющий указывать режим для промежуточных каталогов при parents=True. (Автор: Gregory P. Smith в gh-86533.)

• Удалено устаревшее pathlib.PurePath.is_reserved(). Используйте os.path.isreserved() для обнаружения зарезервированных путей в Windows. (Автор: Nikita Sobolev в gh-133875.)

platform¶

• Удалена функция platform.java_ver(), которая была устаревшей начиная с Python 3.13. (Автор: Alexey Makridenko в gh-133604.)

sre_*¶

• Удалены модули sre_compile, sre_constants и sre_parse. (Автор: Stan Ulbrych в gh-135994.)

sysconfig¶

• Удалён параметр check_home у sysconfig.is_python_build(). (Автор: Filipe Laíns в gh-92897.)

threading¶

• Удалена поддержка произвольных позиционных или именованных аргументов в C-реализации объектов RLock. Это было объявлено устаревшим в Python 3.14. (Автор: Bénédikt Tran в gh-134087.)

types¶

• Удалён устаревший в PEP 626 начиная с Python 3.12 codeobject.co_lnotab из types.CodeType. (Автор: Nikita Sobolev в gh-134690.)

typing¶

• typing.ByteString удалён из typing.__all__. typing.ByteString устарел начиная с Python 3.9 и запланирован к удалению в Python 3.17.

• Недокументированный синтаксис именованных аргументов для создания классов NamedTuple (например, Point = NamedTuple("Point", x=int, y=int)) больше не поддерживается. Используйте вместо него синтаксис на основе класса или функциональный синтаксис. (Автор: Bénédikt Tran в gh-133817.)

• Использование TD = TypedDict("TD") или TD = TypedDict("TD", None) для создания типа TypedDict с нулевым количеством полей больше не поддерживается. Используйте class TD(TypedDict): pass или TD = TypedDict("TD", {}) вместо этого. (Автор: Bénédikt Tran в gh-133823.)

• Устаревшее @typing.no_type_check_decorator удалено. (Автор: Nikita Sobolev в gh-133601.)

wave¶

• Удалены методы getmark(), setmark() и getmarkers() классов Wave_read и Wave_write, которые были устаревшими начиная с Python 3.13. (Автор: Bénédikt Tran в gh-133873.)

zipimport¶

• Удалено устаревшее zipimport.zipimporter.load_module(). Вместо него используйте zipimport.zipimporter.exec_module(). (Автор: Jiahao Li в gh-133656.)

Новые устаревания¶New deprecations

• ast

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

    (Автор: Brian Schubert в gh-116021.)

• base64:

  • Принятие символов + и / с альтернативным алфавитом в b64decode() и urlsafe_b64decode() теперь устарело. В будущих версиях Python они будут вызывать ошибку в строгом режиме и отбрасываться в нестрогом режиме. (Автор: Serhiy Storchaka в gh-125346.)

• CLI:

  • Устарели параметры командной строки -b и -bb и запланированы к превращению в заглушки в Python 3.17. Они были в основном помощниками для перехода с Python 2 на 3. Начиная с Python 3.17, BytesWarning не будет вызываться для этих случаев; вместо этого используйте средство проверки типов.

    (Автор: Nikita Sobolev в gh-136355.)

• collections.abc

  • Следующие инструкции теперь вызывают выдачу DeprecationWarning во время выполнения:

    • from collections.abc import ByteString

    • import collections.abc; collections.abc.ByteString.

    DeprecationWarning уже выдавались, если collections.abc.ByteString был подклассом или использовался в качестве второго аргумента для isinstance() или issubclass(), но предупреждения ранее не выдавались, если он просто импортировался или получался из модуля collections.abc.

• hashlib:

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

    Поддержка имени именованного аргумента string теперь устарела и запланирована к удалению в Python 3.19. Предпочтительнее передавать начальные данные как позиционный аргумент для максимальной обратной совместимости.

    (Автор: Bénédikt Tran в gh-134978.)

• http.cookies:

  • Morsel.js_output и BaseCookie.js_output устарели и будут удалены в Python 3.19. Используйте Morsel.output или BaseCookie.output вместо. (Автор: kishorhange111 в gh-148849.)

• imaplib:

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

• re:

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

• struct:

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

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

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

• typing:

  • Следующие инструкции теперь вызывают выдачу DeprecationWarning во время выполнения:

    • from typing import ByteString

    • import typing; typing.ByteString.

    DeprecationWarning уже выдавались, если typing.ByteString был подклассом или использовался в качестве второго аргумента для isinstance() или issubclass(), но предупреждения ранее не выдавались, если он просто импортировался или получался из модуля typing.

• webbrowser:

  • webbrowser.MacOSXOSAScript устарел в пользу webbrowser.MacOS и запланирован к удалению в Python 3.17. (Автор: Jeff Lyon в gh-137586.)

• __version__

  • Атрибуты __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.)

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

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

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

  • Установка __package__ в модуле при отсутствии __spec__.parent устарела. В Python 3.16 __package__ перестанет устанавливаться или учитываться системой импорта или стандартной библиотекой. (gh-97879)

• Встроенная копия libmpdec.

• 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:

  • Метод 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:

  • Недокументированный и неиспользуемый атрибут TarInfo.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.

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

• abc

  • Мягко устаревшие с Python 3.3 abc.abstractclassmethod, abc.abstractstaticmethod и abc.abstractproperty теперь вызывают DeprecationWarning. Эти классы будут удалены в Python 3.21, вместо них используйте abc.abstractmethod() с classmethod(), staticmethod() и property соответственно.

• ast:

  • Классы slice, Index, ExtSlice, Suite, Param, AugLoad и AugStore будут удалены в Python 3.21. Эти типы не создаются синтаксическим анализатором и не принимаются генератором кода.

  • Свойство dims объекта ast.Tuple будет удалено в Python 3.21. Используйте свойство ast.Tuple.elts вместо него.

• struct:

  • Мягко устаревшие с Python 3.15, коды типов 'F' и 'D' теперь устарели. Эти коды будут удалены в Python 3.21. Используйте вместо них двухбуквенные формы 'Zf' и 'Zd'.

• tempfile:

  • tempfile._TemporaryFileWrapper будет удалён в Python 3.21. Используйте публичный tempfile.TemporaryFileWrapper вместо него.

Будет удалено в будущих версиях¶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.)

Новые возможности¶New features

• Добавлены функции PyArg_ParseArray() и PyArg_ParseArrayAndKeywords() для разбора аргументов функций, использующих соглашение о вызове METH_FASTCALL. (Автор: Victor Stinner в gh-144175.)

• Добавлены следующие функции для нового типа frozendict:

  • PyAnyDict_Check()

  • PyAnyDict_CheckExact()

  • PyFrozenDict_Check()

  • PyFrozenDict_CheckExact()

  • PyFrozenDict_New()

  (Автор: Victor Stinner в gh-141510.)

• Добавлена функция PyObject_CallFinalizerFromDealloc() в ограниченный C API. (Автор: Victor Stinner в gh-146063.)

• Добавлены функции PySys_GetAttr(), PySys_GetAttrString(), PySys_GetOptionalAttr() и PySys_GetOptionalAttrString() в качестве замены для PySys_GetObject(). (Автор: Serhiy Storchaka в gh-108512.)

• Добавлена PyUnstable_Unicode_GET_CACHED_HASH для получения кешированного хеша строки. См. документацию по ограничениям. (Автор: Petr Viktorin в gh-131510.)

• Добавлен API для проверки совместимости ABI модулей расширения: Py_mod_abi, PyABIInfo_Check() и PyABIInfo_VAR. (Автор: Petr Viktorin в gh-137210.)

• Реализован PEP 782, API PyBytesWriter. Добавлены функции:

  • PyBytesWriter_Create()

  • PyBytesWriter_Discard()

  • PyBytesWriter_FinishWithPointer()

  • PyBytesWriter_FinishWithSize()

  • PyBytesWriter_Finish()

  • PyBytesWriter_Format()

  • PyBytesWriter_GetData()

  • PyBytesWriter_GetSize()

  • PyBytesWriter_GrowAndUpdatePointer()

  • PyBytesWriter_Grow()

  • PyBytesWriter_Resize()

  • PyBytesWriter_WriteBytes()

  (Автор: Victor Stinner в gh-129813.)

• PyCriticalSection и связанные функции добавлены в стабильный ABI.

  (Вклад в gh-149227.)

• Добавлен новый PyImport_CreateModuleFromInitfunc() C-API для создания модуля из спецификации и функции инициализации. (Автор: Itamar Oren в gh-116146.)

• Добавлена PyTuple_FromArray() для создания tuple из массива. (Автор: Victor Stinner в gh-111489.)

• Добавлен новый хук экспорта модуля, PyModExport_*.

  (Автор: Petr Viktorin в PEP 793 и gh-140550.)

• Добавлены функции, гарантированно безопасные для использования в обработчиках tp_traverse: PyObject_GetTypeData_DuringGC(), PyObject_GetItemData_DuringGC(), PyType_GetModuleState_DuringGC(), PyModule_GetState_DuringGC(), PyModule_GetToken_DuringGC(), PyType_GetBaseByToken_DuringGC(), PyType_GetModule_DuringGC(), PyType_GetModuleByToken_DuringGC(). (Автор: Petr Viktorin в gh-145925.)

• Добавлена PyObject_Dump() для дампа объекта в stderr. Её следует использовать только для отладки. (Автор: Victor Stinner в gh-141070.)

• Реализован PEP 820: PySlot – унифицированная система слотов для C API. См. Definition slots для документации.

  Добавлено:

  • Структура PySlot;

  • функция PyType_FromSlots();

  • новые идентификаторы слотов: Py_slot_end, Py_slot_invalid; Py_slot_subslots, Py_tp_slots, Py_mod_slots; Py_tp_name, Py_tp_basicsize, Py_tp_extra_basicsize, Py_tp_itemsize, Py_tp_flags, Py_tp_metaclass, Py_tp_module;

  • удобные макросы: PySlot_DATA, PySlot_FUNC, PySlot_SIZE, PySlot_INT64, PySlot_UINT64, PySlot_STATIC_DATA, PySlot_END, PySlot_PTR, PySlot_PTR_STATIC.

  Функция PyModule_FromSlotsAndSpec() и PyModExport хук экспорта модуля также используют новую структуру PySlot.

  Следующие функции помечены как мягко устаревшие:

  • PyType_FromSpec()

  • PyType_FromSpecWithBases()

  • PyType_FromModuleAndSpec()

  • PyType_FromMetaclass()

  • PyModule_FromDefAndSpec()

  • PyModule_FromDefAndSpec2()

  • PyModule_ExecDef()

  Слоты Py_tp_bases и Py_tp_base теперь эквивалентны: их можно установить как на один тип, так и на кортеж типов. Слот Py_tp_bases предпочтительнее; другой игнорируется, если указаны оба.

  (Автор: Petr Viktorin в gh-149044.)

• Добавлены функции PyUnstable_ThreadState_SetStackProtection() и PyUnstable_ThreadState_ResetStackProtection() для установки базового адреса защиты стека и размера защиты стека состояния потока Python. (Автор: Victor Stinner в gh-139653.)

• Добавлена PyUnstable_SetImmortal() функция C API для пометки объектов как бессмертных. (Автор: Kumar Aditya в gh-143300.)

• Восстановлена частная промежуточная _Py_InitializeMain() функция, удалённая в Python 3.14. (Автор: Victor Stinner в gh-142417.)

• Добавлены функции PyUnstable_DumpTraceback() и PyUnstable_DumpTracebackThreads() для вывода Python стек-трейсов. (Автор: Alex Malyshev в gh-145559.)

Изменённые C API¶Changed C APIs

• Если установлен флаг Py_TPFLAGS_MANAGED_DICT или Py_TPFLAGS_MANAGED_WEAKREF, то Py_TPFLAGS_HAVE_GC также должен быть установлен. (Автор: Sergey Miryanov в gh-134786.)

• PyDateTime_IMPORT теперь потокобезопасен. Код, который напрямую проверяет PyDateTimeAPI на NULL, следует обновить, чтобы вместо этого вызывать PyDateTime_IMPORT. (Автор: Kumar Aditya в gh-141563.)

Удалённые C API¶Removed C APIs

• Удалены устаревшие PyUnicode функции:

  • PyUnicode_AsDecodedObject(): Вместо этого используйте PyCodec_Decode().

  • PyUnicode_AsDecodedUnicode(): Используйте PyCodec_Decode() вместо неё; обратите внимание, что некоторые кодеки (например, «base64») могут возвращать тип, отличный от str, например bytes.

  • PyUnicode_AsEncodedObject(): Вместо этого используйте PyCodec_Encode().

  • PyUnicode_AsEncodedUnicode(): Используйте PyCodec_Encode() вместо него; обратите внимание, что некоторые кодеки (например, «base64») могут возвращать тип, отличный от bytes, например str.

  (Автор: Stan Ulbrych в gh-133612.)

• PyImport_ImportModuleNoBlock(): устаревший псевдоним PyImport_ImportModule(). (Автор: Bénédikt Tran в gh-133644.)

• PyWeakref_GetObject() и PyWeakref_GET_OBJECT: используйте PyWeakref_GetRef() вместо них. Проект pythoncapi-compat можно использовать для получения PyWeakref_GetRef() на Python 3.12 и старше. (Автор: Bénédikt Tran в gh-133644.)

• Удалён устаревший PySys_ResetWarnOptions(). Вместо этого очищайте sys.warnoptions и warnings.filters.

  (Автор: Nikita Sobolev в gh-138886.)

Следующие функции удалены в пользу PyConfig_Get(). Проект pythoncapi-compat можно использовать для получения PyConfig_Get() на Python 3.13 и старше.

• Функции инициализации Python:

  • Py_GetExecPrefix(): используйте PyConfig_Get("base_exec_prefix") (sys.base_exec_prefix) вместо неё. Используйте PyConfig_Get("exec_prefix") (sys.exec_prefix), если необходимо обрабатывать виртуальные окружения.

  • Py_GetPath(): используйте PyConfig_Get("module_search_paths") (sys.path) вместо него.

  • Py_GetPrefix(): вместо этого используйте PyConfig_Get("base_prefix") (sys.base_prefix). Используйте PyConfig_Get("prefix") (sys.prefix), если требуется работа с виртуальными окружениями.

  • Py_GetProgramFullPath(): вместо этого используйте PyConfig_Get("executable") (sys.executable).

  • Py_GetProgramName(): вместо этого используйте PyConfig_Get("executable") (sys.executable).

  • Py_GetPythonHome(): вместо этого используйте PyConfig_Get("home") или переменную окружения PYTHONHOME.

  (Автор: Bénédikt Tran в gh-133644.)

Устаревшие C API¶Deprecated C APIs

• Устарела поддержка PEP 456 для предоставления внешнего определения схемы хеширования строк. Удаление запланировано на Python 3.19.

  Ранее разработчики встраиваемых приложений могли определить Py_HASH_ALGORITHM как Py_HASH_EXTERNAL, чтобы указать, что схема хеширования предоставляется извне, но эта возможность была недокументированной, непроверенной и, скорее всего, неиспользуемой.

  (Автор: Bénédikt Tran в gh-141226.)

• Для форматов беззнаковых целых чисел в PyArg_ParseTuple() теперь объявлено устаревшим принятие целых чисел Python, значение которых больше максимального значения для типа C или меньше минимального значения для соответствующего знакового целого типа того же размера. (Автор: Serhiy Storchaka в gh-132629.)

• PyBytes_FromStringAndSize(NULL, len) и _PyBytes_Resize() мягко устарели; вместо них используйте API PyBytesWriter. (Автор: Victor Stinner в gh-129813.)

• _PyObject_CallMethodId(), _PyObject_GetAttrId() и _PyUnicode_FromId() устарели с версии 3.15 и будут удалены в 3.20. Вместо этого используйте PyUnicode_InternFromString() и кешируйте результат в состоянии модуля, затем вызывайте PyObject_CallMethod() или PyObject_GetAttr(). (Предложено Виктором Стиннером в gh-141049.)

• Устарело поле cval типа PyComplexObject. Используйте PyComplex_AsCComplex() и PyComplex_FromCComplex() для преобразования комплексного числа Python в/из представления C Py_complex. (Автор: Sergey B Kirpichev в gh-128813.)

• Функции _Py_c_sum(), _Py_c_diff(), _Py_c_neg(), _Py_c_prod(), _Py_c_quot(), _Py_c_pow() и _Py_c_abs() мягко устарели. (Автор: Sergey B Kirpichev в gh-128813.)

• bytes_warning устарело начиная с версии 3.15 и будет удалено в версии 3.17. (Автор: Nikita Sobolev в gh-136355.)

• Макрос Py_INFINITY мягко устарел; используйте стандарт C11 <math.h> INFINITY. (Автор: Sergey B Kirpichev в gh-141004.)

• Следующие макросы мягко устарели:

  • Py_ALIGNED: вместо этого используйте alignas.

  • PY_FORMAT_SIZE_T: используйте непосредственно "z".

  • Py_LL и Py_ULL: используйте стандартные суффиксы: LL и ULL.

  • PY_LONG_LONG, PY_LLONG_MIN, PY_LLONG_MAX, PY_ULLONG_MAX, PY_INT32_T, PY_UINT32_T, PY_INT64_T, PY_UINT64_T, PY_SIZE_MAX: используйте типы/пределы C99.

  • Py_UNICODE_SIZE: используйте непосредственно sizeof(wchar_t).

  • Py_VA_COPY: используйте непосредственно va_copy.

  Макрос Py_UNICODE_WIDE, который планировался к удалению, теперь мягко устарел.

  (Автор: Petr Viktorin в gh-146175.)

• Py_MATH_El и Py_MATH_PIl устарели начиная с версии 3.15 и будут удалены в версии 3.20. (Автор: Sergey B Kirpichev в gh-141004.)