Что нового в Python 3.11¶What’s New In Python 3.11

PEP 657: Детализированное указание на ошибки в трассировках¶PEP 657: Fine-grained error locations in tracebacks

При выводе трассировки интерпретатор теперь указывает на точное выражение, которое вызвало ошибку, а не просто на строку. Например:

Traceback (most recent call last):
  File "distance.py", line 11, in <module>
    print(manhattan_distance(p1, p2))
          ^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "distance.py", line 6, in manhattan_distance
    return abs(point_1.x - point_2.x) + abs(point_1.y - point_2.y)
                           ^^^^^^^^^
AttributeError: 'NoneType' object has no attribute 'x'

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

Traceback (most recent call last):
  File "query.py", line 37, in <module>
    magic_arithmetic('foo')
  File "query.py", line 18, in magic_arithmetic
    return add_counts(x) / 25
           ^^^^^^^^^^^^^
  File "query.py", line 24, in add_counts
    return 25 + query_user(user1) + query_user(user2)
                ^^^^^^^^^^^^^^^^^
  File "query.py", line 32, in query_user
    return 1 + query_count(db, response['a']['b']['c']['user'], retry=True)
                               ~~~~~~~~~~~~~~~~~~^^^^^
TypeError: 'NoneType' object is not subscriptable

А также сложные арифметические выражения:

Traceback (most recent call last):
  File "calculation.py", line 54, in <module>
    result = (x / y / z) * (a / b / c)
              ~~~~~~^~~
ZeroDivisionError: division by zero

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

• Метод codeobject.co_positions() в Python.

• Функция PyCode_Addr2Location() в C API.

См. PEP 657 для получения более подробной информации. (Авторы: Pablo Galindo, Batuhan Taskaya и Ammar Askar в bpo-43950.)

PEP 654: Группы исключений и except*¶PEP 654: Exception Groups and except*

PEP 654 вводит языковые возможности, которые позволяют программе возбуждать и обрабатывать несколько не связанных исключений одновременно. Встроенные типы ExceptionGroup и BaseExceptionGroup позволяют группировать исключения и возбуждать их вместе, а новый синтаксис except* обобщает except для сопоставления подгрупп групп исключений.

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

(Автор: Irit Katriel в bpo-45292. PEP написан Irit Katriel, Yury Selivanov и Guido van Rossum.)

PEP 678: Исключения можно обогащать примечаниями¶PEP 678: Exceptions can be enriched with notes

Метод add_note() добавлен в BaseException. Его можно использовать для обогащения исключений контекстной информацией, которая недоступна в момент возбуждения исключения. Добавленные примечания отображаются в стандартной трассировке.

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

(Автор: Irit Katriel в bpo-45607. PEP написан Zac Hatfield-Dodds.)

Улучшения py.exe лаунчера Windows¶Windows py.exe launcher improvements

Копия менеджера установки Python, включенная в Python 3.11, была значительно обновлена. Теперь он поддерживает синтаксис company/tag, как определено в PEP 514, с использованием аргумента -V:<company>/<tag> вместо ограниченного -<major>.<minor>. Это позволяет запускать дистрибутивы, отличные от PythonCore, того, который размещен на python.org.

При использовании селекторов -V: можно опустить либо компанию, либо тег, но будут сканироваться все установки. Например, -V:OtherPython/ выберет «лучший» тег, зарегистрированный для OtherPython, в то время как -V:3.11 или -V:/3.11 выберут «лучший» дистрибутив с тегом 3.11.

При использовании устаревших аргументов -<major>, -<major>.<minor>, -<major>-<bitness> или -<major>.<minor>-<bitness> все существующее поведение должно сохраняться из прошлых версий, и будут выбраны только выпуски с PythonCore. Однако суффикс -64 теперь означает «не 32-битный» (не обязательно x86-64), поскольку существует несколько поддерживаемых 64-битных платформ. 32-битные среды выполнения определяются путем проверки тега среды выполнения на наличие суффикса -32. Все выпуски Python начиная с 3.5 включали это в свои 32-битные сборки.

PEP 646: Вариативные дженерики¶PEP 646: Variadic generics

PEP 484 ранее представил TypeVar, позволяющий создание дженериков, параметризованных одним типом. PEP 646 добавляет TypeVarTuple, позволяющий параметризацию произвольным количеством типов. Другими словами, TypeVarTuple – это вариативная переменная типа, что позволяет использовать вариативные дженерики.

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

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

(Автор: Matthew Rahtz в bpo-43224, с участием Serhiy Storchaka и Jelle Zijlstra. PEP написан Mark Mendoza, Matthew Rahtz, Pradeep Kumar Srinivasan и Vincent Siles.)

PEP 655: Маркировка отдельных элементов TypedDict как обязательных или необязательных¶PEP 655: Marking individual TypedDict items as required or not-required

Required и NotRequired предоставляют простой способ отметить, должны ли отдельные элементы в TypedDict присутствовать. Ранее это было возможно только с использованием наследования.

Все поля по-прежнему обязательны по умолчанию, если только параметр total не установлен в False, в этом случае все поля по-прежнему необязательны по умолчанию. Например, следующее определяет TypedDict с одним обязательным и одним необязательным ключом:

class Movie(TypedDict):
   title: str
   year: NotRequired[int]

m1: Movie = {"title": "Black Panther", "year": 2018}  # ОК
m2: Movie = {"title": "Star Wars"}  # OK (год не обязателен)
m3: Movie = {"year": 2022}  # ОШИБКА (отсутствует обязательное поле title)

Следующее определение эквивалентно:

class Movie(TypedDict, total=False):
   title: Required[str]
   year: int

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

(Авторы: David Foster и Jelle Zijlstra в bpo-47087. PEP написан David Foster.)

PEP 673: Self тип¶PEP 673: Self type

Новая аннотация Self предоставляет простой и интуитивно понятный способ аннотировать методы, возвращающие экземпляр своего класса. Она ведёт себя так же, как подход на основе TypeVar, описанный в PEP 484, но более лаконична и понятна.

Типичные случаи использования включают альтернативные конструкторы, предоставляемые как classmethod, и методы __enter__(), возвращающие self:

class MyLock:
    def __enter__(self) -> Self:
        self.lock()
        return self

    ...

class MyInt:
    @classmethod
    def fromhex(cls, s: str) -> Self:
        return cls(int(s, 16))

    ...

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

См. PEP 673 для получения дополнительных сведений.

(Предложено James Hilton-Balfe в bpo-46534. PEP написан Pradeep Kumar Srinivasan и James Hilton-Balfe.)

PEP 675: Произвольный строковый литеральный тип ¶PEP 675: Arbitrary literal string type

Новая аннотация LiteralString может использоваться для указания того, что параметр функции может быть любого строкового литерального типа. Это позволяет функции принимать произвольные строковые литеральные типы, а также строки, созданные из других строковых литералов. Тогда проверяющие типы могут гарантировать, что чувствительные функции, такие как выполняющие SQL-запросы или команды оболочки, вызываются только со статическими аргументами, обеспечивая защиту от атак внедрения.

Например, функцию SQL-запроса можно аннотировать следующим образом:

def run_query(sql: LiteralString) -> ...
    ...

