CKTIS / Python
Обединение на типове X | None и анотации с препратки напред
Използвай `X | None`, за да позволиш стойност от тип `X` или `None`. Ако класът е дефиниран по-надолу, сложи цялата анотация в кавички или използвай импорта от `__future__`.
Версия: Python 3.12
Синтаксис
# 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: ...В Python 3.12 X | None допуска стойност от тип X или None. Този запис е наличен от Python 3.10 и е еквивалентен на typing.Optional[X] и typing.Union[X, None], а не на извикване на typing.Union(...). Тук | обикновено създава обединение на типове, а не извършва побитово ИЛИ с цели числа; метаклас със собствен метод __or__ може да промени резултата. Анотацията не налага типа при изпълнение и не позволява да се пропусне аргумент без стойност по подразбиране.
Без импорта от __future__ Python 3.12 оценява обикновените анотации на функцията при дефинирането ѝ. Ако User още не е дефиниран, User | None предизвиква NameError. Сложи цялото обединение в кавички: "User|None". При незабавно оценяване "User" | None предизвиква TypeError. По същия начин "Ticket" и "Board" в сигнатурата сочат към класове, дефинирани по-надолу, а не към стойности от тип str.
Другият вариант е да поставиш from __future__ import annotations в началото на модула и да използваш User | None, Ticket и Board без кавички в анотациите. Тогава Python 3.12 съхранява анотациите като низове. Този импорт не отлага оценяването при обикновено присвояване като Alias = User | None.
След като класовете са дефинирани, typing.get_type_hints() може да разреши препратките от __annotations__. В този момент имената трябва да са достъпни в подходящото пространство от имена; при нужда подай globalns или localns. Липсващо име може да доведе до NameError. Оценяването на анотации може да изпълни произволен код, затова не разрешавай анотации от ненадеждни източници.
Примери
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)
Резултат
User|None True True True True
Първият ред показва оригиналния низ `User|None`. Вторият потвърждава, че обединението е разрешено, а третият — че и двете препратки към класове са разрешени. Четвъртият показва, че кодът създава `Ticket` със собственик `None`.
Свързани уроци
- Python · Урок 1 · Напреднало · Версия: 5