__future__ – Определения future-операторов¶__future__ – Future statement definitions

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

__future__ – реальный модуль, и он служит трём целям:

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

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

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

Каждый оператор в __future__.py имеет вид:

FeatureName = _Feature(OptionalRelease, MandatoryRelease,
                       CompilerFlag)

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

(PY_MAJOR_VERSION, # 2 в 2.1.0a3; целое число
 PY_MINOR_VERSION, # 1; целое число
 PY_MICRO_VERSION, # 0; целое число
 PY_RELEASE_LEVEL, # "alpha", "beta", "candidate" или "final"; строка
 PY_RELEASE_SERIAL # 3; целое число
)

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

Если MandatoryRelease ещё не наступил, MandatoryRelease предсказывает релиз, в котором возможность станет частью языка.

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

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

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

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

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

1

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