def caller(
    arbitrary_string: str,
    query_string: LiteralString,
    table_name: LiteralString,
) -> None:
    run_query("SELECT * FROM students")       # ok
    run_query(query_string)                   # ok
    run_query("SELECT * FROM " + table_name)  # ok
    run_query(arbitrary_string)               # ошибка проверки типов
    run_query(                                # ошибка проверки типов
        f"SELECT * FROM students WHERE name = {arbitrary_string}"
    )

Подробнее см. PEP 675.

(Предложено Jelle Zijlstra в bpo-47088. PEP написан Pradeep Kumar Srinivasan и Graham Bleaney.)

PEP 681: Преобразования классов данных ¶PEP 681: Data class transforms

dataclass_transform может использоваться для декорирования класса, метакласса или функции, которая сама является декоратором. Наличие @dataclass_transform() сообщает статическому проверяющему типов, что декорированный объект выполняет «магию» времени выполнения, преобразующую класс и придающую ему поведение, похожее на dataclass.

Например:

# Декоратор create_model определён в библиотеке.
@typing.dataclass_transform()
def create_model(cls: Type[T]) -> Type[T]:
    cls.__init__ = ...
    cls.__eq__ = ...
    cls.__ne__ = ...
    return cls

# Теперь с помощью декоратора create_model можно создавать новые классы моделей:
@create_model
class CustomerModel:
    id: int
    name: str

c = CustomerModel(id=327, name="Eric Idle")

Подробнее см. PEP 681.

(Предложено Jelle Zijlstra в gh-91860. PEP написан Erik De Bonte и Eric Traut.)

PEP 563 может и не быть будущим ¶PEP 563 may not be the future

PEP 563 Отложенная оценка аннотаций (from __future__ import annotations future statement), которая изначально планировалась к выпуску в Python 3.10, отложена на неопределённый срок. См. это сообщение от Управляющего совета для получения дополнительной информации.

asyncio¶

• Добавлен класс TaskGroup, асинхронный контекстный менеджер, который содержит группу задач и ожидает завершения всех при выходе. Для нового кода рекомендуется использовать его вместо непосредственного использования create_task() и gather(). (Автор: Yury Selivanov и другие, gh-90908.)

• Добавлен timeout() – асинхронный контекстный менеджер для установки тайм-аута на асинхронные операции. Для нового кода рекомендуется использовать его вместо непосредственного использования wait_for(). (Автор: Andrew Svetlov, gh-90927.)

• Добавлен класс Runner, предоставляющий доступ к механизмам, используемым run(). (Автор: Andrew Svetlov, gh-91218.)

• В библиотеку asyncio добавлен класс Barrier к примитивам синхронизации, а также связанное с ним исключение BrokenBarrierError. (Авторы: Yves Duprat и Andrew Svetlov, gh-87518.)

• Добавлен именованный аргумент all_errors в функцию asyncio.loop.create_connection(), чтобы несколько ошибок соединения можно было возбудить как одно ExceptionGroup.

• Добавлен метод asyncio.StreamWriter.start_tls() для обновления существующих потоковых соединений до TLS. (Автор: Ian Good, bpo-34975.)

• В цикл событий добавлены функции для работы с сырыми датаграммными сокетами: sock_sendto(), sock_recvfrom() и sock_recvfrom_into(). Их реализации находятся в SelectorEventLoop и ProactorEventLoop. (Автор: Alex Grönholm, bpo-46805.)

• Добавлены методы cancelling() и uncancel() в Task. Они предназначены в первую очередь для внутреннего использования, в частности, TaskGroup.

contextlib¶

• Добавлен не потокобезопасный контекстный менеджер chdir() для смены текущего рабочего каталога с последующим восстановлением при выходе. Простая обёртка вокруг chdir(). (Автор: Filipe Laíns, bpo-25625)

dataclasses¶

• Изменена проверка мутабельности значений по умолчанию для полей: теперь допускаются только хешируемые значения вместо любого объекта, не являющегося экземпляром dict, list или set. (Автор: Eric V. Smith, bpo-44674.)

datetime¶

• Добавлен datetime.UTC – удобный псевдоним для datetime.timezone.utc. (Автор: Kabir Kwatra, gh-91973.)

• datetime.date.fromisoformat(), datetime.time.fromisoformat() и datetime.datetime.fromisoformat() теперь можно использовать для разбора большинства форматов ISO 8601 (за исключением тех, которые поддерживают дробные часы и минуты). (Автор: Paul Ganssle, gh-80010.)

enum¶

• Переименован EnumMeta в EnumType (EnumMeta оставлен как псевдоним).

• Добавлен StrEnum, с членами, которые могут (и должны) использоваться как строки.

• Добавлен ReprEnum, который изменяет только __repr__() членов, возвращая их буквальные значения (а не имена) для __str__() и __format__() (используется в str(), format() и f-строках).

• Изменено Enum.__format__() (значение по умолчанию для format(), str.format() и f-строк) – теперь оно всегда даёт тот же результат, что и Enum.__str__(): для перечислений, наследующих от ReprEnum, это будет значение члена; для всех остальных перечислений это будет имя перечисления и имя члена (например, Color.RED).

• Добавлен новый параметр класса boundary для перечислений Flag и перечисление FlagBoundary с его параметрами, чтобы управлять обработкой значений флагов, выходящих за пределы диапазона.

• Добавлены декоратор перечислений verify() и перечисление EnumCheck с его параметрами для проверки классов перечислений на соответствие нескольким конкретным ограничениям.

• Добавлены декораторы member() и nonmember(), чтобы гарантировать, что декорируемый объект преобразуется/не преобразуется в член перечисления.

• Добавлен декоратор property(), который работает как property(), но для перечислений. Используйте его вместо types.DynamicClassAttribute().

• Добавлен декоратор перечислений global_enum(), который изменяет __repr__() и __str__() так, чтобы отображать значения как члены их модуля, а не класса перечисления. Например, 're.ASCII' для члена ASCII из re.RegexFlag вместо 'RegexFlag.ASCII'.

• Улучшен Flag: теперь поддерживаются len(), итерация и in/not in по его членам. Например, теперь работает следующий код: len(AFlag(3)) == 2 and list(AFlag(3)) == (AFlag.ONE, AFlag.TWO)

• Изменены Enum и Flag: теперь члены определяются до вызова __init_subclass__(); dir() теперь включает методы и т.д. из примешанных типов данных.

• Изменено Flag: теперь только первичные значения (степени двойки) считаются каноническими, в то время как составные значения (3, 6, 10 и т.д.) считаются псевдонимами; инвертированные флаги приводятся к положительному эквиваленту.

fcntl¶

• На FreeBSD поддерживаются флаги F_DUP2FD и F_DUP2FD_CLOEXEC: первый эквивалентен использованию dup2, а второй, кроме того, устанавливает флаг FD_CLOEXEC.

fractions¶

• Support PEP 515-style initialization of Fraction from string. (Contributed by Sergey B Kirpichev in bpo-44258.)

• Теперь Fraction реализует метод __int__, благодаря чему проверка isinstance(some_fraction, typing.SupportsInt) успешно проходит. (Автор: Mark Dickinson, bpo-44547.)

functools¶

