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

__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 следующие возможности попали в язык с помощью этого механизма: