Accueil › Python › Lever une exception, et définir les siennes
Lever une exception, et définir les siennes
Erreurs et testsintermediaire
raise signale un échec. On lève une instance d'exception, avec un message qui dit ce qui s'est passé :
def appliquer_remise(total: float, pourcentage: float) -> float:
if not 0 <= pourcentage <= 100:
raise ValueError(f"remise hors bornes : {pourcentage}")
return total * (1 - pourcentage / 100)
Quand aucun type intégré ne décrit votre cas métier, définissez le vôtre :
class ErreurBoutique(Exception):
"""Racine de toutes les erreurs métier de la boutique."""
class StockInsuffisant(ErreurBoutique):
pass
Deux lignes suffisent : Exception fournit déjà le constructeur, le message et __str__. L'intérêt n'est pas de « faire propre », c'est que l'appelant puisse écrire except StockInsuffisant: au lieu de tester le texte du message — un test qui casserait à la première reformulation.
Quand vous traduisez une erreur technique en erreur métier, gardez le lien avec from :
try:
ligne = catalogue[reference]
except KeyError as e:
raise ProduitInconnu(f"référence {reference} absente du catalogue") from e
La traceback affichera les deux exceptions, avec la phrase « The above exception was the direct cause of the following exception ». L'appelant voit un message métier ; vous gardez la trace technique pour le diagnostic.
Les termes à connaître
- `raise`
Lève une exception. On lève une instance (
raise ValueError("…")) ;raise ValueErrortout court fonctionne aussi, Python instancie alors la classe sans argument, donc sans message.- `raise` nu
À l'intérieur d'un
except, unraisesans argument re-lève l'exception en cours en conservant sa traceback d'origine. C'est la bonne façon de journaliser puis de laisser remonter.- Exception personnalisée
Une classe qui hérite de
Exceptionet porte un nom métier (StockInsuffisant). Elle permet à l'appelant d'attraper ce cas précis au lieu d'inspecter un message texte.- Chaînage explicite (`raise … from e`)
Renseigne
__cause__: la traceback affiche « The above exception was the direct cause of the following exception ». À utiliser quand vous traduisez une erreur technique en erreur métier.- Chaînage implicite
Toute exception levée à l'intérieur d'un
exceptconserve automatiquement la précédente dans__context__. La traceback affiche alors « During handling of the above exception, another exception occurred ».- `from None`
raise X from Nonesupprime l'affichage de l'exception d'origine. Utile pour une erreur destinée à l'utilisateur final, dangereux dans du code interne : vous jetez l'information qui permettait le diagnostic.- Exception de base applicative
Une classe racine propre au projet (
class ErreurBoutique(Exception)) dont héritent toutes les autres. L'appelant peut ainsi écrireexcept ErreurBoutiquepour attraper « tout ce qui vient de notre code » sans attraper le reste.
Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.