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

PEP 657: Детализированные локализации ошибок при обратной трассировке¶

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

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, который можно использовать для сопоставления bytecode instructions с местоположением исходного кода. Эту информацию можно получить с помощью:

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

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

Смотрите PEP 657 для получения более подробной информации. (Материалы предоставлены Пабло Галиндо, Батуханом Таскайей и Аммаром Аскаром в bpo-43950.)

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

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

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

(Автор: Ирит Катриэль в bpo-45292. Подбадривающий текст написан Ирит Катриэль, Юрием Селивановым и Гвидо ван Россумом.)

PEP 678: Исключения могут быть дополнены примечаниями¶

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

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

(Автор: Ирит Катриэль в bpo-45607. ОБОДРЯЮЩИЙ текст написан Заком Хэтфилдом-Доддсом.)

Улучшения в программе запуска Windows py.exe¶

Копия Программа запуска Python для Windows, входящая в состав Python 3.11, была значительно обновлена. Теперь он поддерживает синтаксис компании / тега, определенный в 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 484 ранее был введен TypeVar, позволяющий создавать обобщенные шаблоны, параметризованные одним типом. PEP 646 добавлен TypeVarTuple, позволяющий выполнять параметризацию с произвольным количеством типов. Другими словами, TypeVarTuple - это переменная типа variadic, позволяющая использовать вариативные обобщения.

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

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

(Автор: Мэтью Рахц в bpo-43224, при участии Сергея Сторчаки и Джелле Зейлстры. БОДРЯЩИЙ настрой, написанный Марком Мендосой, Мэтью Рахцем, Прадипом Кумаром Шринивасаном и Винсентом Сайлесом.)

PEP 655: Маркировка отдельных элементов TypedDict как требуемых, так и необязательных¶

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

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

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

m1: Movie = {"title": "Black Panther", "year": 2018}  # OK
m2: Movie = {"title": "Star Wars"}  # OK (year is not required)
m3: Movie = {"year": 2022}  # ERROR (missing required field title)

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

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

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

(Авторы - Дэвид Фостер и Джелле Зейлстра в bpo-47087. ОБОДРЯЮЩИЙ текст - Дэвид Фостер.)

PEP 673: Self тип¶

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

Распространенные варианты использования включают альтернативные конструкторы, представленные в виде classmethods, и методы __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 для получения более подробной информации.

(Автор: Джеймс Хилтон-Балф в bpo-46534. ОБОДРЯЮЩИЙ текст написан Прадипом Кумаром Шринивасаном и Джеймсом Хилтон-Балфом.)

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

Новая аннотация 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)               # type checker error
    run_query(                                # type checker error
        f"SELECT * FROM students WHERE name = {arbitrary_string}"
    )

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

(Автор: Джелле Зейлстра в bpo-47088. Ободряющие слова написаны Прадипом Кумаром Шринивасаном и Грэмом Блини.)

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

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

Например:

# The create_model decorator is defined by a library.
@typing.dataclass_transform()
def create_model(cls: Type[T]) -> Type[T]:
    cls.__init__ = ...
    cls.__eq__ = ...
    cls.__ne__ = ...
    return cls

# The create_model decorator can now be used to create new model classes:
@create_model
class CustomerModel:
    id: int
    name: str

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

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

(Автор: Джелле Зейлстра в gh-91860. Ободряющие слова написаны Эриком Де Бонте и Эриком Траутом.)

ОПТОСОЗ 563, возможно, не имеет будущего¶

PEP 563 Отложенная оценка аннотаций ( from __future__ import annotations future statement), которую первоначально планировалось выпустить в Python 3.10, была отложена на неопределенный срок. Дополнительную информацию смотрите в this message from the Steering Council.

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

• Добавлен класс TaskGroup, содержащий asynchronous context manager, который содержит группу задач, которые будут ожидать выполнения всех из них при завершении. Для нового кода рекомендуется использовать это вместо прямого использования create_task() и gather(). (Подготовлено Юрием Селивановым и другими авторами в gh-90908.)

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

• Добавлен класс Runner, который отображает оборудование, используемое run(). (Добавлено Андреем Светловым в gh-91218.)

• Добавлен класс Barrier к примитивам синхронизации в библиотеке asyncio и связанное с ним исключение BrokenBarrierError. (Авторы Ив Дюпра и Андрей Светлов в статье gh-87518).

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

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

