CKTIS / Python
Типова анотация с препратка напред
В Python 3.12 типова анотация в кавички може да сочи към име, което става достъпно едва след дефинирането на функцията.
Версия: Python 3.12
Синтаксис
def run_test(test: "Callable[[], None]") -> None:
test()В Python 3.12 без from __future__ import annotations анотациите на функцията се изчисляват при изпълнение на конструкцията def, а не при извикване на функцията. Име без кавички, което още не е достъпно, може тогава да доведе до NameError. Типова анотация с препратка напред може да се запише като низ, например "Callable[[], None]", за да може типовият израз да се разреши по-късно.
В сигнатурата на run_test записът Callable[[], None] описва извикваем обект, който не приема аргументи ([]) и връща None. Отделното -> None показва какво връща самата функция run_test. Кавичките не означават, че трябва да се подаде низ, а Python не проверява автоматично дали аргументът отговаря на анотацията.
run_test.__annotations__["test"] съдържа низа. typing.get_type_hints(run_test) изчислява израза в подходящото пространство от имена и може да предизвика NameError, ако Callable все още не е достъпно. Ако Callable вече е достъпно при изпълнение на def, кавичките не са нужни. Не разрешавай анотации от ненадеждни източници: изчисляването на изразите в тях може да изпълни код.
Примери
from typing import get_type_hints
def run_test(test: "Callable[[], None]") -> None:
test()
from collections.abc import Callable # Deliberately imported after run_test.
def smoke_test() -> None:
print("Test ran", end="")
print(repr(run_test.__annotations__["test"]))
print(get_type_hints(run_test)["test"] == Callable[[], None])
run_test(smoke_test)Резултат
'Callable[[], None]' True Test ran
Импортирането от `collections.abc` умишлено е след дефиницията на `run_test`. Първият ред показва представянето на низа, `True` потвърждава, че разрешеният тип съвпада с очаквания, а `Test ran` се извежда от извиканата тестова функция.
Свързани уроци
- Python · Урок 26 · Начално · Версия: 3