Formations — 1 037 leçons en français

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 ValueError tout court fonctionne aussi, Python instancie alors la classe sans argument, donc sans message.

`raise` nu

À l'intérieur d'un except, un raise sans 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 Exception et 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 except conserve 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 None supprime 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 écrire except ErreurBoutique pour attraper « tout ce qui vient de notre code » sans attraper le reste.

Lire l'explication détaillée et faire le quiz →

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.