• Добавлены функции сокета исходных дейтаграмм в цикл обработки событий: sock_sendto(), sock_recvfrom() и sock_recvfrom_into(). Они реализованы в SelectorEventLoop и ProactorEventLoop. (Автор: Алекс Гренхольм в статье bpo-46805.)

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

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

• Добавлен непараллельный chdir() контекстный менеджер, позволяющий изменять текущий рабочий каталог и затем восстанавливать его при выходе. Простая оболочка для chdir(). (Добавлено Филипе Луисом в bpo-25625)

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

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

дата и время¶

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

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

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

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

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

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

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

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

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

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

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

• Добавлен global_enum() enum decorator, который настраивает __repr__() и __str__() так, чтобы значения отображались как члены их модуля, а не как класс enum. Например, '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.

дроби¶

• Поддерживает инициализацию PEP 515 в стиле Fraction из строки. (Добавлено Сергеем Кирпичевым в bpo-44258.)

• Fraction теперь реализован метод __int__, так что проверка isinstance(some_fraction, typing.SupportsInt) проходит успешно. (Добавлено Марком Дикинсоном в bpo-44547.)

функциональные средства¶

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

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

gzip-файл¶

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

хэшлиб¶

• hashlib.blake2b() и hashlib.blake2s() теперь предпочитают libb2, а не разработанную на Python копию. (Автор Кристиан Хеймс в bpo-47095.)

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

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

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

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

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

проверить¶

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

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

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

  • inspect.getframeinfo()

  • inspect.getouterframes()

  • inspect.getinnerframes(),

  • inspect.stack()

  • inspect.trace()

  (Автор: Пабло Галиндо в gh-88116.)

место действия¶

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

регистрация¶

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

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

математика¶

• Добавить math.exp2(): вернуть значение 2, возведенное в степень x. (Добавлено Гидеоном Митчеллом в bpo-45917.)

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

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

• Значение math.nan теперь доступно всегда. (Добавлено Виктором Стиннером в bpo-46917.)

оператор¶

• Была добавлена новая функция operator.call, такая, что operator.call(obj, *args, **kwargs) == obj(*args, **kwargs). (Добавлено Энтони Ли в bpo-44019.)

ос¶

• В Windows os.urandom() теперь использует BCryptGenRandom() вместо CryptGenRandom(), который устарел. (Добавлено Донхи На в bpo-44611.)

• Начиная с 3.11.10, os.mkdir() и os.makedirs() в Windows теперь поддерживают передачу значения mode, равного 0o700, для применения контроля доступа к новому каталогу. Это неявно влияет на tempfile.mkdtemp() и является смягчающим фактором для CVE-2024-4030. Другие значения для mode по-прежнему игнорируются. (Добавлено Стивом Дауэром в gh-118486.)

файл пути¶

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

ре¶

• Атомарная группировка ((?>...)) и притяжательные кванторы (*+, ++, ?+, {m,n}+) теперь поддерживаются в регулярных выражениях. (Материалы предоставлены Джеффри Джейкобсом и Сергеем Сторчакой в bpo-433030.)

выключил¶

• Добавьте необязательный параметр dir_fd в shutil.rmtree(). (Добавлено Сергеем Сторчакой в bpo-46245.)

разъем¶

• Добавлена поддержка сокетов CAN для NetBSD. (Добавлено Томасом Клаузнером в bpo-30512.)

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

sqlite3¶

• Теперь вы можете отключить авторизатор, передав None в set_authorizer(). (Добавлено Эрлендом Э. Аасландом в bpo-44491.)

• Имя параметра сортировки create_collation() не может содержать символов Юникода. Имена параметров сортировки, содержащие недопустимые символы, теперь содержат UnicodeEncodeError вместо sqlite3.ProgrammingError. (Автор: Эрленд Э. Аасланд в bpo-44688.)

• sqlite3 исключения теперь включают расширенный код ошибки SQLite в виде sqlite_errorcode и имя ошибки SQLite в виде sqlite_errorname. (Материалы предоставлены Авивом Паливодой, Даниэлем Шахафом и Эрлендом Э. Аасландом в bpo-16379 и bpo-24139.)

• Добавьте setlimit() и getlimit() в sqlite3.Connection для установки и получения ограничений SQLite на основе соединений. (Автор Эрленд Э. Аасланд в bpo-45243.)

