AssertionError
O instrucțiune `assert conditie` a găsit condiția falsă. Asta înseamnă de obicei că un test a picat sau că o valoare nu e cea așteptată: citește condiția (și mesajul de după virgulă, dacă există) și repară codul testat, nu verificarea.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
assert conditie, "mesaj" e o verificare: dacă condiția e adevărată, nu se întâmplă nimic; dacă e falsă, Python ridică AssertionError, cu mesajul dat (sau fără mesaj). Se folosește în teste (pytest se bazează pe assert) și ca plasă de siguranță în cod, pentru situații care „nu ar trebui să apară niciodată”.
Când primești AssertionError, linia din traceback arată verificarea care a picat. Întrebarea e: condiția e greșită sau codul testat? Aproape mereu, codul testat. Pytest îți arată și valorile comparate (assert 190 == 180), ceea ce ajută mult. Atenție: assert nu e potrivit pentru validarea datelor de la utilizator, pentru că Python rulat cu -O elimină toate aserțiunile; acolo folosește if ...: raise ValueError(...). O capcană clasică: assert (x, "mesaj") cu paranteze e mereu adevărat, pentru că un tuplu nevid e adevărat.
De ce apare: cauzele frecvente
1Bug în funcția testată
def pret_final(pret, reducere):
return pret - reducere * 100
assert pret_final(200, 0.1) == 180, "10% din 200 trebuie să dea 180"def pret_final(pret, reducere):
return pret * (1 - reducere)
assert pret_final(200, 0.1) == 180, "10% din 200 trebuie să dea 180"
print("ok")Verificarea era corectă; formula greșită scădea 10 lei, nu 10%.
2Comparație exactă între numere zecimale
assert 0.1 + 0.2 == 0.3import math
assert math.isclose(0.1 + 0.2, 0.3)
print("ok")0.1 + 0.2 dă 0.30000000000000004. Pentru zecimale, compară cu o toleranță (math.isclose sau pytest.approx).
Repară eroarea, direct în pagină
Testul de mai jos verifică funcția pret_final, care aplică o reducere procentuală, și dă AssertionError: reducerea de 10% trebuie să dea 180. Repară formula din funcție (nu testul), ca programul să afișeze Testele au trecut.
def pret_final(pret, reducere):
return pret - reducere * 100
assert pret_final(200, 0.1) == 180, "reducerea de 10% trebuie să dea 180"
assert pret_final(50, 0.5) == 25, "reducerea de 50% trebuie să dea 25"
print("Testele au trecut")Testele au trecut
Indiciu
O reducere de 10% înseamnă că plătești 90% din preț.
Reparația
def pret_final(pret, reducere):
return pret * (1 - reducere)
assert pret_final(200, 0.1) == 180, "reducerea de 10% trebuie să dea 180"
assert pret_final(50, 0.5) == 25, "reducerea de 50% trebuie să dea 25"
print("Testele au trecut")De ce merge
Formula inițială scădea 0.1 * 100 = 10 lei din preț, indiferent de preț, așa că pentru 200 lei dădea 190. Testul avea dreptate. pret * (1 - reducere) calculează corect prețul după reducerea procentuală: 200 * 0.9 = 180 și 50 * 0.5 = 25, deci ambele aserțiuni trec.
Alte forme ale mesajului
AssertionError: reducerea de 10% trebuie să dea 180
Cum o eviți pe viitor
- Scrie un mesaj clar după virgulă, care spune ce se aștepta:
assert x > 0, f"x trebuie pozitiv, e {x}". - Folosește
assertpentru teste și invarianți interni, nu pentru validarea datelor de intrare. - Pentru numere zecimale, compară cu
math.isclosesaupytest.approx. - Nu pune paranteze în jurul întregului
assert:assert (cond, "mesaj")nu verifică nimic.
Întrebări frecvente
De ce AssertionError nu are niciun mesaj?
Pentru că assert a fost scris fără al doilea argument. Adaugă un mesaj după virgulă, sau folosește pytest, care afișează automat valorile comparate.
Pot folosi assert ca să verific ce introduce utilizatorul?
Nu e recomandat: rulat cu python -O, Python elimină toate aserțiunile, iar verificarea dispare. Pentru date de intrare, folosește if și raise ValueError(...).
Erori înrudite
TypeError: exceptions must derive from BaseException Ai dat lui `raise` ceva care nu e o excepție, de obicei un text: `raise "Fonduri insuficiente"`. Ridică o clasă de excepție cu mesajul ca argument, `raise ValueError("Fonduri insuficiente")`, iar excepțiile tale trebuie să moștenească din `Exception`. NotImplementedError Ai apelat o metodă care, în clasa de bază, doar ridică `NotImplementedError`, ca semn că fiecare subclasă trebuie s-o scrie. Implementează metoda în subclasa ta, cu exact același nume, sau creează obiectul din subclasa corectă. ZeroDivisionError: division by zero Ai împărțit la zero: împărțitorul unei operații `/`, `//` sau `%` e 0. Cel mai des e lungimea unei liste goale (media fără note) sau un contor rămas 0. Verifică împărțitorul înainte (`if n != 0`) sau prinde eroarea cu `try/except ZeroDivisionError`. Î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.
