Что нового в Python 3.10¶

Контекстные менеджеры, заключенные в круглые скобки¶

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

with (CtxManager() as example):
    ...

with (
    CtxManager1(),
    CtxManager2()
):
    ...

with (CtxManager1() as example,
      CtxManager2()):
    ...

with (CtxManager1(),
      CtxManager2() as example):
    ...

with (
    CtxManager1() as example1,
    CtxManager2() as example2
):
    ...

также можно использовать конечную запятую в конце заключенной группы:

with (
    CtxManager1() as example1,
    CtxManager2() as example2,
    CtxManager3() as example3,
):
    ...

Этот новый синтаксис использует возможности нового синтаксического анализатора, отличные от LL(1). Проверьте PEP 617 для получения более подробной информации.

(Авторы: Гвидо ван Россум, Пабло Галиндо и Лисандрос Николау в bpo-12782 и bpo-40334.)

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

expected = {9: 1, 18: 2, 19: 2, 27: 3, 28: 3, 29: 3, 36: 4, 37: 4,
            38: 4, 39: 4, 45: 5, 46: 5, 47: 5, 48: 5, 49: 5, 54: 6,
some_other_code = foo()

File "example.py", line 3
    some_other_code = foo()
                    ^
SyntaxError: invalid syntax

File "example.py", line 1
    expected = {9: 1, 18: 2, 19: 2, 27: 3, 28: 3, 29: 3, 36: 4, 37: 4,
               ^
SyntaxError: '{' was never closed

>>> foo(x, z for z in range(10), t, w)
  File "<stdin>", line 1
    foo(x, z for z in range(10), t, w)
           ^
SyntaxError: Generator expression must be parenthesized

>>> foo(x, z for z in range(10), t, w)
  File "<stdin>", line 1
    foo(x, z for z in range(10), t, w)
           ^^^^^^^^^^^^^^^^^^^^
SyntaxError: Generator expression must be parenthesized

>>> def foo():
...    if lel:
...    x = 2
  File "<stdin>", line 3
    x = 2
    ^
IndentationError: expected an indented block after 'if' statement in line 2

>>> collections.namedtoplo
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
AttributeError: module 'collections' has no attribute 'namedtoplo'. Did you mean: namedtuple?

>>> schwarzschild_black_hole = None
>>> schwarschild_black_hole
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
NameError: name 'schwarschild_black_hole' is not defined. Did you mean: schwarzschild_black_hole?

PEP 626: Точные номера строк для отладки и других инструментов¶

PEP 626 предоставляет более точные и надежные номера строк для инструментов отладки, профилирования и покрытия. События трассировки с правильным номером строки генерируются для всех выполняемых строк кода и только для тех строк кода, которые выполняются.

Атрибут f_lineno объектов frame всегда будет содержать ожидаемый номер строки.

Атрибут co_lnotab в code objects устарел и будет удален в версии 3.12. Код, который должен преобразовать смещение в номер строки, должен использовать новый метод co_lines().

PEP 634: Согласование структурных моделей¶

Добавлено структурное сопоставление шаблонов в виде инструкций match и case для шаблонов с соответствующими действиями. Шаблоны состоят из последовательностей, отображений, примитивных типов данных, а также экземпляров классов. Сопоставление с образцом позволяет программам извлекать информацию из сложных типов данных, разветвлять структуру данных и применять определенные действия, основанные на различных формах данных.

match subject:
    case <pattern_1>:
        <action_1>
    case <pattern_2>:
        <action_2>
    case <pattern_3>:
        <action_3>
    case _:
        <action_wildcard>

def http_error(status):
    match status:
        case 400:
            return "Bad request"
        case 404:
            return "Not found"
        case 418:
            return "I'm a teapot"
        case _:
            return "Something's wrong with the internet"

case 401 | 403 | 404:
    return "Not allowed"

def http_error(status):
    match status:
        case 400:
            return "Bad request"
        case 404:
            return "Not found"
        case 418:
            return "I'm a teapot"

# point is an (x, y) tuple
match point:
    case (0, 0):
        print("Origin")
    case (0, y):
        print(f"Y={y}")
    case (x, 0):
        print(f"X={x}")
    case (x, y):
        print(f"X={x}, Y={y}")
    case _:
        raise ValueError("Not a point")

class Point:
    x: int
    y: int

def location(point):
    match point:
        case Point(x=0, y=0):
            print("Origin is the point's location.")
        case Point(x=0, y=y):
            print(f"Y={y} and the point is on the y-axis.")
        case Point(x=x, y=0):
            print(f"X={x} and the point is on the x-axis.")
        case Point():
            print("The point is located somewhere else on the plane.")
        case _:
            print("Not a point")

Point(1, var)
Point(1, y=var)
Point(x=1, y=var)
Point(y=var, x=1)

match points:
    case []:
        print("No points in the list.")
    case [Point(0, 0)]:
        print("The origin is the only point in the list.")
    case [Point(x, y)]:
        print(f"A single point {x}, {y} is in the list.")
    case [Point(0, y1), Point(0, y2)]:
        print(f"Two points on the Y axis at {y1}, {y2} are in the list.")
    case _:
        print("Something else is found in the list.")

match test_variable:
    case ('warning', code, 40):
        print("A warning has been received.")
    case ('error', code, _):
        print(f"An error {code} occurred.")

match point:
    case Point(x, y) if x == y:
        print(f"The point is located on the diagonal Y=X at {x}.")
    case Point(x, y):
        print(f"Point is not on the diagonal.")

Необязательный параметр EncodingWarning и encoding="locale"¶

Кодировка по умолчанию для TextIOWrapper и open() зависит от платформы и языкового стандарта. Поскольку UTF-8 используется на большинстве платформ Unix, пропуск опции encoding при открытии файлов в формате UTF-8 (например, JSON, YAML, TOML, Markdown) является очень распространенной ошибкой. Например:

# BUG: "rb" mode or encoding="utf-8" should be used.
with open("data.json") as f:
    data = json.load(f)

Чтобы найти ошибку такого типа, добавляется необязательный символ EncodingWarning. Он выводится, если значение sys.flags.warn_default_encoding равно true и используется кодировка по умолчанию, зависящая от конкретной локали.

для включения предупреждения добавлены опции -X warn_default_encoding и PYTHONWARNDEFAULTENCODING.

Смотрите Кодировка текста для получения дополнительной информации.

PEP 604: Оператор объединения нового типа¶

Был введен новый оператор объединения типов, который позволяет использовать синтаксис X | Y. Это обеспечивает более понятный способ выражения «либо тип X, либо тип Y» вместо использования typing.Union, особенно в подсказках по типу.

В предыдущих версиях Python для применения подсказки типа к функциям, принимающим аргументы нескольких типов, использовался typing.Union:

def square(number: Union[int, float]) -> Union[int, float]:
    return number ** 2

Подсказки по вводу текста теперь можно писать более кратко:

def square(number: int | float) -> int | float:
    return number ** 2

Этот новый синтаксис также принимается в качестве второго аргумента для isinstance() и issubclass():

>>> isinstance(1, int | str)
True

Смотрите Тип соединения и PEP 604 для получения более подробной информации.

(Материалы предоставлены Мэгги Мосс и Филиппом Прадосом в bpo-41428, с дополнениями Юрия Карабаса и Сергея Сторчаки в bpo-44490.)

PEP 612: Переменные спецификации параметров¶

В модуль typing добавлены две новые опции для улучшения информации, предоставляемой средствам проверки статического типа для PEP 484 и Callable.

Первая - это переменная спецификации параметра. Они используются для пересылки типов параметров одного вызываемого объекта другому вызываемому объекту - шаблон, обычно встречающийся в функциях и декораторах более высокого порядка. Примеры использования можно найти в typing.ParamSpec. Ранее не существовало простого способа ввести аннотированную зависимость типов параметров таким точным образом.

Второй вариант - это новый оператор Concatenate. Он используется в сочетании с переменными спецификации параметров для ввода аннотации к вызываемому объекту более высокого порядка, который добавляет или удаляет параметры другого вызываемого объекта. Примеры использования можно найти в typing.Concatenate.

Видишь typing.Callable, typing.ParamSpec, typing.Concatenate, typing.ParamSpecArgs, typing.ParamSpecKwargs, и PEP 612 для получения более подробной информации.

(Автор - Кен Джин в bpo-41559, с небольшими улучшениями - Джелле Зейлстра в bpo-43783. Ободряющий текст написан Марком Мендосой.)

PEP 613: Типология¶

PEP 484 введена концепция псевдонимов типов, требующая, чтобы они были только назначениями верхнего уровня без пометок. Из-за этой простоты специалистам по проверке типов иногда было трудно отличить псевдонимы типов от обычных назначений, особенно когда речь шла о прямых ссылках или недопустимых типах. Сравнивать:

StrCache = 'Cache[str]'  # a type alias
LOG_PREFIX = 'LOG[DEBUG]'  # a module constant

Теперь модуль typing имеет специальное значение TypeAlias, которое позволяет более явно объявлять псевдонимы типов:

StrCache: TypeAlias = 'Cache[str]'  # a type alias
LOG_PREFIX = 'LOG[DEBUG]'  # a module constant

Смотрите PEP 613 для получения более подробной информации.

(Автор: Михаил Голубев в статье bpo-41923.)

PEP 647: Защитные ограждения определенного пользователем типа¶

TypeGuard добавлено в модуль typing для аннотирования функций защиты типов и улучшения информации, предоставляемой статическим средствам проверки типов при сужении диапазона типов. Для получения дополнительной информации, пожалуйста, ознакомьтесь с документацией TypeGuard и PEP 647.

(Авторы - Кен Джин и Гвидо ван Россум в bpo-43766. Подбадривающий текст - Эрик Траут.)

асинхронный¶

Добавьте отсутствующий метод connect_accepted_socket(). (Добавлено Алексом Гренхольмом в bpo-41332.)

аргументированный анализ¶

Вводящая в заблуждение фраза «необязательные аргументы» была заменена на «options» в справке argparse. Некоторые тесты могут потребовать адаптации, если они основаны на точном совпадении выходных данных. (Добавлено Раймондом Хеттингером в bpo-9694.)

массив¶

Метод index() из array.array теперь имеет необязательные параметры start и stop. ((Добавлено Андерсом Лоренценом и Закери Спитцем в bpo-31956.)

asynchat, asyncore, smtpd¶

Эти модули были помечены как устаревшие в документации к их модулям, начиная с версии Python 3.6. Теперь ко всем трем этим модулям добавлено значение времени импорта DeprecationWarning.

базовый уровень 64¶

Добавьте base64.b32hexencode() и base64.b32hexdecode() для поддержки кодировки Base32 с расширенным шестнадцатеричным алфавитом.

бдб¶

Добавьте clearBreakpoints(), чтобы сбросить все установленные точки останова. (Добавлено Ирит Катриэль в bpo-24160.)

разделить пополам¶

Добавлена возможность предоставления функции key API в модуле bisect. (Добавлено Раймондом Хеттингером в bpo-4356.)

кодеки¶

Добавьте функцию codecs.unregister(), чтобы отменить регистрацию функции поиска кодеков. (Добавлено Хай Ши в bpo-41842.)

сборники.abc¶

Значения __args__ в parameterized generic для collections.abc.Callable теперь согласуются с typing.Callable. collections.abc.Callable generic теперь выравнивает параметры типа, аналогично тому, что в настоящее время делает typing.Callable . Это означает, что в collections.abc.Callable[[int, str], str] будет __args__ из (int, str, str); ранее это было ([int, str], str). Чтобы разрешить это изменение, types.GenericAlias теперь может быть разделен на подклассы, и подкласс будет возвращен при указании типа collections.abc.Callable. Обратите внимание, что TypeError может быть вызвано для недопустимых форм параметризации collections.abc.Callable, которые, возможно, были пропущены автоматически в Python 3.9. (Добавлено Кеном Джином в bpo-42195.)

контекстная библиотека¶

Добавьте контекстный менеджер contextlib.aclosing() для безопасного закрытия асинхронных генераторов и объектов, представляющих асинхронно высвобождаемые ресурсы. (Авторы - Джунги Ким и Джон Бельмонте в статье bpo-41229).

Добавьте поддержку асинхронного контекстного менеджера в contextlib.nullcontext(). (Добавлено Томом Грингаузом в bpo-41543.)

Добавьте AsyncContextDecorator для поддержки использования асинхронных контекстных менеджеров в качестве декораторов.

проклятия¶

Расширенные цветовые функции, добавленные в ncurses 6.1, будут прозрачно использоваться curses.color_content(), curses.init_color(), curses.init_pair(), и curses.pair_content(). Новая функция, curses.has_extended_color_support(), указывает, предоставляется ли расширенная поддержка цветов базовой библиотекой ncurses. (Авторы Джеффри Кинчер и Ханс Петтер Янссон в статье bpo-36982).

Константы BUTTON5_* теперь доступны в модуле curses, если они предоставляются базовой библиотекой curses. (Добавлено Закери Спитцем в bpo-39273.)

классы данных¶

from dataclasses import dataclass

@dataclass(kw_only=True)
class Birthday:
    name: str
    birthday: datetime.date

from dataclasses import dataclass, field

@dataclass
class Birthday:
    name: str
    birthday: datetime.date = field(kw_only=True)

from dataclasses import dataclass, KW_ONLY

@dataclass
class Point:
    x: float
    y: float
    _: KW_ONLY
    z: float = 0.0
    t: float = 0.0

дистрибутивы¶

Весь пакет distutils устарел и будет удален в Python 3.12. Его функциональность для указания сборок пакетов уже была полностью заменена сторонними пакетами setuptools и packaging, а большинство других широко используемых API доступны в других частях стандартной библиотеки (таких как platform, shutil, subprocess или sysconfig). Не планируется переносить какие-либо другие функциональные возможности из distutils, и приложениям, использующим другие функции, следует планировать создание личных копий кода. Обсуждение приведено в разделе PEP 632.

Команда bdist_wininst, которая считалась устаревшей в Python 3.8, была удалена. Команда bdist_wheel теперь рекомендуется для распространения двоичных пакетов в Windows. (Добавлено Виктором Стиннером в bpo-42802.)

самый проверенный¶

Если модуль не определяет __loader__, вернитесь к __spec__.loader. (Добавлено Бреттом Кэнноном в bpo-42133.)

кодировки¶

encodings.normalize_encoding() теперь игнорируются символы, отличные от ASCII. (Добавлено Хай Ши в bpo-39337.)

перечисление¶

Enum __repr__() теперь возвращает enum_name.member_name, а __str__() теперь возвращает member_name. Перечисления Stdlib, доступные в качестве констант модуля, имеют значение repr() из module_name.member_name. (Добавлено Итаном Фурманом в bpo-40066.)

Добавьте enum.StrEnum для перечислений, в которых все элементы являются строками. (Добавлено Итаном Фурманом в bpo-41816.)

ввод файла¶

Добавьте параметры encoding и errors в fileinput.input() и fileinput.FileInput. (Добавлено Инадой Наоки в bpo-43712.)

fileinput.hook_compressed() теперь возвращает TextIOWrapper объект, когда режим равен «r» и файл сжат, как и несжатые файлы. (Добавлено Инадой Наоки в bpo-5758.)

исправитель ошибок¶

Модуль faulthandler теперь определяет, возникает ли фатальная ошибка во время сбора сборщиком мусора. (Автор: Виктор Стиннер в bpo-44466.)

gc (общий сбор)¶

Добавьте перехватчики аудита для gc.get_objects(), gc.get_referrers() и gc.get_referents(). (Добавлено Пабло Галиндо в bpo-43439.)

глобус¶

Добавьте параметры root_dir и dir_fd в glob() и iglob(), которые позволяют указать корневой каталог для поиска. (Добавлено Сергеем Сторчакой в bpo-38144.)

хэшлиб¶

Для модуля hashlib требуется OpenSSL версии 1.1.1 или новее. (Автор: Кристиан Хеймс в PEP 644 и bpo-43669.)

Модуль hashlib имеет предварительную поддержку OpenSSL 3.0.0. (Автор Кристиан Хеймс в bpo-38820 и других выпусках).

Резервный вариант pbkdf2_hmac(), основанный на чистом Python, устарел. В будущем PBKDF2-HMAC будет доступен только в том случае, если Python будет собран с поддержкой OpenSSL. (Автор: Кристиан Хеймс в bpo-43880.)

hmac (ВМС)¶

Модуль hmac теперь использует внутреннюю реализацию Openssl HMAC. (Добавлено Кристианом Хеймсом в bpo-40645.)

ХОЛОСТОЙ ход и idlelib¶

Заставьте IDLE вызывать sys.excepthook() (при запуске без „-n“). Пользовательские перехваты ранее игнорировались. (Добавлено Кеном Хилтоном в bpo-43008.)

Измените порядок в диалоговом окне настроек. Разделите вкладку «Общие» на вкладки «Windows» и «Shell/Ed». Переместите источники справки, которые расширяют меню «Справка», на вкладку «Расширения». Освободите место для новых опций и сократите диалоговое окно. Благодаря последнему диалоговое окно лучше подходит для небольших экранов. (Автор: Терри Джан Риди в bpo-40468.) Переместите настройку отступа с вкладки «Шрифт» на новую вкладку «Windows». (Авторы: Марк Роузман и Терри Джан Риди в bpo-33962.)

Приведенные выше изменения были перенесены в техническую версию 3.9.

Добавьте боковую панель командной строки. Переместите основное приглашение («>>>») на боковую панель. Добавьте дополнительные приглашения (»…») на боковую панель. Щелкните левой кнопкой мыши и при необходимости перетащите одну или несколько строк текста, как в случае с боковой панелью с номером строки редактора. При щелчке правой кнопкой мыши после выделения строк текста отображается контекстное меню с надписью «копировать с подсказками». При этом подсказки с боковой панели объединяются со строками из выделенного текста. Эта опция также отображается в контекстном меню для текста. (Добавлено Тал Эйнат в bpo-37903.)

Используйте пробелы вместо символов табуляции для выделения отступов в интерактивном коде. Благодаря этому элементы интерактивного кода «выглядят правильно». Создание такой возможности стало основной мотивацией для добавления боковой панели командной строки. (Автор: Терри Ян Риди в bpo-37892).

Выделите новые soft keywords match, case, и _ в инструкциях по сопоставлению с образцом. Однако такое выделение не идеально и в некоторых редких случаях будет некорректным, включая некоторые _-ы в case шаблонах. (Добавлено Тал Эйнат в bpo-44010).

Новое в версии обслуживания 3.10.

Примените подсветку синтаксиса к файлам .pyi. (Авторы - Алекс Уэйгуд и Терри Ян Риди в статье bpo-45447.)

Включите подсказки при сохранении оболочки с входами и выходами. (Автор: Терри Ян Риди в gh-95191.)

importlib.метаданные¶

Соответствие характеристик с importlib_metadata 4.6 (history).

importlib.metadata entry points теперь вы можете выбирать точки входа по группам и названиям с помощью нового класса importlib.metadata.EntryPoints. Дополнительную информацию об амортизации и использовании смотрите в примечании о совместимости в документации.

Добавлен importlib.metadata.packages_distributions() для преобразования модулей и пакетов Python верхнего уровня в их importlib.metadata.Distribution.

проверить¶

Если модуль не определяет __loader__, вернитесь к __spec__.loader. (Добавлено Бреттом Кэнноном в bpo-42133.)

Добавьте inspect.get_annotations(), который безопасно вычисляет аннотации, определенные для объекта. Он работает с учетом особенностей доступа к аннотациям к различным типам объектов и делает очень мало предположений относительно исследуемого объекта. inspect.get_annotations() также может корректно разбивать аннотации на строки. inspect.get_annotations() теперь считается наилучшей практикой для доступа к аннотациям, определенным в любом объекте Python; для получения дополнительной информации о наилучших методах работы с аннотациями, пожалуйста, смотрите Аннотации к лучшим практикам. Соответственно, inspect.signature(), inspect.Signature.from_callable(), и inspect.Signature.from_function() теперь вызовите inspect.get_annotations(), чтобы получить аннотации. Это означает, что inspect.signature() и inspect.Signature.from_callable() теперь также можно расшифровать аннотации в виде строк. (Добавлено Ларри Хастингсом в bpo-43817.)

итеративные инструменты¶

Добавить itertools.pairwise(). (Добавлено Раймондом Хеттингером в bpo-38200.)

линейный кэш¶

Если модуль не определяет __loader__, вернитесь к __spec__.loader. (Добавлено Бреттом Кэнноном в bpo-42133.)

ос¶

Добавлена поддержка os.cpu_count() для ОСРВ VxWorks. (Автор - Пэйсин Синь из bpo-41440.)

Добавьте новую функцию os.eventfd() и связанных с ней помощников, чтобы обернуть системный вызов eventfd2 в Linux. (Автор Кристиан Хеймс в статье bpo-41001).

Добавьте os.splice(), который позволяет перемещать данные между двумя файловыми дескрипторами без копирования между адресным пространством ядра и адресным пространством пользователя, где один из файловых дескрипторов должен ссылаться на канал. (Добавлено Пабло Галиндо в bpo-41625.)

Добавьте O_EVTONLY, O_FSYNC, O_SYMLINK и O_NOFOLLOW_ANY для mac OS. (Добавлено Донхи На в bpo-43106.)

os.путь¶

os.path.realpath() теперь принимает аргумент strict, содержащий только ключевое слово. При значении True, OSError вызывается, если путь не существует или встречается цикл символических ссылок. (Автор - Барни Гейл в bpo-43757.)

файл пути¶

Добавьте поддержку фрагментов в PurePath.parents. (Автор Джошуа Кэннон в bpo-35498.)

Добавьте поддержку отрицательной индексации в PurePath.parents. (Добавлено Ярославом Панковичем в bpo-21041.)

Добавьте метод Path.hardlink_to, который заменяет link_to(). Новый метод имеет тот же порядок аргументов, что и symlink_to(). (Добавлено Барни Гейлом в bpo-39950.)

pathlib.Path.stat() и chmod() теперь принимают аргумент follow_symlinks, содержащий только ключевое слово, для согласованности с соответствующими функциями в модуле os. (Автор - Барни Гейл в bpo-39906.)

платформа¶

Добавьте platform.freedesktop_os_release(), чтобы получить идентификатор операционной системы из стандартного файла freedesktop.org os-release. (Добавлено Кристианом Хеймсом в статье bpo-28468.)

печать¶

pprint.pprint() теперь принимает новый аргумент ключевого слова underscore_numbers. ((Добавлено sblondon в bpo-42914.)

pprint теперь можно красиво печатать dataclasses.dataclass экземпляров. (Добавлено Льюисом Гаулом в bpo-43080.)

py_compile скомпилировать¶

Добавьте опцию --quiet в интерфейс командной строки py_compile. (Добавлено Григорием Шевченко в bpo-38731.)

пиклбр¶

Добавьте атрибут end_lineno к объектам Function и Class в дереве, возвращаемом pyclbr.readmodule() и pyclbr.readmodule_ex(). Он соответствует существующему (начало) lineno. (Добавлено Авиралом Шриваставой в bpo-38307.)

откладывать в долгий ящик¶

Модуль shelve теперь использует pickle.DEFAULT_PROTOCOL по умолчанию вместо pickle протокола 3 при создании полок. (Добавлено Закери Спитцем в bpo-34204.)

статистика¶

correlation(), and linear_regression() simple bpo-38490 < < < 2>>> functions. (Contributed by Тимофей Володько in < < < 3>>>.)

site¶

Если модуль не определяет __loader__, вернитесь к __spec__.loader. (Добавлено Бреттом Кэнноном в bpo-42133.)

socket¶

Исключением socket.timeout теперь является псевдоним TimeoutError. (Добавлено Кристианом Хеймсом в bpo-42413.)

Добавлена возможность создавать сокеты MPTCP с помощью IPPROTO_MPTCP (добавлено Руи Куньей в bpo-43571).

Добавьте опцию IP_RECVTOS для получения полей типа услуги (ToS) или DSCP/ECN (добавлено Георгом Саутхоффом в bpo-44077).

протокол ssl¶

Для модуля ssl требуется OpenSSL версии 1.1.1 или новее. (Автор: Кристиан Хеймс в PEP 644 и bpo-43669.)

Модуль ssl предварительно поддерживает OpenSSL 3.0.0 и новую опцию OP_IGNORE_UNEXPECTED_EOF. (Предоставлено Кристианом Хеймсом в bpo-38820, bpo-43794, bpo-43788, bpo-43791, bpo-43799, bpo-43920, bpo-43789, и bpo-43811.)

Устаревшая функция и использование устаревших констант теперь приводят к появлению DeprecationWarning. ssl.SSLContext.options имеет значения OP_NO_SSLv2 и OP_NO_SSLv3, установленные по умолчанию, и поэтому не может предупреждать о повторной установке флага. В deprecation section есть список устаревших функций. (Добавлено Кристианом Хеймсом в bpo-43880.)

Модуль ssl теперь имеет более безопасные настройки по умолчанию. Шифры без прямой секретности или SHA-1 MAC по умолчанию отключены. Уровень безопасности 2 запрещает использование слабых ключей RSA, DH и ECC с уровнем защиты менее 112 бит. SSLContext По умолчанию используется минимальная версия протокола TLS 1.2. Настройки основаны на исследованиях Хайнека Шлавака. (Автор: Кристиан Хеймс в bpo-43998.)

Устаревшие протоколы SSL 3.0, TLS 1.0 и TLS 1.1 больше официально не поддерживаются. Python не блокирует их активно. Однако параметры сборки OpenSSL, конфигурации дистрибутивов, исправления поставщиков и наборы шифров могут препятствовать успешному установлению связи.

Добавьте параметр timeout в функцию ssl.get_server_certificate(). (Добавлено Закери Спитцем в bpo-31870.)

Модуль ssl использует типы кучи и многоэтапную инициализацию. (Автор: Кристиан Хеймс в bpo-42333.)

Добавлен новый флаг проверки VERIFY_X509_PARTIAL_CHAIN. (Добавлено l0x в bpo-40849.)

sqlite3¶

Добавьте события аудита для connect/handle(), enable_load_extension(), и load_extension(). (Добавлено Эрлендом Э. Аасландом в bpo-43762.)

sys¶

Добавьте атрибут sys.orig_argv: список исходных аргументов командной строки, передаваемых исполняемому файлу Python. (Добавлено Виктором Стиннером в bpo-23427.)

Добавьте sys.stdlib_module_names, содержащий список имен модулей стандартной библиотеки. (Добавлено Виктором Стиннером в bpo-42955.)

_поток¶

_thread.interrupt_main() теперь для имитации используется необязательный номер сигнала (по умолчанию по-прежнему используется signal.SIGINT). (Добавлено Антуаном Питру в bpo-43356.)

нарезание резьбы¶

Добавьте threading.gettrace() и threading.getprofile(), чтобы получить функции, заданные threading.settrace() и threading.setprofile() соответственно. (Добавлено Марио Корчеро в bpo-42251.)

Добавьте threading.__excepthook__, чтобы можно было восстановить исходное значение threading.excepthook() в случае, если для него установлено неправильное или другое значение. (Добавлено Марио Корчеро в bpo-42308.)

обратная связь¶

Функции format_exception(), format_exception_only(), и print_exception() теперь могут принимать объект exception в качестве позиционного аргумента. (Материалы предоставлены Закери Спитцем и Маттиасом Буссонье в bpo-26389.)

типы¶

Повторно ввести классы types.EllipsisType, types.NoneType и types.NotImplementedType, предоставив новый набор типов, легко интерпретируемых средствами проверки типов. (Автор Бас ван Бик в bpo-41810).

печатание¶

Основные изменения приведены в разделе Новые функции, связанные с подсказками по набору текста.

Поведение typing.Literal было изменено, чтобы соответствовать PEP 586 и соответствовать поведению средств проверки статических типов, указанных в PEP.

1. Literal теперь удаляем дублирование параметров.

2. Сравнение на равенство между объектами Literal теперь не зависит от порядка.

3. Literal при сравнении теперь учитываются типы. Например, Literal[0] == Literal[False] ранее оценивалось как True. Теперь это False. Чтобы поддержать это изменение, внутренний кэш типов теперь поддерживает дифференциацию типов.

4. Literal объекты теперь будут генерировать исключение TypeError во время сравнения на равенство, если какой-либо из их параметров не соответствует hashable. Обратите внимание, что объявление Literal с параметрами, которые нельзя хэшировать, не приведет к ошибке:

   >>> from typing import Literal
   >>> Literal[{0}]
   >>> Literal[{0}] == Literal[{False}]
   Traceback (most recent call last):
     File "<stdin>", line 1, in <module>
   TypeError: unhashable type: 'set'
   

(Автор: Юрий Карабас в статье bpo-42345.)

Добавьте новую функцию typing.is_typeddict() для самоанализа, если аннотация является typing.TypedDict. (Добавлено Патриком Ридером в bpo-41792.)

Подклассы typing.Protocol, в которых объявлены только переменные данных, теперь будут выдавать значение TypeError при проверке с помощью isinstance, если только они не оформлены с помощью runtime_checkable(). Ранее эти проверки выполнялись автоматически. Пользователи должны оформлять свои подклассы с помощью runtime_checkable() декоратора, если им нужны протоколы времени выполнения. (Автор Юрий Карабас в bpo-38908).

При импорте из подмодулей typing.io и typing.re теперь будет генерироваться DeprecationWarning. Эти подмодули устарели начиная с версии Python 3.8 и будут удалены в будущих версиях Python. Все, что относится к этим подмодулям, должно быть импортировано непосредственно из typing. (Добавлено Себастьяном Риттау в bpo-38291.)

единичный тест¶

Добавьте новый метод assertNoLogs() в дополнение к существующему assertLogs(). (Автор Кит Ян Чой в bpo-39385.)

urllib.синтаксический анализ¶

Версии Python, более ранние, чем Python 3.10, позволяли использовать как ;, так и & в качестве разделителей параметров запроса в urllib.parse.parse_qs() и urllib.parse.parse_qsl(). Из соображений безопасности и в соответствии с новыми рекомендациями W3C это было изменено, чтобы разрешить использование только одного разделительного ключа с & по умолчанию. Это изменение также затрагивает cgi.parse() и cgi.parse_multipart(), поскольку они используют затронутые функции внутри системы. Для получения более подробной информации, пожалуйста, ознакомьтесь с соответствующей документацией. (Материалы предоставлены Адамом Гольдшмидтом, Сентилом Кумараном и Кеном Джином в bpo-42967.)

Наличие символов новой строки или табуляции в некоторых частях URL-адреса допускает некоторые формы атак. В соответствии со спецификацией WHATWG, которая обновляет RFC 3986, символы новой строки ASCII \n, \r и табуляции \t удаляются из URL-адреса синтаксическим анализатором в urllib.parse для предотвращения подобных атак. Удаляемые символы управляются новой переменной уровня модуля urllib.parse._UNSAFE_URL_BYTES_TO_REMOVE. (Смотрите gh-88048)

xml-код¶

Добавьте класс LexicalHandler в модуль xml.sax.handler. (Авторы Джонатан Госсейдж и Закери Спитц в статье bpo-35018).

почтовый импорт¶

Добавьте методы, связанные с PEP 451: find_spec(), zipimport.zipimporter.create_module(), и zipimport.zipimporter.exec_module(). (Автор Бретт Кэннон в bpo-42131.)

Добавьте метод invalidate_caches(). (Добавлено Десмондом Чонгом в bpo-14678.)

Изменения в синтаксисе Python¶

• Предупреждение об устаревании теперь выдается при компиляции ранее допустимого синтаксиса, если за числовым литералом сразу следует ключевое слово (как в 0in x). В будущих версиях оно будет изменено на синтаксическое предупреждение и, наконец, на синтаксическую ошибку. Чтобы избавиться от предупреждения и сделать код совместимым с будущими версиями, просто добавьте пробел между числовым символом и следующим ключевым словом. (Автор Сергей Сторчака в bpo-43833.)

Изменения в Python API¶

• Параметры etype функций format_exception(), format_exception_only(), и print_exception() в модуле traceback были переименованы в exc. (Материалы предоставлены Закери Спитцем и Маттиасом Буссонье в bpo-26389.)

• atexit: При выходе из Python, если обратный вызов, зарегистрированный с помощью atexit.register(), завершается ошибкой, его исключение регистрируется в журнале. Ранее регистрировались только некоторые исключения, а последнее исключение всегда автоматически игнорировалось. (Автор: Виктор Стиннер в статье bpo-42639.)

• collections.abc.Callable generic теперь сглаживает параметры типа, аналогично тому, что в настоящее время делает typing.Callable. Это означает, что в collections.abc.Callable[[int, str], str] будет __args__ из (int, str, str); ранее это было ([int, str], str). Код, который обращается к аргументам через typing.get_args() или __args__, должен учитывать это изменение. Кроме того, TypeError может быть вызвано для недопустимых форм параметризации collections.abc.Callable, которые, возможно, были пропущены в Python 3.9. (Добавлено Кеном Джином в bpo-42195.)

• socket.htons() и socket.ntohs() теперь увеличивают OverflowError вместо DeprecationWarning, если данный параметр не помещается в 16-разрядное целое число без знака. (Автор: Эрленд Э. Аасланд в bpo-42393.)

• Параметр loop был удален из большинства параметров asyncio high-level API после выхода из употребления в Python 3.8.

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

  async def foo(loop):
      await asyncio.sleep(1, loop=loop)
  

  Следует заменить на этот:

  async def foo():
      await asyncio.sleep(1)
  

  Если foo() был специально разработан не для запуска в цикле обработки событий текущего потока (например, для запуска в цикле обработки событий другого потока), рассмотрите возможность использования asyncio.run_coroutine_threadsafe() вместо этого.

  (Авторы: Юрий Карабас, Эндрю Светлов, Юрий Селиванов и Кайл Стэнли в bpo-42392.)

• Конструктор types.FunctionType теперь наследует текущие здания, если в словаре globals нет ключа "__builtins__", вместо того, чтобы использовать {"None": None} в качестве встроенных элементов: то же поведение, что и в eval() и exec() функции. На определение функции с помощью def function(...): ... в Python это не влияет, глобальные переменные не могут быть переопределены с помощью этого синтаксиса: он также наследует текущие встроенные функции. (Добавлено Виктором Стиннером в bpo-42990.)

Изменения в C API¶

• Функции C API PyParser_SimpleParseStringFlags, PyParser_SimpleParseStringFlagsFilename, PyParser_SimpleParseFileFlags, PyNode_Compile и тип, используемый этими функциями, struct _node, были удалены в связи с переходом на новый синтаксический анализатор PEG.

  Теперь исходный код должен быть скомпилирован непосредственно в объект кода, используя, например, Py_CompileString(). Затем результирующий объект кода может быть вычислен, используя, например, PyEval_EvalCode().

  Конкретно:

  • Вызов PyParser_SimpleParseStringFlags, за которым следует PyNode_Compile, может быть заменен вызовом Py_CompileString().

  • Прямой замены для PyParser_SimpleParseFileFlags не существует. Чтобы скомпилировать код из аргумента FILE *, вам нужно будет прочитать файл на C и передать полученный буфер в Py_CompileString().

  • Чтобы скомпилировать файл с именем char *, явно откройте файл, прочитайте его и скомпилируйте результат. Один из способов сделать это - использовать модуль io с PyImport_ImportModule(), PyObject_CallMethod(), PyBytes_AsString() и Py_CompileString(), как набросок приведен ниже. (Объявления и обработка ошибок опущены.)

    io_module = Import_ImportModule("io");
    fileobject = PyObject_CallMethod(io_module, "open", "ss", filename, "rb");
    source_bytes_object = PyObject_CallMethod(fileobject, "read", "");
    result = PyObject_CallMethod(fileobject, "close", "");
    source_buf = PyBytes_AsString(source_bytes_object);
    code = Py_CompileString(source_buf, filename, Py_file_input);
    

  • Для объектов FrameObject элемент f_lasti теперь представляет собой смещение кода слова вместо простого смещения в строке байт-кода. Это означает, что это число необходимо умножить на 2, чтобы использовать его с API, которые вместо этого ожидают смещения в байтах (например, c:func:PyCode_Addr2Line). Обратите также внимание, что f_lasti элемент FrameObject объектов не считается стабильным: пожалуйста, используйте вместо него PyFrame_GetLineNumber().

PEP 652: Поддержание стабильного ABI¶

Теперь явно определен стабильный ABI (двоичный интерфейс приложения) для модулей расширения или встраивания Python. Стабильность C API описаны гарантии стабильности C API и ABI, а также рекомендации по использованию стабильного ABI.

(Автор - Петр Викторин в PEP 652 и bpo-43795.)

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

• Результат PyNumber_Index() теперь всегда имеет точный тип int. Ранее результатом мог быть экземпляр подкласса int. (Автор - Сергей Сторчака в bpo-40792.)

• Добавьте новый элемент orig_argv в структуру PyConfig: список исходных аргументов командной строки, передаваемых исполняемому файлу Python. (Добавлено Виктором Стиннером в bpo-23427.)

• Добавлены макросы PyDateTime_DATE_GET_TZINFO() и PyDateTime_TIME_GET_TZINFO() для доступа к атрибутам tzinfo объектов datetime.datetime и datetime.time. (Автор: Закери Спитц в bpo-30155.)

• Добавьте функцию PyCodec_Unregister(), чтобы отменить регистрацию функции поиска кодеков. (Добавлено Хай Ши в bpo-41842.)

• Добавлена функция PyIter_Send(), позволяющая отправлять значение в итератор, не вызывая исключения StopIteration. (Добавлено Владимиром Матвеевым в bpo-41756.)

• Добавьте PyUnicode_AsUTF8AndSize() в ограниченный C API. (Добавлено Алексом Гейнором в bpo-41784.)

• Добавьте PyModule_AddObjectRef() функция: аналогична:c:func:PyModule_AddObject, но не воруйте ссылку на значение успеха. (Добавлено Виктором Стиннером в bpo-1635741.)

• Добавьте функции Py_NewRef() и Py_XNewRef(), чтобы увеличить количество ссылок на объект и вернуть сам объект. (Автор Виктор Стиннер в bpo-42262.)

• Функции PyType_FromSpecWithBases() и PyType_FromModuleAndSpec() теперь принимают один класс в качестве аргумента bases. (Добавлено Сергеем Сторчакой в bpo-42423.)

• Функция PyType_FromModuleAndSpec() теперь принимает нулевой интервал tp_doc. (Добавлено Хай Ши в bpo-41832.)

• Функция PyType_GetSlot() может принимать static types. (Добавлено Хай Ши и Петром Викториным в bpo-41073.)

• Добавьте новую функцию PySet_CheckExact() в C-API, чтобы проверить, является ли объект экземпляром set, но не экземпляром подтипа. (Добавлено Пабло Галиндо в bpo-43277.)

• Добавьте PyErr_SetInterruptEx(), который позволяет передавать номер сигнала для имитации. (Добавлено Антуаном Питру в bpo-43356.)

• Ограниченный C API теперь поддерживается, если Python is built in debug mode (если определен макрос Py_DEBUG). В ограниченном C API функции Py_INCREF() и Py_DECREF() теперь реализованы как вызовы непрозрачных функций, вместо прямого доступа к элементу PyObject.ob_refcnt, если Python собран в режиме отладки и функции Py_LIMITED_API макрос предназначен для Python версии 3.10 или новее. Стало возможным поддерживать ограниченный C API в режиме отладки, потому что структура PyObject одинакова в режиме выпуска и отладки, начиная с версии Python 3.8 (см. bpo-36465).

  Ограниченный C API по-прежнему не поддерживается в специальной сборке --with-trace-refs (макрос Py_TRACE_REFS). (Добавлено Виктором Стиннером в bpo-43688.)

• Добавьте функцию Py_Is(x, y), чтобы проверить, является ли объект x объектом y, аналогично x is y в Python. Добавьте также функции Py_IsNone(), Py_IsTrue(), Py_IsFalse(), чтобы проверить, является ли объект, соответственно, None синглтоном, True синглтон или False синглтон. (Автор: Виктор Стиннер в bpo-43753.)

• Добавьте новые функции для управления сборщиком мусора из кода на C: PyGC_Enable(), PyGC_Disable(), PyGC_IsEnabled(). Эти функции позволяют активировать, деактивировать и запрашивать состояние сборщика мусора из кода на C без необходимости импорта модуля gc.

• Добавьте новый флаг типа Py_TPFLAGS_DISALLOW_INSTANTIATION, чтобы запретить создание экземпляров типа. (Автор Виктор Стиннер в bpo-43916.)

• Добавьте новый флаг типа:c:macro:Py_TPFLAGS_IMMUTABLETYPE для создания объектов неизменяемого типа: атрибуты типа нельзя ни устанавливать, ни удалять. (Авторы: Виктор Стиннер и Эрленд Э. Аасланд в bpo-43908.)

Перенос на Python 3.10¶

• Теперь необходимо определить макрос PY_SSIZE_T_CLEAN для использования форматов PyArg_ParseTuple() и Py_BuildValue(), которые используют #: es#, et#, s#, u#, y#, z#, U# и Z#. Смотрите Анализ аргументов и построение значений и PEP 353. (Автор Виктор Стиннер в bpo-40943.)

• Поскольку Py_REFCNT() заменен на встроенную статическую функцию, Py_REFCNT(obj) = new_refcnt необходимо заменить на Py_SET_REFCNT(obj, new_refcnt): смотрите Py_SET_REFCNT() (доступно начиная с версии Python 3.9). Для обеспечения обратной совместимости можно использовать этот макрос:

  #if PY_VERSION_HEX < 0x030900A4
  #  define Py_SET_REFCNT(obj, refcnt) ((Py_REFCNT(obj) = (refcnt)), (void)0)
  #endif
  

  (Автор: Виктор Стиннер в bpo-39573.)

• Вызов PyDict_GetItem() без удержания GIL был разрешен по историческим причинам. Это больше не разрешено. (Добавлено Виктором Стиннером в bpo-40839.)

• PyUnicode_FromUnicode(NULL, size) и PyUnicode_FromStringAndSize(NULL, size) теперь поднимают DeprecationWarning. Используйте PyUnicode_New(), чтобы выделить объект в Юникоде без исходных данных. (Добавлено Инадой Наоки в bpo-36346.)

• Частная структура _PyUnicode_Name_CAPI API PyCapsule unicodedata.ucnhash_CAPI была перенесена во внутренний C API. (Добавлено Виктором Стиннером в bpo-42157).

• Py_GetPath(), Py_GetPrefix(), Py_GetExecPrefix(), Py_GetProgramFullPath(), Py_GetPythonHome() и Py_GetProgramName() функции теперь верните NULL, если вызывалось ранее Py_Initialize() (до инициализации Python). Используйте новый Конфигурация инициализации Python API, чтобы получить Конфигурация пути Python. (Автор Виктор Стиннер в bpo-42260.)

• Макросы PyList_SET_ITEM(), PyTuple_SET_ITEM() и PyCell_SET() больше нельзя использовать в качестве lvalue или r-значения. Например, x = PyList_SET_ITEM(a, b, c) и PyList_SET_ITEM(a, b, c) = x теперь завершаются ошибкой компилятора. Это предотвращает ошибки, подобные if (PyList_SET_ITEM (a, b, c) < 0) ... test. (Материалы предоставлены Закери Спитцем и Виктором Стиннером в bpo-30459.)

• Неограниченные файлы API odictobject.h, parser_interface.h, picklebufobject.h, pyarena.h, pyctype.h, pydebug.h, pyfpe.h и pytime.h были перемещены в каталог Include/cpython. Эти файлы не должны включаться напрямую, поскольку они уже включены в Python.h; см. Включаемые файлы. Если они были включены напрямую, рассмотрите возможность включения вместо них Python.h. (Автор: Николас Сим в bpo-35134.)

• Используйте флаг типа Py_TPFLAGS_IMMUTABLETYPE для создания объектов неизменяемого типа. Не полагайтесь на Py_TPFLAGS_HEAPTYPE, чтобы определить, является ли объект изменяемым; проверьте, установлен ли вместо этого Py_TPFLAGS_IMMUTABLETYPE. (Материалы предоставлены Виктором Стиннером и Эрлендом Э. Аасландом в bpo-43908.)

• Недокументированная функция Py_FrozenMain была удалена из ограниченного API. Эта функция в основном полезна для пользовательских сборок Python. (Добавлено Петром Викториным в bpo-26241).

Осуждаемый¶

• Функция PyUnicode_InternImmortal() теперь признана устаревшей и будет удалена в Python 3.12: вместо нее используйте PyUnicode_InternInPlace(). (Автор: Виктор Стиннер в bpo-41692.)

Удаленный¶

• Удалены функции Py_UNICODE_str*, манипулирующие строками Py_UNICODE*. (Добавлено Инадой Наоки в bpo-41123.)

  • Py_UNICODE_strlen: используйте PyUnicode_GetLength() или PyUnicode_GET_LENGTH

  • Py_UNICODE_strcat: используйте PyUnicode_CopyCharacters() или PyUnicode_FromFormat()

  • Py_UNICODE_strcpy, Py_UNICODE_strncpy: используйте PyUnicode_CopyCharacters() или PyUnicode_Substring()

  • Py_UNICODE_strcmp: используйте PyUnicode_Compare()

  • Py_UNICODE_strncmp: используйте PyUnicode_Tailmatch()

  • Py_UNICODE_strchr, Py_UNICODE_strrchr: используйте PyUnicode_FindChar()

• Удалено PyUnicode_GetMax(). Пожалуйста, перейдите на новый (PEP 393) API. (Добавлено Инадой Наоки в bpo-41103.)

• Удалено PyLong_FromUnicode(). Пожалуйста, перенесите на:c:func:PyLong_FromUnicodeObject. (Добавлено Инадой Наоки в bpo-41103.)

• Удалено PyUnicode_AsUnicodeCopy(). Пожалуйста, используйте : c:func:PyUnicode_AsUCS4Copy или PyUnicode_AsWideCharString() (Добавлено Инадой Наоки в bpo-41103.)

• Удалена переменная _Py_CheckRecursionLimit: она заменена на ceval.recursion_limit из структуры PyInterpreterState. (Добавлено Виктором Стиннером в bpo-41834.)

• Удалены недокументированные макросы Py_ALLOW_RECURSION и Py_END_ALLOW_RECURSION, а также поле recursion_critical структуры PyInterpreterState. (Автор - Сергей Сторчака в bpo-41936.)

• Удалена недокументированная функция PyOS_InitInterrupts(). При инициализации Python уже неявно устанавливаются обработчики сигналов: см. : c:member:PyConfig.install_signal_handlers. (Добавлено Виктором Стиннером в bpo-41713.)

• Удалите функцию PyAST_Validate(). Больше невозможно создавать объект AST (тип mod_ty) с помощью общедоступного C API. Функция уже была исключена из ограниченного CAPI (PEP 384). (Автор: Виктор Стиннер в статье bpo-43244.)

• Удалите заголовочный файл symtable.h и недокументированные функции:

  • PyST_GetScope()

  • PySymtable_Build()

  • PySymtable_BuildObject()

  • PySymtable_Free()

  • Py_SymtableString()

  • Py_SymtableStringObject()

  Функция Py_SymtableString() по ошибке была включена в стабильный ABI, но ее нельзя было использовать, поскольку заголовочный файл symtable.h был исключен из ограниченного C API.

  Вместо этого используйте модуль Python symtable. (Добавлено Виктором Стиннером в bpo-43244.)

• Удалите PyOS_ReadlineFunctionPointer() из ограниченных заголовков C API и из python3.dll, библиотеки, которая обеспечивает стабильный ABI в Windows. Поскольку функция принимает аргумент FILE*, стабильность ABI не может быть гарантирована. (Автор: Петр Викторин в статье bpo-43868.)

• Удалите файлы заголовков ast.h, asdl.h, и Python-ast.h. Эти функции не были задокументированы и исключены из ограниченного CAPI. Большинство имен, определенных этими заголовочными файлами, не имели префикса Py и поэтому могли создавать конфликты имен. Например, Python-ast.h определил макрос Yield, который конфликтовал с именем Yield, используемым в заголовке Windows <winbase.h>. Вместо этого используйте модуль Python ast. (Автор: Виктор Стиннер в bpo-43244.)

• Удалите функции компилятора и синтаксического анализатора, используя тип struct _mod, поскольку общедоступный AST C API был удален:

  • PyAST_Compile()

  • PyAST_CompileEx()

  • PyAST_CompileObject()

  • PyFuture_FromAST()

  • PyFuture_FromASTObject()

  • PyParser_ASTFromFile()

  • PyParser_ASTFromFileObject()

  • PyParser_ASTFromFilename()

  • PyParser_ASTFromString()

  • PyParser_ASTFromStringObject()

  Эти функции не были задокументированы и были исключены из ограниченного CAPI. (Автор Виктор Стиннер в статье bpo-43244).

• Удалите заголовочный файл pyarena.h с функциями:

  • PyArena_New()

  • PyArena_Free()

  • PyArena_Malloc()

  • PyArena_AddPyObject()

  Эти функции были недокументированы, исключены из ограниченного CAPI и использовались компилятором только для внутренних целей. (Автор: Виктор Стиннер в bpo-43244.)

• Элемент PyThreadState.use_tracing был удален для оптимизации Python. (Добавлено Марком Шенноном в bpo-43760.)

архивный файл¶

• Методы извлечения в tarfile и shutil.unpack_archive() имеют новый аргумент a filter, который позволяет ограничить возможности tar, которые могут быть неожиданными или опасными, например, создание файлов за пределами каталога назначения. Подробнее смотрите в Экстракционные фильтры. В Python 3.12 при использовании без аргумента filter будет отображаться DeprecationWarning. В Python 3.14 значение по умолчанию будет изменено на 'data'. (Автор: Петр Викторин в PEP 706.)