...
Eroare Python · Funcții, clase și argumente

TypeError: __main__.creeaza_cont() argument after ** must be a mapping, not list

Pe scurt

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 **

Greșit
PYTHON
def creeaza_cont(nume, email):
    return f"{nume} <{email}>"

date = ["Ana", "ana@exemplu.ro"]
print(creeaza_cont(**date))
Corect
PYTHON
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

Greșit
PYTHON
import json

def creeaza_cont(nume, email):
    return nume

date = json.loads('[{"nume": "Ana", "email": "a@x.ro"}]')
print(creeaza_cont(**date))
Corect
PYTHON
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

Greșit
PYTHON
def suma(*numere):
    return sum(numere)

print(suma(*5))
Corect
PYTHON
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ă tu

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).

Codul care dă eroarea
PYTHON
def creeaza_utilizator(nume, email):
    return f"{nume} ({email})"

date = ["Ana Pop", "ana@exemplu.ro"]
print(creeaza_utilizator(**date))
După reparație, programul afișează
Ana Pop (ana@exemplu.ro)
Indiciu

Datele sunt o listă de valori în ordinea parametrilor, nu perechi nume: valoare.

Alte forme ale mesajului

  • TypeError: creeaza_cont() argument after ** must be a mapping, not list
  • TypeError: creeaza_cont() argument after ** must be a mapping, not NoneType
  • TypeError: suma() argument after * must be an iterable, not int
  • TypeError: '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 None pe vreo ramură.
  • Pentru date structurate, un dataclass construit cu Clasa(**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

← Toate erorile Python

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Î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.