**kwargs în Python
În această lecție vei învăța cum folosești **kwargs atunci când o funcție trebuie să accepte un număr variabil de argumente transmise prin nume.
Problema parametrilor numiți fixați
O funcție obișnuită acceptă doar parametrii definiți explicit.
def prezinta(nume, curs):
print(nume)
print(curs)
prezinta(nume="Ana", curs="Python") Dacă transmiți un argument numit suplimentar, precum oras="București", funcția produce TypeError.
Ce este **kwargs?
Scrierea **kwargs permite unei funcții să primească oricâte argumente keyword.
def prezinta(**kwargs):
print(kwargs)
prezinta(
nume="Ana",
curs="Python",
oras="București"
) {'nume': 'Ana', 'curs': 'Python', 'oras': 'București'} Numele argumentelor devin chei, iar valorile transmise devin valorile unui dicționar.
Semnele ** sunt partea importantă
Numele kwargs este o convenție, nu o regulă obligatorie.
def prezinta(**date):
print(date) Funcția funcționează deoarece parametrul are două semne *.
kwargs este un dicționar
def verifica(**kwargs):
print(type(kwargs))
verifica(nume="Ana") <class 'dict'>
Apel fără argumente
def afiseaza(**kwargs):
print(kwargs)
afiseaza() {} Dacă nu transmiți argumente, kwargs este un dicționar gol.
Apel cu un singur argument numit
def afiseaza(**kwargs):
print(kwargs)
afiseaza(curs="Python") {'curs': 'Python'} Apel cu mai multe argumente numite
def afiseaza(**kwargs):
print(kwargs)
afiseaza(
curs="Python",
nivel="Începător",
durata=30
) {'curs': 'Python', 'nivel': 'Începător', 'durata': 30} Accesarea unei valori după cheie
def prezinta(**kwargs):
print(kwargs["nume"])
print(kwargs["curs"])
prezinta(
nume="Ana",
curs="Python"
) Ana Python
Atenție la cheile inexistente
def prezinta(**kwargs):
print(kwargs["oras"])
prezinta(nume="Ana") Cheia oras nu există, deci accesarea directă produce KeyError.
Folosirea metodei get()
def prezinta(**kwargs):
oras = kwargs.get(
"oras",
"Oraș nespecificat"
)
print(oras)
prezinta(nume="Ana") Oraș nespecificat
Parcurgerea cheilor
def afiseaza(**kwargs):
for cheie in kwargs:
print(cheie)
afiseaza(
nume="Ana",
curs="Python"
) nume curs
Parcurgerea cheilor și valorilor
def afiseaza(**kwargs):
for cheie, valoare in kwargs.items():
print(cheie, valoare)
afiseaza(
nume="Ana",
curs="Python"
) nume Ana curs Python
Ordinea argumentelor este păstrată
def afiseaza(**kwargs):
for cheie in kwargs:
print(cheie)
afiseaza(
nume="Ana",
curs="Python",
nivel="Junior"
) nume curs nivel
Dicționarul păstrează ordinea în care argumentele au fost transmise.
Parametri obișnuiți înainte de **kwargs
def prezinta(titlu, **kwargs):
print(titlu)
print(kwargs)
prezinta(
"Profil",
nume="Ana",
curs="Python"
) Primul argument este atribuit parametrului titlu, iar argumentele numite rămase intră în kwargs.
Ordinea parametrilor
def functie(parametru, **kwargs):
pass **kwargs se scrie de regulă la finalul listei de parametri.
Parametri opționali și **kwargs
def prezinta(
titlu="Profil",
**kwargs
):
print(titlu)
print(kwargs)
prezinta(
nume="Ana",
curs="Python"
) *args împreună cu **kwargs
def functie(*args, **kwargs):
print(args)
print(kwargs)
functie(
"Python",
"SQL",
nivel="Începător",
durata=30
) ('Python', 'SQL')
{'nivel': 'Începător', 'durata': 30} Ordinea completă a parametrilor
def functie(
parametru,
*args,
optiune=True,
**kwargs
):
pass Parametrii poziționali apar înainte de *args, parametrii keyword-only apar după *args, iar **kwargs este ultimul.
Despachetarea unui dicționar la apel
Semnele ** pot fi folosite și când apelezi o funcție.
def prezinta(nume, curs):
print(nume)
print(curs)
date = {
"nume": "Ana",
"curs": "Python"
}
prezinta(**date) Ana Python
Două roluri diferite pentru **
def functie(**kwargs):
print(kwargs)
date = {
"nume": "Ana",
"curs": "Python"
}
functie(**date) În definiție, ** colectează argumentele numite într-un dicționar.
În apel, ** despachetează dicționarul în argumente keyword.
Cheile trebuie să fie stringuri
def prezinta(**kwargs):
print(kwargs)
date = {
"nume": "Ana",
"curs": "Python"
}
prezinta(**date) Cheile folosite pentru despachetare trebuie să fie stringuri, deoarece devin nume de argumente.
Cheile trebuie să corespundă parametrilor
def prezinta(nume, curs):
print(nume, curs)
date = {
"nume": "Ana",
"tehnologie": "Python"
}
prezinta(**date) Funcția nu are parametrul tehnologie și nu primește valoarea necesară pentru curs, deci apare TypeError.
Argument keyword duplicat
def prezinta(nume):
print(nume)
date = {"nume": "Ana"}
prezinta(
nume="Mihai",
**date
) Numele este transmis de două ori și apare TypeError.
Combinarea dicționarelor la apel
def prezinta(**kwargs):
print(kwargs)
date_personale = {
"nume": "Ana"
}
date_curs = {
"curs": "Python",
"nivel": "Junior"
}
prezinta(
**date_personale,
**date_curs
) {'nume': 'Ana', 'curs': 'Python', 'nivel': 'Junior'} Crearea unei configurații
def configureaza(**optiuni):
tema = optiuni.get("tema", "light")
limba = optiuni.get("limba", "ro")
print(tema)
print(limba)
configureaza(
tema="dark",
limba="en"
) Actualizarea unui dicționar
def creeaza_profil(**date):
profil = {
"activ": True
}
profil.update(date)
return profil
print(
creeaza_profil(
nume="Ana",
curs="Python"
)
) Validarea cheilor primite
def configureaza(**optiuni):
permise = {
"tema",
"limba"
}
for cheie in optiuni:
if cheie not in permise:
print("Opțiune necunoscută:", cheie)
configureaza(
tema="dark",
sunet=True
) Exemplu din viața reală: profil de cursant
def profil_cursant(nume, **detalii):
print("Nume:", nume)
for cheie, valoare in detalii.items():
print(cheie, valoare)
profil_cursant(
"Ana",
curs="Python",
nivel="Junior",
oras="București"
) Exemplu din viața reală: trimiterea unui email
def trimite_email(destinatar, **optiuni):
subiect = optiuni.get(
"subiect",
"Fără subiect"
)
prioritate = optiuni.get(
"prioritate",
"normală"
)
print(destinatar)
print(subiect)
print(prioritate)
trimite_email(
"ana@example.com",
subiect="Bun venit",
prioritate="mare"
) Exemplu din viața reală: interogare
def cauta(**filtre):
for camp, valoare in filtre.items():
print(camp, "=", valoare)
cauta(
limbaj="Java",
nivel="Senior",
remote=True
) Când este util **kwargs?
**kwargs este util când numele și numărul opțiunilor nu sunt cunoscute dinainte.
Îl poți folosi pentru configurări, filtre, profiluri, opțiuni de afișare, date suplimentare, setări și funcții care trebuie să accepte extensii fără schimbarea semnăturii.
Când nu este necesar?
Dacă funcția are câteva date obligatorii și bine definite, parametrii expliciți sunt mai clari.
def autentifica(email, parola):
pass Numele parametrilor documentează direct cerințele funcției.
Greșeli frecvente
Folosești un singur semn *
*args colectează argumente poziționale. **kwargs colectează argumente numite.
Crezi că kwargs este un tuplu
kwargs este întotdeauna un dicționar.
Transmiți argumente fără nume
**kwargs colectează doar argumentele keyword.
Confunzi colectarea cu despachetarea
În definiție, ** colectează. În apel, ** despachetează.
Rezumat
Număr flexibilFuncția poate primi oricâte argumente numite.
DicționarNumele și valorile sunt colectate într-un dicționar.
Acces prin cheieValorile se citesc folosind numele argumentelor.
Despachetare** poate transforma un dicționar în argumente keyword.
Folosește exact o funcție definită cu def, un singur parametru **detalii, o singură buclă for, un singur apel detalii.items(), un singur apel print() în funcție și un singur apel afiseaza_profil(). Nu folosi *args, while, list(), keys(), va…
Exercițiul, editorul și verificarea automată se deblochează cu Python OOP.

Alex Cristian
Iulian Pahom
Catalina Ioana Dan