Python Academy · Les

Basisprincipes van typeannotaties

Annotateer variabelen, functieparameters en retourtypen.

Les 1 van 413 stappen

Basisprincipes van typeannotaties is een gratis Python Academy-les op CoddyKit. Dit is les 1 van 4. Je kunt de volledige les hieronder gratis lezen en daarna in de browser praktisch oefenen met een ingebouwde code-editor en een AI-begeleider die 24/7 beschikbaar is. Deze les maakt deel uit van het leertraject Python Academy. Je voortgang wordt gesynchroniseerd op het web en in de CoddyKit-app. De cursus Python Academy bevat in totaal 4 lessen.

Wat zijn typeannotaties

Typeannotaties zijn aanwijzingen die het verwachte type van variabelen, parameters en retourwaarden aangeven. Ze worden niet tijdens de uitvoering afgedwongen — ze worden gelezen door hulpmiddelen voor typecontrole zoals mypy.

def greet(name: str) -> str:
    return f"Hello, {name}"

result: str = greet("Alice")
print(result)

Variabele-annotaties

Voorzie variabelen op module-, klasse- of lokaal niveau van een annotatie met een dubbele punt, gevolgd door het type.

count: int = 0
pi: float = 3.14159
name: str = "Python"
flag: bool = True

# Annotation without assignment (declaration only)
future_value: int

Annotaties voor functieparameters

Voorzie elke parameter in de functiedefinitie van een annotatie. Gebruik -> type om het retourtype te annoteren.

def add(a: int, b: int) -> int:
    return a + b

def repeat(text: str, times: int = 1) -> str:
    return text * times

def no_return() -> None:
    print("side effect only")

Ingebouwde verzamelingstypen (Python 3.9+)

Gebruik vanaf Python 3.9 ingebouwde typen met kleine letters rechtstreeks als generieke typen: list[int], dict[str, int], tuple[int, ...].

def total(numbers: list[int]) -> int:
    return sum(numbers)

def config() -> dict[str, str]:
    return {"host": "localhost", "port": "8080"}

def coords() -> tuple[float, float]:
    return (1.0, 2.0)

Optional en Union

X | None (Python 3.10+) of Optional[X] betekent dat een waarde X of None kan zijn. X | Y betekent X of Y.

from typing import Optional

def find(items: list[int], target: int) -> int | None:
    return next((x for x in items if x == target), None)

# Older style:
# def find(...) -> Optional[int]:

Union-typen

int | str (Python 3.10+) of Union[int, str] annoteert een waarde die een van meerdere typen kan zijn.

from typing import Union

def process(value: int | str) -> str:
    return str(value)

# Older style:
# def process(value: Union[int, str]) -> str:

Typealiassen

Wijs een type-expressie toe aan een naam om een herbruikbare typealias te maken en de leesbaarheid te verbeteren.

from typing import TypeAlias

Vector: TypeAlias = list[float]
Matrix: TypeAlias = list[Vector]

def dot(a: Vector, b: Vector) -> float:
    return sum(x * y for x, y in zip(a, b))

Callable-annotaties

Gebruik Callable[[arg_types], return_type] om functies te annoteren die als argument worden doorgegeven.

from typing import Callable

def apply(func: Callable[[int, int], int], x: int, y: int) -> int:
    return func(x, y)

result = apply(lambda a, b: a + b, 3, 4)
print(result)  # 7

Annotaties voor *args en **kwargs

Annoteer *args met het type van de elementen, niet met een tuple, en **kwargs met het type van de waarden.

def log(*messages: str, level: str = "INFO") -> None:
    for msg in messages:
        print(f"[{level}] {msg}")

def configure(**options: int) -> None:
    for key, val in options.items():
        print(f"{key}: {val}")

from future import annotations

Voeg deze import bovenaan het bestand toe om uitgestelde evaluatie van annotaties in te schakelen, zodat voorwaartse verwijzingen zonder aanhalingstekens mogelijk zijn.

from __future__ import annotations

class Node:
    def __init__(self, value: int, next: Node | None = None):
        self.value = value
        self.next = next   # forward ref to Node works here

TYPE_CHECKING-voorwaarde

Importeer typen alleen tijdens typecontrole, niet tijdens de uitvoering, om circulaire imports of zware imports te voorkomen.

from __future__ import annotations
from typing import TYPE_CHECKING

if TYPE_CHECKING:
    from mymodule import HeavyClass

def process(obj: HeavyClass) -> None:
    ...   # HeavyClass not imported at runtime

Korte controle

Welke annotatiesyntaxis geeft aan dat een functie niets retourneert?

Beantwoord dit in de interactieve les

Samenvatting

Annoteer variabelen met name: Type, parameters met param: Type en retourwaarden met -> Type. Gebruik list[T], dict[K,V] (Python 3.9+), X | None (3.10+) en from __future__ import annotations voor voorwaartse verwijzingen.

Gratis beginnen

Leer Python met een AI-tutor — gratis

Schrijf echte code en voer die uit in je browser, krijg direct hulp van een AI-tutor die 24/7 beschikbaar is en ga verder waar je gebleven bent op het web of in de app.

Cursussen: 76
Lessen: 320

Gratis beginnen met leren Bekijk de volledige cursus

Veelgestelde vragen

Is de les “Basisprincipes van typeannotaties” gratis?

Ja — de volledige tekst van “Basisprincipes van typeannotaties” kun je hier gratis op het web lezen. Als je interactief wilt oefenen met een ingebouwde code-editor en een AI-begeleider die 24/7 beschikbaar is, en de rest van de cursus Python Academy wilt ontgrendelen, kun je upgraden naar CoddyKit PRO. De cursus Python Academy bevat in totaal 4 lessen.

Wat leer ik in “Basisprincipes van typeannotaties”?

Annotateer variabelen, functieparameters en retourtypen. Je oefent met Python Academy door code rechtstreeks in de browser uit te voeren. Een AI-begeleider die 24/7 beschikbaar is beantwoordt je vragen terwijl je de les doorwerkt.

Heb ik ervaring nodig om met Python Academy te beginnen?

Ervaring vooraf is niet nodig. Python Academy op CoddyKit is opgebouwd voor beginners tot gevorderden, zodat je hier of bij het begin kunt starten en in je eigen tempo kunt leren. Dit is les 1 van 4.

Hoe lang duurt de les “Basisprincipes van typeannotaties”?

De meeste lessen van CoddyKit duren ongeveer 5–10 minuten. Elke les is kort en interactief, zodat je gestaag vooruitgaat en op het web en in de app precies verdergaat waar je was gebleven.

Kan ik code schrijven en uitvoeren in deze les over Python Academy?

Ja. Elke les over Python Academy bevat een ingebouwde code-editor, zodat je rechtstreeks in je browser echte code kunt schrijven en uitvoeren en direct feedback van AI krijgt — lokale installatie is niet nodig.

Alle lessen in deze cursus

Basisprincipes van typeannotaties
Complexe typen: List, Dict, Optional, Union
TypeVar, generieke klassen en Protocol
mypy uitvoeren en typefouten oplossen

← Terug naar Python Academy