• Теперь functools.singledispatch() поддерживает types.UnionType и typing.Union в качестве аннотаций к аргументу dispatch.:

  >>> from functools import singledispatch
  >>> @singledispatch
  ... def fun(arg, verbose=False):
  ...     if verbose:
  ...         print("Let me just say,", end=" ")
  ...     print(arg)
  ...
  >>> @fun.register
  ... def _(arg: int | float, verbose=False):
  ...     if verbose:
  ...         print("Strength in numbers, eh?", end=" ")
  ...     print(arg)
  ...
  >>> from typing import Union
  >>> @fun.register
  ... def _(arg: Union[list, set], verbose=False):
  ...     if verbose:
  ...         print("Enumerate this:")
  ...     for i, elem in enumerate(arg):
  ...         print(i, elem)
  ...
  

  (Автор: Yurii Karabas, bpo-46014.)

gzip¶

• Функция gzip.compress() теперь работает быстрее при использовании аргумента mtime=0, так как она полностью делегирует сжатие единственной операции zlib.compress(). У этого изменения есть один побочный эффект: заголовок gzip-файла содержит байт «OS». Ранее модуль gzip всегда устанавливал в нём значение 255, означающее «неизвестно». Теперь при использовании compress() с mtime=0 это значение может быть другим, в зависимости от библиотеки zlib на C, с которой слинкован Python. (Подробнее о побочном эффекте см. gh-112346.)

hashlib¶

• hashlib.blake2b() и hashlib.blake2s() теперь предпочитают libb2 собственной копии Python. (Автор: Christian Heimes, bpo-47095.)

• Внутренний модуль _sha3 с алгоритмами SHA3 и SHAKE теперь использует tiny_sha3 вместо Keccak Code Package для уменьшения объёма кода и двоичного размера. Модуль hashlib предпочитает оптимизированные реализации SHA3 и SHAKE из OpenSSL. Изменение затрагивает только установки без поддержки OpenSSL. (Автор: Christian Heimes, bpo-47098.)

• Добавлена hashlib.file_digest() – вспомогательная функция для эффективного хеширования файлов или файлоподобных объектов. (Автор: Christian Heimes, gh-89313.)

IDLE and idlelib¶

• Применять подсветку синтаксиса для файлов .pyi. (Авторы: Alex Waygood и Terry Jan Reedy, bpo-45447.)

• Включение приглашений при сохранении содержимого Shell с вводом и выводом. (Автор: Terry Jan Reedy, gh-95191.)

inspect¶

• Добавлена getmembers_static() для возврата всех членов без запуска динамического поиска через протокол дескрипторов. (Автор: Weipeng Hong, bpo-30533.)

• Добавлена ismethodwrapper() для проверки, является ли тип объекта MethodWrapperType. (Автор: Hakan Çelik, bpo-29418.)

• Функции, связанные с фреймами, в модуле inspect изменены так, чтобы возвращать новые экземпляры классов FrameInfo и Traceback (обратно совместимые с предыдущими интерфейсами, подобными именованным кортежам), которые включают расширенную информацию о позиции PEP 657 (номер конечной строки, колонку и конечную колонку). Затронуты следующие функции:

  • inspect.getframeinfo()

  • inspect.getouterframes()

  • inspect.getinnerframes(),

  • inspect.stack()

  • inspect.trace()

  (Автор: Pablo Galindo, gh-88116.)

locale¶

• Добавлена locale.getencoding() для получения текущей кодировки локали. Она аналогична locale.getpreferredencoding(False), но игнорирует режим UTF-8 в Python.

logging¶

• Добавлена getLevelNamesMapping() для возврата отображения имён уровней логирования (например, 'CRITICAL') в значения соответствующих уровней логирования (например, 50 по умолчанию). (Автор: Andrei Kulakovin, gh-88024.)

• Добавлен метод createSocket() в SysLogHandler для соответствия SocketHandler.createSocket(). Он вызывается автоматически при инициализации обработчика и при отправке события, если нет активного сокета. (Автор: Kirill Pinchuk, gh-88457.)

math¶

• Добавлена math.exp2(): возвращает 2, возведённое в степень x. (Автор: Gideon Mitchell, bpo-45917.)

• Добавлена math.cbrt(): возвращает кубический корень из x. (Автор: Ajith Ramachandran, bpo-44357.)

• Поведение двух особых случаев math.pow() было изменено для соответствия спецификации IEEE 754. Операции math.pow(0.0, -math.inf) и math.pow(-0.0, -math.inf) теперь возвращают inf. Ранее они вызывали ValueError. (Автор: Mark Dickinson, bpo-44339.)

• Значение math.nan теперь всегда доступно. (Автор: Victor Stinner, bpo-46917.)

operator¶

• Добавлена новая функция operator.call, так что operator.call(obj, *args, **kwargs) == obj(*args, **kwargs). (Предложено Antony Lee в bpo-44019.)

os¶

• В Windows os.urandom() теперь использует BCryptGenRandom() вместо CryptGenRandom(), который устарел. (Предложено Donghee Na в bpo-44611.)

pathlib¶

• glob() и rglob() возвращают только каталоги, если pattern заканчивается разделителем компонентов пути: sep или altsep. (Предложено Eisuke Kawasima в bpo-22276 и bpo-33392.)

re¶

• Атомарные группы ((?>...)) и possessive-квантификаторы (*+, ++, ?+, {m,n}+) теперь поддерживаются в регулярных выражениях. (Предложено Jeffrey C. Jacobs и Serhiy Storchaka в bpo-433030.)

shutil¶

• Добавлен необязательный параметр dir_fd в shutil.rmtree(). (Предложено Serhiy Storchaka в bpo-46245.)

socket¶

• Добавлена поддержка CAN-сокетов для NetBSD. (Предложено Thomas Klausner в bpo-30512.)

• create_connection() имеет опцию, позволяющую в случае неудачи подключения возбуждать ExceptionGroup, содержащее все ошибки, вместо того чтобы возбуждать только последнюю. (Предложено Irit Katriel в bpo-29980.)

sqlite3¶

• Теперь можно отключить авторизатор, передав None в set_authorizer(). (Предложено Erlend E. Aasland в bpo-44491.)

• Имя collation create_collation() теперь может содержать любые символы Unicode. Имена collation с недопустимыми символами теперь возбуждают UnicodeEncodeError вместо sqlite3.ProgrammingError. (Предложено Erlend E. Aasland в bpo-44688.)

• Исключения sqlite3 теперь включают расширенный код ошибки SQLite как sqlite_errorcode и имя ошибки SQLite как sqlite_errorname. (Предложено Aviv Palivoda, Daniel Shahaf и Erlend E. Aasland в bpo-16379 и bpo-24139.)

• Добавлены setlimit() и getlimit() в sqlite3.Connection для установки и получения лимитов SQLite на уровне соединения. (Предложено Erlend E. Aasland в bpo-45243.)

• sqlite3 теперь устанавливает sqlite3.threadsafety на основе режима потоков по умолчанию, с которым скомпилирована базовая библиотека SQLite. (Предложено Erlend E. Aasland в bpo-45613.)

• C-колбэки sqlite3 теперь используют невыбрасываемые исключения, если включены трассировки колбэков. Пользователи теперь могут зарегистрировать unraisable hook handler для улучшения опыта отладки. (Предложено Erlend E. Aasland в bpo-45828.)

• Выборка при откате больше не возбуждает InterfaceError. Вместо этого мы передаём обработку этих случаев библиотеке SQLite. (Предложено Erlend E. Aasland в bpo-44092.)

