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

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

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

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

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

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

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