CKTIS / Python
L’union de types `X | None`
`X | None` décrit une valeur de type `X` ou la valeur `None`. Dans `-> str | None`, l’union décrit la valeur renvoyée par une fonction, pas une valeur par défaut.
Version : Python 3.12
Syntaxe
X | NoneEn Python 3.12, X | None forme l’union du type X et du type dont None est l’unique valeur. Cette syntaxe existe depuis Python 3.10. Dans str | None, | construit une union de types ; il ne calcule pas un OU bit à bit sur des entiers. Comme annotation de type, X | None est équivalent à typing.Optional[X] et à typing.Union[X, None].
L’annotation de paramètre value: str | None permet de passer None, mais pas d’omettre l’argument : aucune valeur par défaut n’est spécifiée. L’écriture value: str | None = None fournit en plus une valeur par défaut. Python ne vérifie pas lui-même ces annotations à l’exécution.
Dans l’exemple, -> str | None décrit la valeur renvoyée par la fonction auxiliaire parse_args. La méthode argparse.ArgumentParser.parse_args renvoie un argparse.Namespace, tandis que la fonction auxiliaire renvoie seulement son attribut profile. Testez profile is None avant d’utiliser des méthodes de chaîne : '' reste une chaîne et ne signale pas une valeur absente.
Exemples
import argparse
def parse_args(argv: list[str]) -> str | None:
parser = argparse.ArgumentParser()
parser.add_argument("--profile", default=None)
return parser.parse_args(argv).profile
for argv in ([], ["--profile", "dev"], ["--profile="]):
profile = parse_args(argv)
if profile is None:
print("No profile provided")
else:
print(f"Profile: {profile!r}")
Résultat
No profile provided Profile: 'dev' Profile: ''
Les trois appels montrent l’option `--profile` omise, la valeur `'dev'` et une chaîne vide `''` fournie explicitement.
Leçons associées
- Python · Leçon 34 · Avancé · Version : 5