• Добавлены serialize() и deserialize() в sqlite3.Connection для сериализации и десериализации баз данных. (Предложено Erlend E. Aasland в bpo-41930.)

• Добавлен create_window_function() в sqlite3.Connection для создания агрегатных оконных функций. (Предложено Erlend E. Aasland в bpo-34916.)

• Добавлен blobopen() в sqlite3.Connection. sqlite3.Blob позволяет выполнять инкрементальные операции ввода-вывода над BLOB-ами. (Предложено Aviv Palivoda и Erlend E. Aasland в bpo-24905.)

string¶

• Добавлены get_identifiers() и is_valid() в string.Template, которые соответственно возвращают все допустимые заполнители и наличие недопустимых заполнителей. (Предложено Ben Kehoe в gh-90465.)

sys¶

• sys.exc_info() теперь выводит поля type и traceback из value (экземпляра исключения), так что при изменении исключения во время его обработки изменения отражаются в результатах последующих вызовов exc_info(). (Предложено Irit Katriel в bpo-45711.)

• Добавлен sys.exception(), который возвращает активный экземпляр исключения (эквивалентно sys.exc_info()[1]). (Предложено Irit Katriel в bpo-46328.)

• Добавлен флаг sys.flags.safe_path. (Предложено Victor Stinner в gh-57684.)

sysconfig¶

• Три новые схемы установки (posix_venv, nt_venv и venv) были добавлены и используются, когда Python создаёт новые виртуальные окружения или запускается из виртуального окружения. Первые две схемы (posix_venv и nt_venv) являются зависимыми от ОС: для не-Windows и Windows, а venv по сути является псевдонимом одной из них в зависимости от ОС, на которой работает Python. Это полезно для дистрибьюторов, которые модифицируют sysconfig.get_preferred_scheme(). Сторонний код, создающий новые виртуальные окружения, должен использовать новую схему установки venv для определения путей, как это делает venv. (Предложено Miro Hrončok в bpo-45413.)

tempfile¶

• Объекты SpooledTemporaryFile теперь полностью реализуют методы io.BufferedIOBase или io.TextIOBase (в зависимости от режима файла). Это позволяет им корректно работать с API, ожидающими объекты, подобные файлам, например, модулями сжатия. (Автор: Carey Metcalfe в gh-70363.)

threading¶

• В Unix, если функция sem_clockwait() доступна в библиотеке C (glibc 2.30 и новее), метод threading.Lock.acquire() теперь использует монотонные часы (time.CLOCK_MONOTONIC) для тайм-аута, вместо использования системных часов (time.CLOCK_REALTIME), чтобы не зависеть от изменений системных часов. (Автор: Victor Stinner в bpo-41710.)

time¶

• В Unix, time.sleep() теперь использует функцию clock_nanosleep() или nanosleep(), если она доступна, которая имеет разрешение 1 наносекунда (10^-9 секунды), вместо использования select(), которая имеет разрешение 1 микросекунда (10^-6 секунды). (Авторы: Benjamin Szőke и Victor Stinner в bpo-21302.)

• В Windows 8.1 и новее, time.sleep() теперь использует ожидаемый таймер на основе высокоточных таймеров, который имеет разрешение 100 наносекунд (10^-7 секунды). Ранее он имел разрешение 1 миллисекунда (10^-3 секунды). (Авторы: Benjamin Szőke, Donghee Na, Eryk Sun и Victor Stinner в bpo-21302 и bpo-45429.)

tkinter¶

• Добавлен метод info_patchlevel(), который возвращает точную версию библиотеки Tcl в виде именованного кортежа, подобного sys.version_info. (Автор: Serhiy Storchaka в gh-91827.)

traceback¶

• Добавлен traceback.StackSummary.format_frame_summary(), чтобы позволить пользователям переопределять, какие фреймы появляются в трассировке и как они форматируются. (Автор: Ammar Askar в bpo-44569.)

• Добавлен traceback.TracebackException.print(), который выводит отформатированный экземпляр TracebackException в файл. (Автор: Irit Katriel в bpo-33809.)

typing¶

Основные изменения см. в новых возможностях, связанных с аннотациями типов.

• Добавлены typing.assert_never() и typing.Never. typing.assert_never() полезен для запроса к проверяльщику типов подтверждения, что строка кода недостижима. Во время выполнения он возбуждает AssertionError. (Автор: Jelle Zijlstra в gh-90633.)

• Добавлен typing.reveal_type(). Это полезно для запроса к проверяльщику типов, какой тип он вывел для данного выражения. Во время выполнения он выводит тип полученного значения. (Автор: Jelle Zijlstra в gh-90572.)

• Добавлен typing.assert_type(). Это полезно для запроса к проверяльщику типов подтверждения, что выведенный им тип для данного выражения соответствует заданному типу. Во время выполнения он просто возвращает полученное значение. (Автор: Jelle Zijlstra в gh-90638.)

• Типы typing.TypedDict теперь могут быть обобщёнными. (Автор: Samodya Abeysiriwardane в gh-89026.)

• Типы NamedTuple теперь могут быть обобщёнными. (Автор: Serhiy Storchaka в bpo-43923.)

• Разрешено создание подклассов typing.Any. Это полезно для избежания ошибок проверяльщика типов, связанных с высокодинамичными классами, такими как mocks. (Автор: Shantanu Jain в gh-91154.)

• Декоратор typing.final() теперь устанавливает атрибут __final__ на декорируемом объекте. (Автор: Jelle Zijlstra в gh-90500.)

• Функция typing.get_overloads() может использоваться для интроспекции перегрузок функции. typing.clear_overloads() можно использовать для очистки всех зарегистрированных перегрузок функции. (Автор: Jelle Zijlstra в gh-89263.)

• Метод __init__() подклассов Protocol теперь сохраняется. (Автор: Adrian Garcia Badarasco в gh-88970.)

• Представление типов пустых кортежей (Tuple[()]) упрощено. Это влияет на интроспекцию, например, get_args(Tuple[()]) теперь вычисляется в () вместо ((),). (Автор: Serhiy Storchaka в gh-91137.)

• Ослаблены требования времени выполнения для аннотаций типов путём удаления проверки на вызываемость в частной функции typing._type_check. (Автор: Gregory Beauregard в gh-90802.)

• typing.get_type_hints() теперь поддерживает вычисление строк как прямых ссылок в обобщённых псевдонимах PEP 585. (Автор: Niklas Rosenstein в gh-85542.)

• typing.get_type_hints() больше не добавляет Optional к параметрам с None в качестве значения по умолчанию. (Автор: Nikita Sobolev в gh-90353.)

• typing.get_type_hints() теперь поддерживает вычисление чистых строковых аннотаций ClassVar. (Автор: Gregory Beauregard в gh-90711.)

• typing.no_type_check() больше не изменяет внешние классы и функции. Теперь он также корректно помечает методы класса как не подлежащие проверке типов. (Автор: Nikita Sobolev в gh-90729.)

unicodedata¶

• База данных Unicode обновлена до версии 14.0.0. (Автор: Benjamin Peterson в bpo-45190).

unittest¶

• Добавлены методы enterContext() и enterClassContext() класса TestCase, метод enterAsyncContext() класса IsolatedAsyncioTestCase и функция unittest.enterModuleContext(). (Автор: Serhiy Storchaka в bpo-45046.)

