База знанияИзпитен център
BGБългарски
Избери език13

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

Източници