• sqlite3 теперь устанавливается sqlite3.threadsafety на основе режима потоковой передачи по умолчанию, с помощью которого была скомпилирована базовая библиотека SQLite. (Добавлено Эрлендом Э. Аасландом в bpo-45613.)

• sqlite3 Обратные вызовы C теперь используют недопустимые исключения, если включена трассировка обратного вызова. Пользователи теперь могут зарегистрировать unraisable hook handler для улучшения процесса отладки. (Автор: Эрленд Э. Аасланд в bpo-45828.)

• Выборка при откате больше не приводит к возникновению InterfaceError. Вместо этого мы предоставим библиотеке SQLite обрабатывать эти случаи. (Автор Эрленд Э. Аасланд в bpo-44092.)

• Добавьте serialize() и deserialize() в sqlite3.Connection для сериализации и десериализации баз данных. (Автор Эрленд Э. Аасланд в bpo-41930.)

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

• Добавьте blobopen() в sqlite3.Connection. sqlite3.Blob позволяет выполнять операции инкрементного ввода-вывода с большими двоичными объектами. (Авторы - Авив Паливода и Эрленд Э. Аасланд в bpo-24905.)

строка¶

• Добавьте get_identifiers() и is_valid() в string.Template, которые соответственно вернут все допустимые заполнители и уточнят, присутствуют ли недопустимые заполнители. (Автор: Бен Кехо в gh-90465.)

sys¶

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

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

• Добавьте флаг sys.flags.safe_path. (Автор: Виктор Стиннер в статье gh-57684.)

системная настройка¶

• Были добавлены три новых installation schemes (posix_venv, nt_venv и venv), которые используются, когда Python создает новые виртуальные среды или когда он запускается из виртуальной среды. Первые две схемы (posix_venv и nt_venv) специфичны для ОС, отличных от Windows, и для Windows Windows, venv по сути является псевдонимом для одной из них в зависимости от операционной системы, на которой работает Python. Это полезно для последующих распространителей, которые модифицируют sysconfig.get_preferred_scheme(). Сторонний код, создающий новые виртуальные среды, должен использовать новую схему установки venv для определения путей, как это делает venv. (Автор: Миро Хрончок в bpo-45413.)

временный файл¶

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

• Начиная с 3.11.10 в Windows, режим по умолчанию 0o700, используемый tempfile.mkdtemp(), теперь ограничивает доступ к новому каталогу из-за изменений в os.mkdir(). Это смягчение последствий CVE-2024-4030. (Автор: Стив Дауэр в статье gh-118486).

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

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

время¶

