Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Python

typing.TypedDict

Opisuje schemat słownika o znanych kluczach napisowych i indywidualnym typie wartości każdego pola.

Wersja: Python 3.14; repository image, production runtime not attested

Składnia

class Task(TypedDict): ...

Opisuje schemat słownika o znanych kluczach napisowych i indywidualnym typie wartości każdego pola.

Domyślnie klucze są wymagane, o ile nie mają oznaczenia NotRequired. Konstruktor zwraca zwykły dict bez walidacji, a isinstance z klasą TypedDict zgłasza TypeError. Od Pythona 3.13 ReadOnly zabrania analizatorowi zaakceptować zmianę pola niezależnie od tego, czy jest ono wymagane.

Słownik podczas wykonania pozwala zmienić wartość.

Przykłady

from typing import TypedDict
class Point(TypedDict):
    x: int
    y: int
point = Point(x="other")
print(type(point) is dict, point, sorted(Point.__required_keys__))
try:
    isinstance(point, Point)
except TypeError:
    print("no instance check")
from typing import NotRequired, ReadOnly
class Label(TypedDict):
    id: ReadOnly[int]
    note: ReadOnly[NotRequired[str]]
label: Label = {"id": 1}
label["id"] = 2
assert Label.__readonly_keys__ == {"id", "note"}
assert Label.__required_keys__ == {"id"} and Label.__optional_keys__ == {"note"}
print(label)

Wynik

True {'x': 'other'} ['x', 'y']
no instance check
{'id': 2}

Słownik podczas wykonania pozwala zmienić wartość.

Źródła