Comment utiliser l’instruction assert en Python

L’instruction assert en Python sert à établir des vérités fondamentales dans votre code. Elle permet aux développeurs de valider leurs hypothèses au sein du programme. Dans ce tutoriel, nous allons maîtriser l’instruction assert de Python : sa syntaxe, ses usages et ses applications pour le débogage et la détection d’erreurs. En la maîtrisant, vous ferez un pas de plus vers l’expertise de Python Programmer. 

La réponse courte : écrire des assertions en Python 

La syntaxe de l’instruction assert est directe :

assert condition, message

Ici, condition est l’expression testée, tandis que message est un message d’erreur facultatif qui s’affiche si l’assertion échoue.

Voici quelques assertions à essayer dans votre code Python pour vous familiariser. Dans le premier cas, l’expression 3<4>5 est logiquement incorrecte, donc Python lève une exception AssertionError avec le message fourni : "Math does not work that way." Dans le second cas, l’expression 0==0 est une tautologie, donc le message "This shouldn't throw an error." n’apparaît jamais. 

assert 3<4>5, "Math does not work that way."

assert 0==0, "This shouldn't throw an error."

Vue d’ensemble de l’instruction assert de Python

Regardons de plus près l’instruction assert de Python : comment et pourquoi l’utiliser. À la fin de ce tutoriel, vous saurez parfaitement utiliser assert en Python. 

Qu’est-ce qu’une assertion en Python ?

De manière générale, les assertions en programmation sont des constructions permettant de vérifier la véracité de certaines conditions dans le code. Autrement dit, ce sont des vérités auxquelles le programme doit se conformer, faute de quoi une erreur est levée. En utilisant le mot‑clé "assert", Python implémente ces assertions avec une syntaxe très explicite : l’instruction assert nous permet de les formuler.

Quand utiliser les assertions en Python

Les assertions sont précieuses pour le débogage, la validation des hypothèses et pour garantir que votre code se comporte comme prévu dans des conditions données. Elles vous permettent d’indiquer à l’ordinateur ce que vous attendez et de lui demander de s’arrêter lorsqu’il se comporte différemment. C’est utile lors de la création d’un nouveau programme, de l’ajout d’une fonctionnalité ou de la mise à jour d’une application existante.

Les assertions excellent lorsqu’il faut imposer des préconditions, postconditions ou invariants au sein d’une base de code. Elles jouent le rôle de garde‑fous : si certaines conditions sont violées, l’exécution s’interrompt, ce qui aide à détecter les bogues tôt.

En plaçant stratégiquement des assertions dans le code, vous pouvez intercepter les erreurs au plus près de leur origine et simplifier le débogage. Le parcours Python Developer de DataCamp est idéal pour s’exercer à la programmation fonctionnelle, avec des exercices allant des bases aux concepts plus avancés.

Quand ne pas utiliser les assertions en Python

Bien qu’elles soient très utiles pendant le développement, il existe des situations où leur usage est inapproprié.

Il est essentiel de comprendre qu’en production, les assertions peuvent être désactivées globalement. Vous ne devez donc pas compter sur elles pour gérer des problèmes à l’exécution, comme une saisie utilisateur invalide. Elles doivent servir à traiter des problèmes de développement, par exemple des erreurs de logique ou de calcul.

Pour gérer les erreurs ou valider des données en production, privilégiez la gestion d’exceptions pour permettre au code de se rétablir proprement, d’enregistrer les informations utiles au débogage et de fournir un retour pertinent aux utilisateurs.

Pour en savoir plus sur la détection et la correction des erreurs, consultez notre tutoriel Exception and Error Handling in Python ou suivez notre cours Associate Data Scientist in Python. 

Erreurs fréquentes et idées reçues avec l’instruction assert en Python

Une erreur fréquente avec assert en Python consiste à utiliser des parenthèses. C’est compréhensible, car beaucoup de fonctions en utilisent et le réflexe est vite pris. Cependant, assert n’est pas, à proprement parler, une fonction en Python : sa syntaxe est spécifique. Si vous mettez des parenthèses, vous obtiendrez probablement des avertissements de syntaxe et des erreurs logiques.

SyntaxWarning: assertion is always true, perhaps remove parentheses?

Autre erreur courante : oublier la virgule après la condition. Cela provoquera une erreur de syntaxe.

SyntaxError: invalid syntax

L’exception AssertionError

Une exception AssertionError est levée à chaque fois que les termes d’une assertion sont violés. Cette erreur interrompt l’exécution du programme ; tout message d’erreur facultatif que vous avez défini est alors affiché. Comme les assertions servent principalement à tester votre code pendant le développement, si vous obtenez une exception AssertionError en Python, prenez‑la généralement au sérieux : elle peut révéler un défaut critique dans votre code.

Applications pratiques

Une instruction assert peut servir dans de nombreuses situations concrètes en Python. Notre cours interactif Writing Functions in Python propose de nombreux exercices pour gagner en maîtrise. Voici deux exemples. 

Utiliser assert dans une fonction

Une approche utile consiste à insérer des assertions dans vos fonctions. Cela permet de s’assurer qu’elles se comportent comme prévu.

def divide(a, b):
    assert b != 0, "Division by zero!"
    return a / b

# Cas de test
print(divide(10, 2))  # Output: 5.0
print(divide(8, 0))   # AssertionError: Division by zero!

Utiliser assert avec unittest

Tester votre code est une étape essentielle du processus de développement. Unittest est une bibliothèque conçue pour faciliter les tests et elle s’appuie sur des assertions pour ce faire. C’est d’ailleurs la façon dont j’utilise le plus souvent assert. Voici un exemple comme vous pourriez en trouver dans notre cours Introduction to Testing in Python. 

import unittest

class TestMathFunctions(unittest.TestCase):
    def test_addition(self):
        self.assertEqual(2 + 2, 4)

    def test_subtraction(self):
        self.assertEqual(5 - 3, 2)

    def test_division(self):
        self.assertRaises(ZeroDivisionError, divide, 10, 0)

if __name__ == '__main__':
    unittest.main()

Conclusion