0 dní v řadě · 0 bodů

Tahák · Python · Funkce

Docstringy a typové anotace

Naučíš funkce říct, co dělají a co čekají. Docstringy, typové anotace, práce s None a kontrola chyb ještě před spuštěním.

Otevřít celou lekciVšechny taháky
python
def f(a: int, b: str = "x") -> bool:
    """Jedna věta, co funkce dělá.

    Podrobnosti: jednotky, okrajové případy, vedlejší účinky.
    """

f.__doc__                       # text docstringu
inspect.getdoc(f)               # bez odsazení
f.__annotations__               # slovník anotací

list[int]   dict[str, float]    tuple[str, int]   set[str]
int | None                      # číslo, nebo nic
Iterable[str]                   # cokoli procházitelné
Callable[[int], str]            # funkce int -> str
type Cenik = dict[str, float]   # pojmenovaný typ (3.12)

if x is None: ...               # ne: if not x
# Python anotace nekontroluje, dělá to mypy