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

1

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