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ă.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
NotImplementedError e excepția prin care o clasă de bază spune „această metodă trebuie implementată de subclase”. De exemplu, Forma.arie() ridică NotImplementedError, iar Patrat și Cerc o suprascriu cu formula lor. Dacă apelezi arie() pe un obiect a cărui clasă nu a suprascris metoda, ajungi la versiunea din bază și primești excepția.
Cauzele obișnuite: ai uitat să scrii metoda în subclasă, ai scris-o cu alt nume (aria în loc de arie), ai greșit numărul de parametri, sau ai creat obiectul direct din clasa de bază. Apare și în biblioteci: unele funcții nu sunt disponibile pe un anumit sistem sau backend și ridică NotImplementedError cu un mesaj explicativ. Pentru o verificare mai timpurie, poți folosi abc.ABC și @abstractmethod: atunci obiectul nici nu poate fi creat fără implementare.
De ce apare: cauzele frecvente
1Metodă scrisă cu alt nume
class Forma:
def arie(self):
raise NotImplementedError
class Patrat(Forma):
def aria(self):
return 9
Patrat().arie()class Forma:
def arie(self):
raise NotImplementedError
class Patrat(Forma):
def arie(self):
return 9
print(Patrat().arie())Doar o metodă cu exact același nume suprascrie metoda din bază.
2Obiect creat din clasa de bază
class Notificare:
def trimite(self, mesaj):
raise NotImplementedError("Folosește Email sau SMS")
Notificare().trimite("Salut")class Notificare:
def trimite(self, mesaj):
raise NotImplementedError("Folosește Email sau SMS")
class Email(Notificare):
def trimite(self, mesaj):
print("Email:", mesaj)
Email().trimite("Salut")Clasa de bază e doar un șablon. Obiectele se creează din subclasele care implementează metoda.
Repară eroarea, direct în pagină
Clasa Patrat de mai jos ar trebui să calculeze aria, dar Patrat(3).arie() dă NotImplementedError: Subclasele trebuie să implementeze arie(). Repară subclasa, ca programul să afișeze 9.
class Forma:
def arie(self):
raise NotImplementedError("Subclasele trebuie să implementeze arie()")
class Patrat(Forma):
def __init__(self, latura):
self.latura = latura
def aria(self):
return self.latura ** 2
print(Patrat(3).arie())9
Indiciu
Compară numele metodei din Patrat cu cel din Forma.
Reparația
class Forma:
def arie(self):
raise NotImplementedError("Subclasele trebuie să implementeze arie()")
class Patrat(Forma):
def __init__(self, latura):
self.latura = latura
def arie(self):
return self.latura ** 2
print(Patrat(3).arie())De ce merge
Patrat definea o metodă nouă, aria, în loc să suprascrie arie. Apelul arie() ajungea la versiunea din Forma, care ridică NotImplementedError. Cu numele corect, metoda din Patrat o înlocuiește pe cea din bază și întoarce 3 ** 2 = 9.
Alte forme ale mesajului
NotImplementedError: Subclasele trebuie să implementeze arie()
Cum o eviți pe viitor
- Pentru clasele de bază, folosește
abc.ABCcu@abstractmethod: Python refuză crearea obiectelor care nu implementează metoda. - Folosește decoratorul
@override(dintyping, Python 3.12+), ca verificatorul de tipuri să semnaleze o metodă care nu suprascrie nimic din cauza unui nume greșit. - Pune un mesaj clar în
NotImplementedError, care spune ce trebuie implementat.
Întrebări frecvente
Care e diferența dintre NotImplementedError și NotImplemented?
NotImplementedError e o excepție, pentru metode neimplementate. NotImplemented e o valoare specială pe care o întorc metodele de comparație sau operatorii (__eq__, __add__) când nu știu să trateze tipul primit. raise NotImplemented dă TypeError.
E mai bine NotImplementedError sau @abstractmethod?
@abstractmethod prinde problema mai devreme, la crearea obiectului (TypeError: Can't instantiate abstract class). NotImplementedError e mai simplu și apare doar când apelezi metoda.
Erori înrudite
TypeError: Can't instantiate abstract class Cerc without an implementation for abstract method 'arie' Încerci să creezi un obiect dintr-o clasă care moștenește o clasă abstractă (`ABC`), dar nu a implementat toate metodele marcate cu `@abstractmethod`. Scrie metoda lipsă în clasa copil, cu exact același nume, sau creează obiecte doar din clasele complete. AttributeError: 'Produs' object has no attribute 'pret' Obiectul clasei tale nu are atributul cerut: nu l-ai setat în `__init__` cu `self.`, l-ai scris diferit sau `__init__` e scris greșit și nu rulează. Verifică să ai `self.pret = pret` în `__init__` (cu două liniuțe de fiecare parte) și același nume peste tot. 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`. Î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.
