This document is for an old version of Python that is no longer supported. You should upgrade and read the Python documentation for the current stable release.

# 28.11. `__future__` — Définitions des futurs

Source code: Lib/_future_.py

Le module `__future__` est un vrai module, et il a trois objectifs :

- éviter de dérouter les outils existants qui analysent les instructions d’importation et s’attendent à trouver les modules qu’ils importent ;

- s’assurer que les instructions *future* lancées sous les versions antérieures à 2.1 lèvent au moins des exceptions à l’exécution (l’import du module `__future__` échoue, car il n’y avait pas de module de ce nom avant 2.1) ;

- Pour documenter le phasage de changements entraînant des incompatibilités : introduction, utilisation obligatoire. Il s’agit d’une forme de documentation exécutable, qui peut être inspectée par un programme en important `__future__` et en examinant son contenu.

Chaque instruction dans `__future__.py` est de la forme :

    FeatureName = _Feature(OptionalRelease, MandatoryRelease,
                           CompilerFlag)

where, normally, OptionalRelease is less than MandatoryRelease, and both are 5-tuples of the same form as `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 enregistre la première version dans laquelle la fonctionnalité a été acceptée.

Dans le cas d’un MandatoryRelease qui n’a pas encore eu lieu, MandatoryRelease prédit la release dans laquelle la fonctionnalité deviendra un élément du langage.

Sinon MandatoryRelease enregistre lorsque la fonctionnalité est devenue une partie du langage ; dans cette version ou les suivantes, les modules n’ont plus besoin d’une déclaration future pour utiliser la fonctionnalité en question, mais ils peuvent continuer à utiliser ces importations.

MandatoryRelease peut également être `None`, ce qui signifie qu’une fonction planifiée a été abandonnée.

Les instances de classe `_Feature` ont deux méthodes correspondantes, `getOptionalRelease()` et `getMandatoryRelease()`.

CompilerFlag est un drapeau (chaque bit représente un champ) qui doit être passé en tant que quatrième argument à la fonction native `compile()` pour activer la fonctionnalité dans le code compilé dynamiquement. Cet indicateur est stocké dans l’attribut `compiler_flag` dans les instances de `_Feature`.

Aucune fonctionnalité ne sera jamais supprimée de `__future__`. Depuis son introduction dans Python 2.1, les fonctionnalités suivantes ont trouvé leur places dans le langage utilisant ce mécanisme :

fonctionnalité | optionnel dans | obligatoire dans | effet
--- | --- | --- | ---
nested_scopes | 2.1.0b1 | 2.2 | PEP 227: Statically Nested Scopes
générateurs | 2.2.0a1 | 2.3 | PEP 255 : Générateurs simples
division | 2.2.0a2 | 3.0 | PEP 328 : Changer l’opérateur de division
absolute_import | 2.5.0a1 | 3.0 | PEP 328 : Imports : multilignes et absolus/relatifs
with_statement | 2.5.0a1 | 2.6 | PEP 343 : L’instruction « with »
print_function | 2.6.0a2 | 3.0 | PEP 3105: Make print a function
unicode_literals | 2.6.0a2 | 3.0 | PEP 3112 : Obtets littéraux en Python 3000

Voir aussi

L’instruction future

  Comment le compilateur gère les imports du futur.