venv¶

• Когда создаются новые виртуальные окружения Python, venv схема установки sysconfig используется для определения путей внутри окружения. Когда Python работает в виртуальном окружении, эта же схема установки используется по умолчанию. Это означает, что нижестоящие распространители могут изменить схему установки sysconfig по умолчанию, не меняя поведение виртуальных окружений. Сторонний код, который также создаёт новые виртуальные окружения, должен делать то же самое. (Предложено Miro Hrončok в bpo-45413.)

warnings¶

• warnings.catch_warnings() теперь принимает аргументы для warnings.simplefilter(), предоставляя более краткий способ локального игнорирования предупреждений или преобразования их в ошибки. (Предложено Zac Hatfield-Dodds в bpo-47074.)

zipfile¶

• Добавлена поддержка указания кодировки имён членов для чтения метаданных в заголовках каталога и файлов ZipFile. (Предложено Stephen J. Turnbull и Serhiy Storchaka в bpo-28080.)

• Добавлен ZipFile.mkdir() для создания новых каталогов внутри ZIP-архивов. (Предложено Sam Ezeh в gh-49083.)

• Добавлены stem, suffix и suffixes в zipfile.Path. (Предложено Miguel Brito в gh-88261.)

Faster Startup¶

Read __pycache__ -> Unmarshal -> Heap allocated code object -> Evaluate

Statically allocated code object -> Evaluate

Faster Runtime¶

Разное¶Misc

• Объекты теперь требуют меньше памяти благодаря лениво создаваемым пространствам имён объектов. Их словари пространств имён теперь также более свободно разделяют ключи. (Вклад Марка Шеннона в bpo-45340 и bpo-40116.)

• Реализованы исключения с «нулевой стоимостью», устраняющие затраты на оператор try, когда исключение не возбуждается. (Вклад Марка Шеннона в bpo-40222.)

• Более компактное представление исключений в интерпретаторе сократило время, необходимое для перехвата исключения, примерно на 10%. (Вклад Ирит Катриэль в bpo-45711.)

• Движок сопоставления регулярных выражений re был частично переработан и теперь на поддерживаемых платформах использует вычисляемые переходы (или «threaded code»). В результате Python 3.11 выполняет тесты производительности регулярных выражений pyperformance до 10% быстрее, чем Python 3.10. (Вклад Брандта Бухера в gh-91404.)

Часто задаваемые вопросы¶FAQ

О проекте¶About

Проект Faster CPython изучает оптимизации для CPython. Основная команда финансируется Microsoft для полной занятости над проектом. Пабло Галиндо Сальгадо также получает финансирование от Bloomberg LP для работы над проектом неполный рабочий день. Наконец, многие участники являются волонтёрами из сообщества.

Новые опкоды¶New opcodes

• ASYNC_GEN_WRAP, RETURN_GENERATOR и SEND, используемые в генераторах и корутинах.

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

• JUMP_BACKWARD_NO_INTERRUPT, для использования в определённых циклах, где обработка прерываний нежелательна.

• MAKE_CELL, для создания Cell Objects.

• CHECK_EG_MATCH и PREP_RERAISE_STAR, для обработки новых групп исключений и except*, добавленных в PEP 654.

• PUSH_EXC_INFO, для использования в обработчиках исключений.

• RESUME, пустая операция (no-op), для внутреннего трассирования, отладки и проверок оптимизации.

Заменённые опкоды¶Replaced opcodes

Изменённые/удалённые опкоды¶Changed/removed opcodes

• Изменены MATCH_CLASS и MATCH_KEYS: они больше не помещают дополнительное логическое значение для указания успеха/неудачи. Вместо этого при неудаче помещается None вместо кортежа извлечённых значений.

• Изменены опкоды, работающие с исключениями, чтобы отразить их представление в виде одного элемента в стеке вместо трёх (см. gh-89874).

• Удалены COPY_DICT_WITHOUT_KEYS, GEN_START, POP_BLOCK, SETUP_FINALLY и YIELD_FROM.

Язык/Встроенные функции¶Language/Builtins

• Цепочка дескрипторов classmethod (введённая в bpo-19072) теперь устарела. Её больше нельзя использовать для оборачивания других дескрипторов, таких как property. Базовая архитектура этой возможности была ошибочной и вызвала ряд проблем в дальнейшем. Для «пропускания» classmethod рекомендуется использовать атрибут __wrapped__, добавленный в Python 3.10. (Автор: Raymond Hettinger, gh-89519.)

• Восьмеричные управляющие последовательности в строковых и байтовых литералах со значениями больше 0o377 (255 в десятичной системе) теперь вызывают DeprecationWarning. В будущей версии Python они будут порождать SyntaxWarning и в конечном итоге SyntaxError. (Автор: Serhiy Storchaka в gh-81548.)

• Делегирование int() в __trunc__() теперь устарело. Вызов int(a), когда type(a) реализует __trunc__(), но не __int__() или __index__(), теперь вызывает DeprecationWarning. (Автор: Zackery Spytz в bpo-44977.)

Модули¶Modules

• PEP 594 привёл к объявлению устаревшими следующих модулей, которые планируется удалить в Python 3.13:

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

  (Авторы: Brett Cannon в bpo-47061 и Victor Stinner в gh-68966.)

• Модули asynchat, asyncore и smtpd устарели начиная как минимум с Python 3.6. Их документация и предупреждения об устаревании теперь обновлены, чтобы отметить, что они будут удалены в Python 3.12. (Автор: Hugo van Kemenade в bpo-47022.)

• Пакет lib2to3 и инструмент 2to3 теперь устарели и могут не поддерживать синтаксис Python 3.10 и новее. Подробнее см. PEP 617, который вводит новый PEG-парсер. (Автор: Victor Stinner в bpo-40360.)

• Модули без документации sre_compile, sre_constants и sre_parse теперь устарели. (Автор: Serhiy Storchaka в bpo-47152.)

Стандартная библиотека¶Standard Library

• Следующие элементы устарели в configparser начиная с Python 3.2. Теперь предупреждения об устаревании обновлены, чтобы указать, что они будут удалены в Python 3.12:

  • класс configparser.SafeConfigParser

  • свойство configparser.ParsingError.filename

  • метод configparser.RawConfigParser.readfp()

  (Автор: Hugo van Kemenade в bpo-45173.)

• configparser.LegacyInterpolation устарел в строке документации начиная с Python 3.2 и не указан в документации configparser. Теперь он вызывает DeprecationWarning и будет удалён в Python 3.13. Вместо него используйте configparser.BasicInterpolation или configparser.ExtendedInterpolation. (Автор: Hugo van Kemenade в bpo-46607.)

• Старый набор функций importlib.resources был объявлен устаревшим в пользу замен, добавленных в Python 3.9, и будет удалён в будущей версии Python из-за отсутствия поддержки ресурсов, находящихся в подкаталогах пакетов:

  • importlib.resources.contents()

  • importlib.resources.is_resource()

  • importlib.resources.open_binary()

  • importlib.resources.open_text()

  • importlib.resources.read_binary()

  • importlib.resources.read_text()

  • importlib.resources.path()

