__future__ — Будущие определения утверждений¶

Исходный код: Lib/__future__.py.

__future__ является настоящим модулем и служит трем целям:

• Чтобы не сбивать с толку существующие инструменты, которые анализируют операторы импорта и ожидают найти импортируемые модули.

• Для того, чтобы future statements, запущенные под релизами до 2.1, как минимум выдавали исключения во время выполнения (импорт __future__ завершится неудачей, поскольку до 2.1 не существовало модуля с таким именем).

• Документировать, когда были внесены несовместимые изменения, и когда они будут — или были — сделаны обязательными. Это форма исполняемой документации, и ее можно проверить программно, импортировав __future__ и изучив ее содержимое.

Каждое утверждение в __future__.py имеет вид:

FeatureName = _Feature(OptionalRelease, MandatoryRelease,
                       CompilerFlag)

где обычно OptionalRelease меньше, чем MandatoryRelease, и оба являются 5-кортежами той же формы, что и sys.version_info:

(PY_MAJOR_VERSION, # the 2 in 2.1.0a3; an int
 PY_MINOR_VERSION, # the 1; an int
 PY_MICRO_VERSION, # the 0; an int
 PY_RELEASE_LEVEL, # "alpha", "beta", "candidate" or "final"; string
 PY_RELEASE_SERIAL # the 3; an int
)

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

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

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

MandatoryRelease также может быть None, что означает, что запланированная функция была отменена.

Экземпляры класса _Feature имеют два соответствующих метода, getOptionalRelease() и getMandatoryRelease().

CompilerFlag - это флаг (битовое поле), который следует передать в четвертом аргументе встроенной функции compile() для включения функции в динамически компилируемый код. Этот флаг хранится в атрибуте compiler_flag на экземплярах _Feature.

Ни одно описание функции никогда не будет удалено из __future__. С момента появления этого механизма в Python 2.1 следующие функции попали в язык с помощью этого механизма:

1

from __future__ import annotations ранее планировалось сделать обязательным в Python 3.10, но Руководящий совет Python дважды решил отложить это изменение (announcement for Python 3.10; announcement for Python 3.11). Окончательное решение пока не принято. См. также PEP 563 и PEP 649.