• В Unix time.sleep() теперь использует функцию clock_nanosleep() или nanosleep(), если она доступна, которая имеет разрешение в 1 наносекунду (10^-9 секунд), вместо того чтобы использовать select() который имеет разрешение в 1 микросекунду (10^-6 секунды). ((Материалы предоставлены Бенджамином Секе и Виктором Стиннером в bpo-21302.)

• В Windows 8.1 и более поздних версиях time.sleep() теперь используется таймер ожидания, основанный на high-resolution timers, который имеет разрешение 100 наносекунд (10^-7 секунд). Раньше он имел разрешение в 1 миллисекунду (10^-3 секунд). ((Материалы предоставлены Бенджамином Секе, Донги На, Эриком Суном и Виктором Стиннером в bpo-21302 и bpo-45429.)

ткинтер¶

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

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

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

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

печатание¶

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

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

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

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

• typing.TypedDict типы теперь могут быть универсальными. (Добавлено Самодией Абейсиривардане в gh-89026.)

• NamedTuple типы теперь могут быть универсальными. (Добавлено Сергеем Сторчакой в bpo-43923.)

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

• Декоратор typing.final() теперь устанавливает атрибут __final__ для оформляемого объекта. (Добавлено Джелле Зейлстрой в gh-90500.)

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

• Метод __init__() для подклассов Protocol теперь сохранен. ((Добавлено Адрианом Гарсией Бадараско в gh-88970.)

• Упрощено представление типов пустых кортежей (Tuple[()]). Это влияет на самоанализ, например, get_args(Tuple[()]) теперь вычисляется как () вместо ((),). (Автор - Сергей Сторчака в gh-91137.)

• Ослабьте требования к аннотациям типов во время выполнения, убрав проверку на возможность вызова в частной функции typing._type_check. (Автор Грегори Борегард в статье gh-90802).

• typing.get_type_hints() теперь поддерживается вычисление строк как прямых ссылок в PEP 585 generic aliases. (Добавлено Никласом Розенштейном в gh-85542.)

• typing.get_type_hints() больше не добавляет Optional к параметрам, для которых по умолчанию используется None. (Добавлено Никитой Соболевым в gh-90353.)

• typing.get_type_hints() теперь поддерживается вычисление аннотаций в виде простых строк ClassVar. (Добавлено Грегори Борегаром в gh-90711.)

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

данные в юникоде¶

• База данных Unicode обновлена до версии 14.0.0. (Добавлено Бенджамином Питерсоном в bpo-45190).

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

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

венв¶

• Когда создаются новые виртуальные среды Python, для определения путей внутри среды используется venv sysconfig installation scheme. Когда Python запускается в виртуальной среде, по умолчанию используется та же схема установки. Это означает, что последующие распространители могут изменять схему установки sysconfig по умолчанию без изменения поведения виртуальных сред. Сторонний код, который также создает новые виртуальные среды, должен делать то же самое. (Автор: Миро Хрончок в bpo-45413).

предупреждения¶

• warnings.catch_warnings() теперь принимает аргументы для warnings.simplefilter(), предоставляя более лаконичный способ локального игнорирования предупреждений или преобразования их в ошибки. (Добавлено Заком Хэтфилдом-Доддсом в bpo-47074.)

почтовый файл¶

• Добавлена поддержка указания кодировки имени пользователя для чтения метаданных в каталоге ZipFile и заголовках файлов. (Авторы Стивен Тернбулл и Сергей Сторчака в статье bpo-28080).

• Добавлен ZipFile.mkdir() для создания новых каталогов внутри ZIP-архивов. (Добавлено Сэмом Эзехом в gh-49083.)

• Добавлено stem, suffix и suffixes в zipfile.Path. (Добавлено Мигелем Брито в gh-88261.)

Более быстрый запуск¶

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

Statically allocated code object -> Evaluate

Более быстрое время выполнения¶

Разное¶

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

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

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

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

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

О¶

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

Новые коды операций¶

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

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

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

• MAKE_CELL, чтобы создать Объекты ячейки.

• CHECK_EG_MATCH и PREP_RERAISE_STAR, чтобы обработать new exception groups and except*, добавленные в PEP 654.

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

• RESUME, нерабочий, для внутренней трассировки, отладки и проверки оптимизации.

Замененные коды операций¶

Измененные/удаленные коды операций¶

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

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

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

Язык/встроенные модули¶

• Объединение в цепочку дескрипторов classmethod (введенное в bpo-19072) теперь устарело. Его больше нельзя использовать для переноса других дескрипторов, таких как property. В основном проекте этой функции были допущены ошибки, что привело к ряду последующих проблем. Чтобы «передать» classmethod, рассмотрите возможность использования атрибута __wrapped__, который был добавлен в Python 3.10. (Материал подготовлен Раймондом Хеттингером в gh-89519.)

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

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

Модули¶

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

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

  (Авторы Бретт Кэннон в bpo-47061 и Виктор Стиннер в gh-68966.)

• Модули asynchat, asyncore и smtpd считаются устаревшими, по крайней мере, с версии Python 3.6. Их документация и предупреждения об устаревании теперь обновлены, чтобы отметить, что они будут удалены в версии Python 3.12. (Добавлено Хьюго ван Кеменаде в bpo-47022.)

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

• Недокументированные модули sre_compile, sre_constants и sre_parse теперь признаны устаревшими. (Добавлено Сергеем Сторчакой в bpo-47152.)

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

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

  • класс configparser.SafeConfigParser

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

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

  (Автор: Хьюго ван Кеменаде в bpo-45173.)

• configparser.LegacyInterpolation устарел в docstring начиная с версии Python 3.2 и не указан в документации по configparser. Теперь он выдает DeprecationWarning и будет удален в Python 3.13. Используйте вместо этого configparser.BasicInterpolation или configparser.ExtendedInterpolation. (Автор - Хьюго ван Кеменаде в 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(). (Автор: Виктор Стиннер в статье gh-90817.)

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

• Более строгие правила теперь будут применяться к числовым ссылкам на группы и именам групп в regular expressions. Теперь в качестве числовой ссылки будут приниматься только последовательности цифр ASCII, а название группы в шаблонах bytes и заменяющих строках может содержать только буквы ASCII, цифры и символы подчеркивания. На данный момент для синтаксиса, нарушающего эти правила, выдается предупреждение об устаревании. (Автор - Сергей Сторчака в gh-91760.)

• В модуле re функция re.template() и соответствующие флаги re.TEMPLATE и re.T являются устаревшими, поскольку они не были задокументированы и не имели очевидного назначения. Они будут удалены в версии Python 3.13. ((Материалы предоставлены Сергеем Сторчакой и Миро Хрончоком в gh-92728.)

• turtle.settiltangle() устарел начиная с версии Python 3.1; теперь он выдает предупреждение об устаревании и будет удален в версии Python 3.13. Вместо этого используйте turtle.tiltangle() (ранее он был ошибочно помечен как устаревший, и его строка документа теперь исправлена). (Добавлено Хьюго ван Кеменаде в bpo-45837.)

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

• Синтаксис ключевого слова argument для построения типов typing.TypedDict теперь устарел. Поддержка будет удалена в Python 3.13. ((Добавлено Jingchen Ye в gh-90224.)

• webbrowser.MacOSX устарел и будет удален в Python 3.13. Он не протестирован, не задокументирован и не используется самим webbrowser. (Автор: Донхи На в 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()

  (Автор: Эрленд Э. Аасланд в bpo-5846.)

• unittest.TestProgram.usageExit() помечен как устаревший и будет удален в 3.13. (Добавлено Карлосом Дамазио в gh-67048.)

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

• Добавьте новую функцию PyType_GetName(), чтобы получить краткое имя типа. (Добавлено Хай Ши в bpo-42035.)

• Добавьте новую функцию PyType_GetQualName(), чтобы получить полное имя типа. (Добавлено Хай Ши в bpo-42035.)

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

• Добавлена константа Py_Version, которая имеет то же значение, что и PY_VERSION_HEX. (Добавлено Габриэле Н. Торнеттой в 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 введите слоты

  (Автор: Кристиан Хеймс в bpo-45459.)

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

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

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

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

• Добавлен участник PyConfig.safe_path. (Добавлено Виктором Стиннером в gh-57684.)

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

• Некоторые макросы были преобразованы в статические встроенные функции, чтобы избежать macro pitfalls. Изменение должно быть в основном прозрачным для пользователей, поскольку заменяющие функции будут приводить свои аргументы к ожидаемым типам, чтобы избежать предупреждений компилятора из-за статических проверок типов. Однако, если для параметра limited CAP установлено значение >=3.11, эти преобразования не выполняются, и вызывающим абонентам нужно будет привести аргументы к ожидаемым типам. Более подробную информацию смотрите в разделе PEP 670. (Материалы предоставлены Виктором Стиннером и Эрлендом Э. Аасландом в gh-89653.)

• PyErr_SetExcInfo() больше не использует аргументы type и traceback, интерпретатор теперь извлекает эти значения из экземпляра exception (аргумент value). Функция по-прежнему крадет ссылки на все три аргумента. (Добавлено Ирит Катриэль в bpo-45711.)

• PyErr_GetExcInfo() теперь выводит поля type и traceback результата из экземпляра exception (поле value). (Автор: Ирит Катриэль в статье bpo-45711.)

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

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

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

• :в c:type:PyCodeObject больше нет полей co_code, co_varnames, co_cellvars и co_freevars. Вместо этого используйте PyCode_GetCode(), PyCode_GetVarnames(), PyCode_GetCellvars() и PyCode_GetFreevars() соответственно, чтобы получить к ним доступ через C API. ((Материалы предоставлены Брандтом Бухером в bpo-46841 и Кеном Джином в gh-92154 и gh-94936.)

• Старые макросы корзины (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). (Автор: Виктор Стиннер в статье bpo-44263.)

• Типы кучи с флагом Py_TPFLAGS_IMMUTABLETYPE теперь могут наследовать протокол векторного вызова PEP 590. Ранее это было возможно только для static types. (Автор: Эрленд Э. Аасланд в 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
  

  (Автор: Виктор Стиннер в 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
  

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

• <Python.h> больше не содержит заголовочные файлы <stdlib.h>, <stdio.h>, <errno.h> и <string.h>, если для макроса Py_LIMITED_API установлено значение 0x030b0000 (Python 3.11) или более поздней версии. Расширения C должны явно включать заголовочные файлы после #include <Python.h>. (Добавлено Виктором Стиннером в 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. (Автор Виктор Стиннер в bpo-35134.)

• Макрос PyUnicode_CHECK_INTERNED() был исключен из limited CAPI. Он никогда не использовался там, поскольку использовал внутренние структуры, недоступные в limited C API. (Добавлено Виктором Стиннером в bpo-46007.)

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

  • PyFrame_Check()

  • PyFrame_GetBack()

  • PyFrame_GetBuiltins()

  • PyFrame_GetGenerator()

  • PyFrame_GetGlobals()

  • PyFrame_GetLasti()

  • PyFrame_GetLocals()

  • PyFrame_Type

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

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

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

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

  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 project, чтобы получить эти две функции в более старых версиях Python.

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

  • frame: удалено, используйте PyThreadState_GetFrame() (функция добавлена в Python 3.9 с помощью bpo-40429). Предупреждение: функция возвращает strong reference, нужно вызвать 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
  

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

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

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

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

Осуждаемый¶

• Не рекомендуется использовать следующие функции для настройки инициализации 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()

  Вместо этого используйте новый : c:type:PyConfig API из Python Initialization Configuration (PEP 587). (Автор Виктор Стиннер в gh-88279).

• Откажитесь от ob_shash элемента PyBytesObject. Вместо этого используйте PyObject_Hash(). (Добавлено Инадой Наоки в bpo-46864.)

Ожидающее удаления в Python 3.12¶

Следующие API-интерфейсы C устарели в более ранних версиях 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()

Удаленный¶

• PyFrame_BlockSetup() и PyFrame_BlockPop() были удалены. (Добавлено Марком Шенноном в bpo-40222.)

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

  • Py_ADJUST_ERANGE1()

  • Py_ADJUST_ERANGE2()

  • Py_OVERFLOWED()

  • Py_SET_ERANGE_IF_OVERFLOW()

  • Py_SET_ERRNO_ON_MATH_ERROR()

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

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

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

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

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

  • PyMarshal_WriteLongToFile()

  • PyMarshal_WriteObjectToFile()

  • PyMarshal_ReadObjectFromString()

  • PyMarshal_WriteObjectToString()

  • макрос Py_MARSHAL_VERSION

  Они не являются частью limited API.

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

• Исключить PyWeakref_GET_OBJECT() из ограниченного C API. Это никогда не срабатывало, поскольку структура PyWeakReference непрозрачна в ограниченном CAPI. (Добавлено Виктором Стиннером в bpo-35134.)

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

• Удалите макрос HAVE_PY_SET_53BIT_PRECISION (перенесите его во внутренний C API). (Добавлено Виктором Стиннером в bpo-45412.)

• Удалите API-интерфейсы Py_UNICODE encoder, поскольку они устарели начиная с версии 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 для получения подробной информации и migration guidance. (Добавлено Инадой Наоки в bpo-44029.)

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

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

OpenSSL открывает¶

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

ip-адрес¶

• Исправлено поведение is_global и is_private в IPv4Address, IPv6Address, IPv4Network и IPv6Network.

электронная почта¶

• Заголовки со встроенными новыми строками теперь заключаются в кавычки при выводе.

  generator теперь будет отказывать в сериализации (записи) заголовков, которые неправильно свернуты или разделены, так что они будут проанализированы как несколько заголовков или объединены со смежными данными. Если вам нужно отключить эту функцию безопасности, установите verify_generated_headers. (Авторы: Бас Блумсаат и Петр Викторин в статье gh-121650.)

• email.utils.getaddresses() и email.utils.parseaddr() теперь возвращают ('', '') 2-кортежи в большем количестве ситуаций, когда встречаются недопустимые адреса электронной почты, вместо потенциально неточных значений. К этим двум функциям был добавлен необязательный параметр strict: используйте strict=False, чтобы получить прежнее поведение, принимая неверные входные данные. getattr(email.utils, 'supports_strict_parsing', False) может использоваться для проверки доступности параметра strict. (Подготовлено Томасом Дуайером и Виктором Стиннером для gh-102988, чтобы улучшить исправление CVE-2023-27043.)