field(metadata) în Python
În această lecție vei învăța cum atașezi informații descriptive unui câmp dataclass, fără să schimbi valoarea păstrată în obiect.
Un câmp dataclass obișnuit
from dataclasses import dataclass
@dataclass
class Produs:
nume: str
pret: float Câmpurile declară valorile care vor fi păstrate în obiect.
Uneori avem nevoie și de descrieri
O aplicație poate avea nevoie de etichete, unități de măsură sau reguli asociate unui câmp.
pret → unitate: RON
Importul funcțiilor field și fields
from dataclasses import dataclass, field, fields
field() atașează metadatele, iar fields() permite citirea lor.
Declararea metadatelor
@dataclass
class Produs:
nume: str
pret: float = field(
metadata={"unitate": "RON"}
) metadata primește un dicționar cu informații asociate câmpului.
Valoarea obiectului nu se schimbă
produs = Produs("Laptop", 3500)
print(produs.pret) 3500
Metadatele descriu câmpul, dar nu înlocuiesc valoarea lui.
Citirea metadatelor
campuri = fields(Produs) camp_pret = campuri[1] print(camp_pret.metadata)
{'unitate': 'RON'} Accesarea unei informații
print(camp_pret.metadata["unitate"])
RON
Mai multe informații
pret: float = field(
metadata={
"unitate": "RON",
"eticheta": "Preț produs"
}
) Dicționarul metadata poate conține mai multe perechi cheie-valoare.
Metadatele nu apar în reprezentare
print(produs)
Produs(nume='Laptop', pret=3500)
Reprezentarea automată afișează valorile obiectului, nu și metadata.
Metadatele nu validează automat
varsta: int = field(
metadata={"minim": 18}
) Informația este doar stocată. Programul trebuie să o folosească explicit dacă dorește validare.
Când este util?
metadata este utilă pentru formulare generate automat, serializare, validare personalizată și afișarea unor etichete.
Greșeli frecvente
Folosești metadata fără field()
Informațiile suplimentare se configurează prin field().
Te aștepți la validare automată
Metadatele trebuie interpretate de codul aplicației.
Încerci să le citești direct din obiect
Folosește fields() pentru a obține obiectul Field corespunzător.
Rezumat
metadataPăstrează informații descriptive despre câmp.
field()Atașează dicționarul de metadate.
fields()Permite inspectarea câmpurilor clasei.
Fără efect automatAplicația decide cum folosește informațiile.
Creează clasa de date Curs, care păstrează titlul și durata cursului. Atributul titlu are tipul str. Atributul durata are tipul int și trebuie să primească metadatele {"unitate": "ore", "eticheta": "Durata cursului"}. Creează cursul Python…
Exercițiul, editorul și verificarea automată se deblochează cu Junior Python Developer.

Alex Cristian
Iulian Pahom
Catalina Ioana Dan