TypeError: __main__.creeaza_cont() argument after ** must be a mapping, not list
Ai despachetat cu ** ceva care nu e dicționar (o listă, un tuplu, None). ** cere perechi nume: valoare. Pentru o listă de valori folosește o singură steluță, f(*valori), sau construiește întâi un dicționar.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
În apeluri, date transformă un dicționar în argumente cu nume: f({"nume": "Ana"}) e ca f(nume="Ana"). Ca să funcționeze, obiectul trebuie să fie un mapping (dicționar sau ceva care se comportă ca unul, cu chei și valori). Dacă e o listă, un tuplu, un text sau None, Python nu are de unde lua numele argumentelor și ridică argument after ** must be a mapping, not list.
Perechea ei: argument after * must be an iterable, not int, când despachetezi cu * ceva ce nu se poate parcurge (un număr, None).
Cauze frecvente: ai confundat * cu **, datele vin dintr-un JSON care e listă ([{...}]) în loc de obiect, sau o funcție care trebuia să întoarcă un dicționar a întors None. Numele funcției din mesaj e prefixat de modulul în care e definită: __main__ înseamnă scriptul pe care l-ai rulat direct.
De ce apare: cauzele frecvente
1Listă de valori despachetată cu **
def creeaza_cont(nume, email):
return f"{nume} <{email}>"
date = ["Ana", "ana@exemplu.ro"]
print(creeaza_cont(**date))def creeaza_cont(nume, email):
return f"{nume} <{email}>"
date = ["Ana", "ana@exemplu.ro"]
print(creeaza_cont(*date))O listă se despachetează pozițional, cu o singură steluță.
2JSON care e listă de obiecte
import json
def creeaza_cont(nume, email):
return nume
date = json.loads('[{"nume": "Ana", "email": "a@x.ro"}]')
print(creeaza_cont(**date))import json
def creeaza_cont(nume, email):
return nume
date = json.loads('[{"nume": "Ana", "email": "a@x.ro"}]')
print(creeaza_cont(**date[0]))JSON-ul e o listă; dicționarul pe care îl vrei e primul element.
3Despachetare cu * a unui număr
def suma(*numere):
return sum(numere)
print(suma(*5))def suma(*numere):
return sum(numere)
print(suma(*[5]))* cere ceva ce se poate parcurge; mesajul aici e argument after * must be an iterable, not int.
Repară eroarea, direct în pagină
Programul creează un utilizator din datele primite într-o listă, cu valorile în ordinea parametrilor funcției, dar apelul dă TypeError: ... argument after ** must be a mapping, not list. Repară apelul ca programul să afișeze Ana Pop (ana@exemplu.ro).
def creeaza_utilizator(nume, email):
return f"{nume} ({email})"
date = ["Ana Pop", "ana@exemplu.ro"]
print(creeaza_utilizator(**date))Ana Pop (ana@exemplu.ro)
Indiciu
Datele sunt o listă de valori în ordinea parametrilor, nu perechi nume: valoare.
Reparația
def creeaza_utilizator(nume, email):
return f"{nume} ({email})"
date = ["Ana Pop", "ana@exemplu.ro"]
print(creeaza_utilizator(*date))De ce merge
** despachetează doar dicționare, unde fiecare cheie devine numele unui argument. Lista nu are nume, ci doar poziții, deci se despachetează cu o singură steluță: *date devine creeaza_utilizator("Ana Pop", "ana@exemplu.ro"), iar valorile ajung în parametri în ordine. Dacă ai avea un dicționar cu cheile nume și email, atunci ** ar fi varianta corectă.
Alte forme ale mesajului
TypeError: creeaza_cont() argument after ** must be a mapping, not listTypeError: creeaza_cont() argument after ** must be a mapping, not NoneTypeTypeError: suma() argument after * must be an iterable, not intTypeError: 'list' object is not a mapping
Cum o eviți pe viitor
- Reține regula:
*pentru liste și tupluri (poziții),**pentru dicționare (nume). - Când datele vin din JSON sau dintr-un API, afișează
type(date)înainte să le despachetezi. - Verifică funcțiile care construiesc dicționare să întoarcă mereu un dicționar, nu
Nonepe vreo ramură. - Pentru date structurate, un
dataclassconstruit cuClasa(**dictionar)îți dă erori clare dacă lipsesc sau prisosesc chei.
Întrebări frecvente
Ce înseamnă „mapping”?
Un obiect care asociază chei cu valori și are metodele keys() și __getitem__. Dicționarul e mapping-ul obișnuit; mai sunt collections.OrderedDict, ChainMap sau MappingProxyType.
Pot folosi ** cu o listă de perechi?
Nu direct. Transformă-o întâi: f(**dict([("nume", "Ana"), ("email", "a@x.ro")])).
Erori înrudite
TypeError: creeaza_cont() got an unexpected keyword argument 'email' Ai apelat o funcție cu un argument dat după nume (`email=...`), dar funcția nu are un parametru cu acel nume. Verifică scrierea exactă din `def` (sau din documentația bibliotecii) și folosește numele corect. TypeError: calculeaza_total() missing 1 required positional argument: 'cantitate' Ai apelat o funcție cu mai puține argumente decât parametri are. Mesajul îți spune și numele parametrului lipsă. Dă-i valoarea la apel sau, dacă parametrul e opțional, pune-i o valoare implicită în `def` (`cantitate=1`). SyntaxError: keyword argument repeated: pret Ai dat același argument cu nume de două ori în același apel, de exemplu f(pret=10, pret=12). Python nu știe pe care să-l păstreze, așa că refuză tot fișierul. Șterge dublura sau redenumește al doilea argument cu numele corect. Învață Python de la zero, cu exerciții la fiecare lecție
Curs Python: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
