29.10. __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’importation 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)

où, normalement, OptionalRelease est inférieur à MandatoryRelease, et les deux sont des quintuplets de la même forme que 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 : Portées imbriquées

générateurs

2.2.0a1

2.3

PEP 255 : Générateurs simples

division

2.2.0a2

3.0

PEP 238 : Changement de l’opérateur de division

absolute_import

2.5.0a1

3.0

PEP 328 : Importations : multilignes et absolues/relatives (ressource en anglais)

with_statement

2.5.0a1

2.6

PEP 343 : L’instruction « with »

print_function

2.6.0a2

3.0

PEP 3105 : Transformation de print en fonction

unicode_literals

2.6.0a2

3.0

PEP 3112 : Chaînes d’octets littéraux en Python 3000

generator_stop

3.5.0b1

3.7

PEP 479 : Gestion de *StopIteration à l’intérieur des générateurs*

Voir aussi

L’instruction future

Comment le compilateur gère les importations « futures ».