CKTIS / Python
Union de types X | None et annotations avec références en avant
Utilisez `X | None` pour accepter une valeur de type `X` ou `None`. Si une classe est définie plus loin, mettez toute l’annotation entre guillemets ou utilisez l’import `__future__`.
Version : Python 3.12
Syntaxe
# Without the future import
class X: ...
value: X | None
value: "X | None"
def make_board(ticket: "Ticket") -> "Board": ...
# Alternative in Python 3.12: copy the next three lines without
# their comment prefixes into a separate module, with the import first.
# from __future__ import annotations
# value: X | None
# def make_board(ticket: Ticket) -> Board: ...Dans Python 3.12, X | None autorise une valeur de type X ou None. Cette syntaxe, disponible depuis Python 3.10, équivaut à typing.Optional[X] et à typing.Union[X, None], pas à un appel à typing.Union(...). Ici, | construit normalement une union de types, pas un OU bit à bit sur des entiers ; une métaclasse ayant sa propre méthode __or__ peut changer le résultat. L’annotation n’impose pas le type à l’exécution et ne permet pas d’omettre un argument sans valeur par défaut.
Sans l’import __future__, Python 3.12 évalue les annotations ordinaires d’une fonction au moment de sa définition. Si User n’est pas encore défini, User | None lève NameError. Mettez toute l’union entre guillemets : "User|None". Évalué immédiatement, "User" | None lève TypeError. De même, "Ticket" et "Board" dans une signature désignent des classes définies plus loin, pas des valeurs de type str.
Autre possibilité : placez from __future__ import annotations en tête du module et utilisez User | None, Ticket et Board sans guillemets dans les annotations. Python 3.12 conserve alors les annotations sous forme de chaînes. Cet import ne reporte pas l’évaluation d’une affectation ordinaire comme Alias = User | None.
Une fois les classes définies, typing.get_type_hints() peut résoudre les références stockées dans __annotations__. Les noms doivent alors être accessibles dans l’espace de noms approprié ; au besoin, fournissez globalns ou localns. Un nom manquant peut entraîner NameError. L’évaluation des annotations peut exécuter du code arbitraire : ne résolvez pas d’annotations provenant de sources non fiables.
Exemples
from typing import get_type_hints
def make_board(ticket: "Ticket") -> "Board":
return Board(ticket)
class Ticket:
def __init__(self, owner: "User|None") -> None:
self.owner = owner
class Board:
def __init__(self, ticket: Ticket) -> None:
self.ticket = ticket
class User:
pass
print(Ticket.__init__.__annotations__["owner"])
print(get_type_hints(Ticket.__init__)["owner"] == (User | None))
board_hints = get_type_hints(make_board)
print(board_hints["ticket"] is Ticket, board_hints["return"] is Board)
print(make_board(Ticket(None)).ticket.owner is None)
Résultat
User|None True True True True
La première ligne affiche la chaîne brute `User|None`. La deuxième confirme la résolution de l’union, la troisième celle des deux références de classe, et la quatrième montre que le code crée un `Ticket` dont le propriétaire vaut `None`.
Leçons associées
- Python · Leçon 1 · Avancé · Version : 5