Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / Python

Tipska anotacija s sklicem naprej

V Pythonu 3.12 se lahko tipska anotacija v narekovajih sklicuje na ime, ki je na voljo šele po definiciji funkcije.

Različica: Python 3.12

Sintaksa

def run_test(test: "Callable[[], None]") -> None:
    test()

V Pythonu 3.12 se brez from __future__ import annotations anotacije funkcije ovrednotijo ob izvedbi stavka def, ne ob klicu funkcije. Ime brez narekovajev, ki še ni na voljo, lahko takrat povzroči izjemo NameError. Tipsko anotacijo s sklicem naprej lahko zapišemo kot niz, na primer "Callable[[], None]", da se tipski izraz razreši pozneje.

V podpisu funkcije run_test zapis Callable[[], None] opisuje klicljiv objekt, ki ne sprejme nobenega argumenta ([]) in vrne None. Ločeni zapis -> None pove, kaj vrne funkcija run_test. Narekovaji ne pomenijo, da je treba podati niz, in Python ne preveri samodejno, ali argument ustreza anotaciji.

run_test.__annotations__["test"] vsebuje niz. typing.get_type_hints(run_test) ovrednoti izraz v ustreznem imenskem prostoru in lahko sproži izjemo NameError, če Callable še vedno ni na voljo. Če je Callable na voljo že ob izvedbi def, narekovaji niso potrebni. Ne razrešuj anotacij iz nezaupanja vrednih virov: pri vrednotenju izrazov v njih se lahko izvede koda.

Primeri

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)

Rezultat

'Callable[[], None]'
True
Test ran

Uvoz iz `collections.abc` je namenoma za definicijo funkcije `run_test`. Prva vrstica prikaže predstavitev niza, `True` potrdi, da se razrešeni tip ujema s pričakovanim, `Test ran` pa izpiše klicana testna funkcija.

Povezane lekcije

  • Python · Lekcija 26 · Osnovna · Različica: 3

Viri