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