• Функция locale.getdefaultlocale() устарела и будет удалена в Python 3.15. Используйте функции locale.setlocale(), locale.getpreferredencoding(False) и locale.getlocale(). (Автор: Victor Stinner в gh-90817.)

• Функция locale.resetlocale() устарела и будет удалена в Python 3.13. Вместо неё используйте locale.setlocale(locale.LC_ALL, ""). (Автор: Victor Stinner в gh-90817.)

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

• В модуле re функция re.template() и соответствующие флаги re.TEMPLATE и re.T устарели, поскольку они не были документированы и не имели очевидного назначения. Они будут удалены в Python 3.13. (Авторы: Serhiy Storchaka и Miro Hrončok в gh-92728.)

• turtle.settiltangle() устарел начиная с Python 3.1; теперь он выдаёт предупреждение об устаревании и будет удалён в Python 3.13. Используйте вместо него turtle.tiltangle() (ранее он был ошибочно помечен как устаревший, и его строка документации теперь исправлена). (Автор: Hugo van Kemenade в bpo-45837.)

• typing.Text, который существует исключительно для обеспечения совместимости между кодом Python 2 и Python 3, теперь устарел. Его удаление пока не планируется, но пользователям рекомендуется использовать str везде, где это возможно. (Автор: Alex Waygood в gh-92332.)

• Синтаксис с именованными аргументами для создания типов typing.TypedDict теперь устарел. Поддержка будет удалена в Python 3.13. (Автор: Jingchen Ye в gh-90224.)

• webbrowser.MacOSX устарел и будет удалён в Python 3.13. Он не тестируется, не документирован и не используется самим webbrowser. (Автор: Donghee Na в bpo-42255.)

• Поведение, при котором из тестовых методов TestCase и IsolatedAsyncioTestCase возвращается значение (отличное от значения по умолчанию None), теперь устарело.

• Объявлены устаревшими следующие неофициально документированные функции unittest, запланированные к удалению в Python 3.13:

  • unittest.findTestCases()

  • unittest.makeSuite()

  • unittest.getTestCaseNames()

  Вместо этого используйте методы TestLoader:

  • unittest.TestLoader.loadTestsFromModule()

  • unittest.TestLoader.loadTestsFromTestCase()

  • unittest.TestLoader.getTestCaseNames()

  (Автор: Erlend E. Aasland в bpo-5846.)

• unittest.TestProgram.usageExit() отмечен как устаревший, будет удалён в 3.13. (Автор: Carlos Damázio в gh-67048.)

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

• Добавлена новая функция PyType_GetName() для получения краткого имени типа. (Автор: Hai Shi в bpo-42035.)

• Добавлена новая функция PyType_GetQualName() для получения полного имени типа. (Автор: Hai Shi в bpo-42035.)

• Добавлены новые функции PyThreadState_EnterTracing() и PyThreadState_LeaveTracing() в ограниченный C API для приостановки и возобновления трассировки и профилирования. (Автор: Victor Stinner в bpo-43760.)

• Добавлена константа Py_Version, которая имеет то же значение, что и PY_VERSION_HEX. (Автор: Gabriele N. Tornetta в bpo-43931.)

• Py_buffer и API теперь являются частью ограниченного API и стабильного ABI:

  • PyObject_CheckBuffer()

  • PyObject_GetBuffer()

  • PyBuffer_GetPointer()

  • PyBuffer_SizeFromFormat()

  • PyBuffer_ToContiguous()

  • PyBuffer_FromContiguous()

  • PyObject_CopyData()

  • PyBuffer_IsContiguous()

  • PyBuffer_FillContiguousStrides()

  • PyBuffer_FillInfo()

  • PyBuffer_Release()

  • PyMemoryView_FromBuffer()

  • слоты типов bf_getbuffer и bf_releasebuffer

  (Автор: Christian Heimes в bpo-45459.)

• Добавлена функция PyType_GetModuleByDef(), используемая для получения модуля, в котором был определён метод, в тех случаях, когда эта информация недоступна напрямую (через PyCMethod). (Автор: Petr Viktorin в bpo-46613.)

• Добавлены новые функции для упаковки и распаковки C double (сериализации и десериализации): PyFloat_Pack2(), PyFloat_Pack4(), PyFloat_Pack8(), PyFloat_Unpack2(), PyFloat_Unpack4() и PyFloat_Unpack8(). (Автор: Victor Stinner в bpo-46906.)

• Добавлены новые функции для получения атрибутов объекта фрейма: PyFrame_GetBuiltins(), PyFrame_GetGenerator(), PyFrame_GetGlobals(), PyFrame_GetLasti().

• Добавлены две новые функции для получения и установки активного экземпляра исключения: PyErr_GetHandledException() и PyErr_SetHandledException(). Это альтернативы функциям PyErr_SetExcInfo() и PyErr_GetExcInfo(), которые работают с устаревшим представлением исключений в виде кортежа из 3 элементов. (Автор: Irit Katriel в bpo-46343.)

• Добавлен элемент PyConfig.safe_path. (Автор: Victor Stinner в gh-57684.)

Переход на Python 3.11¶Porting to Python 3.11

• Некоторые макросы были преобразованы в статические встроенные функции, чтобы избежать проблем макросов. Изменение должно быть в основном незаметным для пользователей, поскольку функции-заменители приводят свои аргументы к ожидаемым типам, чтобы избежать предупреждений компилятора из-за статических проверок типов. Однако, когда ограниченный C API установлен на >=3.11, эти приведения не выполняются, и вызывающим сторонам потребуется приводить аргументы к ожидаемым типам. Подробнее см. PEP 670. (Авторы: Victor Stinner и Erlend E. Aasland в gh-89653.)

• PyErr_SetExcInfo() больше не использует аргументы type и traceback, интерпретатор теперь получает эти значения из экземпляра исключения (аргумент value). Функция по-прежнему похищает ссылки всех трёх аргументов. (Автор: Irit Katriel в bpo-45711.)

• PyErr_GetExcInfo() теперь получает поля type и traceback результата из экземпляра исключения (поле value). (Автор: Irit Katriel в bpo-45711.)

• _frozen имеет новое поле is_package, указывающее, является ли замороженный модуль пакетом. Ранее отрицательное значение в поле size было индикатором. Теперь для size используются только неотрицательные значения. (Автор: Kumar Aditya в bpo-46608.)

• _PyFrameEvalFunction() теперь принимает _PyInterpreterFrame* в качестве второго параметра вместо PyFrameObject*. Подробнее об использовании этого типа указателя на функцию см. в PEP 523.

• PyCode_New() и PyCode_NewWithPosOnlyArgs() теперь принимают дополнительный аргумент exception_table. По возможности следует избегать использования этих функций. Чтобы получить пользовательский объект кода: создайте объект кода с помощью компилятора, затем получите изменённую версию методом replace.

• PyCodeObject больше не имеет полей co_code, co_varnames, co_cellvars и co_freevars. Вместо этого используйте PyCode_GetCode(), PyCode_GetVarnames(), PyCode_GetCellvars() и PyCode_GetFreevars() соответственно для доступа к ним через C API. (Авторы: Brandt Bucher в bpo-46841 и Ken Jin в gh-92154 и gh-94936.)

• Старые макросы trashcan (Py_TRASHCAN_SAFE_BEGIN/Py_TRASHCAN_SAFE_END) теперь устарели. Их следует заменить новыми макросами Py_TRASHCAN_BEGIN и Py_TRASHCAN_END.

  Функция tp_dealloc с использованием старых макросов, например:

  static void
  mytype_dealloc(mytype *p)
  {
      PyObject_GC_UnTrack(p);
      Py_TRASHCAN_SAFE_BEGIN(p);
      ...
      Py_TRASHCAN_SAFE_END
  }
  

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

  static void
  mytype_dealloc(mytype *p)
  {
      PyObject_GC_UnTrack(p);
      Py_TRASHCAN_BEGIN(p, mytype_dealloc)
      ...
      Py_TRASHCAN_END
  }
  

  Обратите внимание, что Py_TRASHCAN_BEGIN принимает второй аргумент, который должен быть функцией освобождения, в которой он находится.

  Для поддержки старых версий Python в той же кодовой базе можно определить следующие макросы и использовать их по всему коду (источник: эти макросы скопированы из кодовой базы mypy):

  #if PY_VERSION_HEX >= 0x03080000
  #  define CPy_TRASHCAN_BEGIN(op, dealloc) Py_TRASHCAN_BEGIN(op, dealloc)
  #  define CPy_TRASHCAN_END(op) Py_TRASHCAN_END
  #else
  #  define CPy_TRASHCAN_BEGIN(op, dealloc) Py_TRASHCAN_SAFE_BEGIN(op)
  #  define CPy_TRASHCAN_END(op) Py_TRASHCAN_SAFE_END(op)
  #endif
  

• Функция PyType_Ready() теперь вызывает ошибку, если тип определён с установленным флагом Py_TPFLAGS_HAVE_GC, но не имеет функции обхода (PyTypeObject.tp_traverse). (Автор: Victor Stinner в bpo-44263.)

• Heap-типы с флагом Py_TPFLAGS_IMMUTABLETYPE теперь могут наследовать протокол vectorcall PEP 590. Ранее это было возможно только для статических типов. (Автор: Erlend E. Aasland в bpo-43908)

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

  #if PY_VERSION_HEX < 0x030900A4 && !defined(Py_SET_TYPE)
  static inline void _Py_SET_TYPE(PyObject *ob, PyTypeObject *type)
  { ob->ob_type = type; }
  #define Py_SET_TYPE(ob, type) _Py_SET_TYPE((PyObject*)(ob), type)
  #endif
  

  (Автор: Victor Stinner в bpo-39573.)

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

  #if PY_VERSION_HEX < 0x030900A4 && !defined(Py_SET_SIZE)
  static inline void _Py_SET_SIZE(PyVarObject *ob, Py_ssize_t size)
  { ob->ob_size = size; }
  #define Py_SET_SIZE(ob, size) _Py_SET_SIZE((PyVarObject*)(ob), size)
  #endif
  

  (Автор: Victor Stinner в bpo-39573.)

• <Python.h> больше не включает заголовочные файлы <stdlib.h>, <stdio.h>, <errno.h> и <string.h>, когда макрос Py_LIMITED_API установлен в 0x030b0000 (Python 3.11) или выше. Расширения C должны явно включать эти заголовочные файлы после #include <Python.h>. (Автор: Victor Stinner в bpo-45434.)

• Файлы неограниченного API cellobject.h, classobject.h, code.h, context.h, funcobject.h, genobject.h и longintrepr.h были перемещены в каталог Include/cpython. Кроме того, заголовочный файл eval.h был удалён. Эти файлы не должны включаться напрямую, так как они уже включены в Python.h: Include Files. Если они включались напрямую, рассмотрите возможность включения Python.h вместо этого. (Автор: Victor Stinner в bpo-35134.)

• Макрос PyUnicode_CHECK_INTERNED() был исключён из ограниченного C API. Он никогда не был там пригоден к использованию, потому что использовал внутренние структуры, недоступные в ограниченном C API. (Автор: Victor Stinner в bpo-46007.)

• Следующие функции и тип для работы с фреймами теперь доступны напрямую через #include <Python.h>, больше не нужно добавлять #include <frameobject.h>:

  • PyFrame_Check()

  • PyFrame_GetBack()

  • PyFrame_GetBuiltins()

  • PyFrame_GetGenerator()

  • PyFrame_GetGlobals()

  • PyFrame_GetLasti()

  • PyFrame_GetLocals()

  • PyFrame_Type

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

• Элементы структуры PyFrameObject были удалены из публичного C API.

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

  В Python 3.11 структура кадра была реорганизована для оптимизации производительности. Некоторые поля были полностью удалены, так как они были деталями старой реализации.

  Поля PyFrameObject:

  • f_back: используйте PyFrame_GetBack().

  • f_blockstack: удалено.

  • f_builtins: используйте PyFrame_GetBuiltins().

  • f_code: используйте PyFrame_GetCode().

  • f_gen: используйте PyFrame_GetGenerator().

  • f_globals: используйте PyFrame_GetGlobals().

  • f_iblock: удалено.

  • f_lasti: используйте PyFrame_GetLasti(). Код, использующий f_lasti с PyCode_Addr2Line(), должен использовать PyFrame_GetLineNumber() вместо этого; это может быть быстрее.

  • f_lineno: используйте PyFrame_GetLineNumber()

  • f_locals: используйте PyFrame_GetLocals().

  • f_stackdepth: удалено.

  • f_state: нет публичного API (переименовано в f_frame.f_state).

  • f_trace: нет публичного API.

  • f_trace_lines: используйте PyObject_GetAttrString((PyObject*)frame, "f_trace_lines").

  • f_trace_opcodes: используйте PyObject_GetAttrString((PyObject*)frame, "f_trace_opcodes").

  • f_localsplus: нет публичного API (переименовано в f_frame.localsplus).

  • f_valuestack: удалено.

  Объект кадра Python теперь создаётся лениво. Побочный эффект: к элементу f_back нельзя обращаться напрямую, так как его значение теперь также вычисляется лениво. Вместо этого необходимо вызывать функцию PyFrame_GetBack().

  Отладчики, которые обращались к f_locals напрямую, должны вызывать PyFrame_GetLocals() вместо этого. Им больше не нужно вызывать PyFrame_FastToLocalsWithError() или PyFrame_LocalsToFast(), более того, не следует вызывать эти функции. Необходимое обновление кадра теперь управляется виртуальной машиной.

  Код, определяющий PyFrame_GetCode() в Python 3.8 и старше:

  #if PY_VERSION_HEX < 0x030900B1
  static inline PyCodeObject* PyFrame_GetCode(PyFrameObject *frame)
  {
      Py_INCREF(frame->f_code);
      return frame->f_code;
  }
  #endif
  

  Код, определяющий PyFrame_GetBack() в Python 3.8 и старше:

  #if PY_VERSION_HEX < 0x030900B1
  static inline PyFrameObject* PyFrame_GetBack(PyFrameObject *frame)
  {
      Py_XINCREF(frame->f_back);
      return frame->f_back;
  }
  #endif
  

  Или используйте проект pythoncapi_compat, чтобы получить эти две функции в старых версиях Python.

