__future__ — Определения инструкций __future__

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

__future__ — это реальный модуль, выполняющий три функции:

• Избежать путаницы у существующих инструментов, анализирующих инструкции импорта и ожидающих найти импортируемые модули.
• Обеспечить, чтобы инструкции __future__, запущенные в версиях до 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 записывает первую версию, в которой функция была принята.

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

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

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

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

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

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