• Изменения элементов структуры PyThreadState:

  • frame: удалено, используйте PyThreadState_GetFrame() (функция добавлена в Python 3.9 в bpo-40429). Предупреждение: функция возвращает сильную ссылку, необходимо вызвать Py_XDECREF().

  • tracing: изменено, используйте PyThreadState_EnterTracing() и PyThreadState_LeaveTracing() (функции добавлены в Python 3.11 в bpo-43760).

  • recursion_depth: удалено, используйте (tstate->recursion_limit - tstate->recursion_remaining) вместо этого.

  • stackcheck_counter: удалено.

  Код, определяющий PyThreadState_GetFrame() в Python 3.8 и старше:

  #if PY_VERSION_HEX < 0x030900B1
  static inline PyFrameObject* PyThreadState_GetFrame(PyThreadState *tstate)
  {
      Py_XINCREF(tstate->frame);
      return tstate->frame;
  }
  #endif
  

  Код, определяющий PyThreadState_EnterTracing() и PyThreadState_LeaveTracing() в Python 3.10 и старше:

  #if PY_VERSION_HEX < 0x030B00A2
  static inline void PyThreadState_EnterTracing(PyThreadState *tstate)
  {
      tstate->tracing++;
  #if PY_VERSION_HEX >= 0x030A00A1
      tstate->cframe->use_tracing = 0;
  #else
      tstate->use_tracing = 0;
  #endif
  }
  
  static inline void PyThreadState_LeaveTracing(PyThreadState *tstate)
  {
      int use_tracing = (tstate->c_tracefunc != NULL || tstate->c_profilefunc != NULL);
      tstate->tracing--;
  #if PY_VERSION_HEX >= 0x030A00A1
      tstate->cframe->use_tracing = use_tracing;
  #else
      tstate->use_tracing = use_tracing;
  #endif
  }
  #endif
  

  Или используйте проект pythoncapi-compat, чтобы получить эти функции в старых версиях Python.

• Распространителям рекомендуется собирать Python с оптимизированной библиотекой Blake2 libb2.

• Теперь для инициализации с использованием PyConfig.module_search_paths для инициализации sys.path поле PyConfig.module_search_paths_set должно быть установлено в 1. В противном случае инициализация пересчитает путь и заменит любые значения, добавленные в module_search_paths.

• PyConfig_Read() больше не вычисляет начальный путь поиска и не будет заполнять значения в PyConfig.module_search_paths. Чтобы вычислить пути по умолчанию и затем изменить их, завершите инициализацию и используйте PySys_GetObject() для получения sys.path в виде объекта списка Python и измените его напрямую.

Устарело¶Deprecated

• Объявить устаревшими следующие функции для настройки инициализации Python:

  • PySys_AddWarnOptionUnicode()

  • PySys_AddWarnOption()

  • PySys_AddXOption()

  • PySys_HasWarnOptions()

  • PySys_SetArgvEx()

  • PySys_SetArgv()

  • PySys_SetPath()

  • Py_SetPath()

  • Py_SetProgramName()

  • Py_SetPythonHome()

  • Py_SetStandardStreamEncoding()

  • _Py_SetProgramFullPath()

  Используйте новый API PyConfig из конфигурации инициализации Python вместо этого (PEP 587). (Автор: Victor Stinner в gh-88279.)

• Устарел элемент ob_shash из PyBytesObject. Вместо него используйте PyObject_Hash(). (Автор: Inada Naoki в bpo-46864.)

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

Следующие C API были объявлены устаревшими в предыдущих версиях Python и будут удалены в Python 3.12.

• PyUnicode_AS_DATA()

• PyUnicode_AS_UNICODE()

• PyUnicode_AsUnicodeAndSize()

• PyUnicode_AsUnicode()

• PyUnicode_FromUnicode()

• PyUnicode_GET_DATA_SIZE()

• PyUnicode_GET_SIZE()

• PyUnicode_GetSize()

• PyUnicode_IS_COMPACT()

• PyUnicode_IS_READY()

• PyUnicode_READY()

• PyUnicode_WSTR_LENGTH()

• _PyUnicode_AsUnicode()

• PyUnicode_WCHAR_KIND

• PyUnicodeObject

• PyUnicode_InternImmortal()

Удалено¶Removed

• PyFrame_BlockSetup() и PyFrame_BlockPop() были удалены. (Автор: Mark Shannon в bpo-40222.)

• Удалите следующие математические макросы, использующие переменную errno:

  • Py_ADJUST_ERANGE1()

  • Py_ADJUST_ERANGE2()

  • Py_OVERFLOWED()

  • Py_SET_ERANGE_IF_OVERFLOW()

  • Py_SET_ERRNO_ON_MATH_ERROR()

  (Автор: Victor Stinner в bpo-45412.)

• Удалите макросы Py_UNICODE_COPY() и Py_UNICODE_FILL(), устаревшие начиная с Python 3.3. Вместо них используйте PyUnicode_CopyCharacters() или memcpy() (строку wchar_t*) и функции PyUnicode_Fill(). (Автор: Victor Stinner в bpo-41123.)

• Удалите заголовочный файл pystrhex.h. Он содержит только внутренние функции. Расширения C должны включать только главный заголовочный файл <Python.h>. (Автор: Victor Stinner в bpo-45434.)

• Удалите макрос Py_FORCE_DOUBLE(). Он использовался макросом Py_IS_INFINITY(). (Автор: Victor Stinner в bpo-45440.)

• Следующие элементы больше не доступны, когда определён Py_LIMITED_API:

  • PyMarshal_WriteLongToFile()

  • PyMarshal_WriteObjectToFile()

  • PyMarshal_ReadObjectFromString()

  • PyMarshal_WriteObjectToString()

  • макрос Py_MARSHAL_VERSION

  Они не являются частью ограниченного API.

  (Автор: Victor Stinner в bpo-45474.)

• Исключите PyWeakref_GET_OBJECT() из ограниченного C API. Он никогда не работал, поскольку структура PyWeakReference является непрозрачной в ограниченном C API. (Автор: Victor Stinner в bpo-35134.)

• Удалите макрос PyHeapType_GET_MEMBERS(). Он был по ошибке включён в публичный C API, этот макрос должен использоваться только внутри Python. Вместо него используйте элемент PyTypeObject.tp_members. (Автор: Victor Stinner в bpo-40170.)

• Удалите макрос HAVE_PY_SET_53BIT_PRECISION (перенесён во внутренний C API). (Автор: Victor Stinner в bpo-45412.)

• Удалите API кодировщиков Py_UNICODE, так как они устарели начиная с Python 3.3, редко используются и неэффективны по сравнению с рекомендуемыми альтернативами.

  Удалённые функции:

  • PyUnicode_Encode()

  • PyUnicode_EncodeASCII()

  • PyUnicode_EncodeLatin1()

  • PyUnicode_EncodeUTF7()

  • PyUnicode_EncodeUTF8()

  • PyUnicode_EncodeUTF16()

  • PyUnicode_EncodeUTF32()

  • PyUnicode_EncodeUnicodeEscape()

  • PyUnicode_EncodeRawUnicodeEscape()

  • PyUnicode_EncodeCharmap()

  • PyUnicode_TranslateCharmap()

  • PyUnicode_EncodeDecimal()

  • PyUnicode_TransformDecimalToASCII()

  Подробнее см. PEP 624 и руководство по миграции. (Автор: Inada Naoki в bpo-44029.)

tarfile¶

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

OpenSSL¶

• Сборки для Windows и установщики для macOS с python.org теперь используют OpenSSL 3.0.