Formations — 1 037 leçons en français

Accueil › Python › Écrire des tests avec pytest

Écrire des tests avec pytest

Erreurs et testsintermediaire

Un test est une fonction qui appelle votre code et vérifie le résultat avec assert. Dans un fichier nommé test_panier.py :

from boutique.panier import total

def test_total_panier_vide_vaut_zero():
    assert total([]) == 0

def test_total_additionne_prix_fois_quantite():
    lignes = [Ligne(prix=10.0, quantite=2), Ligne(prix=5.0, quantite=1)]
    assert total(lignes) == 25.0

Puis pytest en ligne de commande. C'est tout : pas de classe à hériter, pas de assertEqual. pytest réécrit les assert pour afficher les valeurs en jeu lors d'un échec :

E       assert 24.0 == 25.0
E        +  where 24.0 = total([Ligne(prix=10.0, quantite=2), …])

Trois conventions, et elles ne sont pas négociables parce que la découverte en dépend : le fichier s'appelle test_*.py, la fonction commence par test, et la classe éventuelle commence par Test. Un fichier mal nommé n'est pas exécuté, sans le moindre message.

Pour vérifier un échec attendu :

import pytest

def test_retirer_plus_que_le_stock_echoue():
    with pytest.raises(StockInsuffisant, match="3 disponibles"):
        retirer("ref-1", stock=3, quantite=5)

Un bon nom de test décrit le comportement attendu, pas la méthode appelée : test_total_panier_vide_vaut_zero se lit comme une spécification. test_total_1 ne dit rien, et quand il casse, il faut lire le code pour savoir ce qu'on a perdu.

Les termes à connaître

pytest

L'outil de test le plus utilisé de l'écosystème Python. Il découvre les tests, les exécute et affiche les échecs. Il n'est pas dans la bibliothèque standard : pip install pytest.

`assert`

Le mot-clé Python standard : assert condition lève AssertionError si la condition est fausse. pytest réécrit ces assertions pour afficher les valeurs comparées, ce qui rend inutiles les assertEqual et compagnie.

Découverte des tests

pytest collecte les fichiers test_*.py ou *_test.py, et dans ceux-ci les fonctions dont le nom commence par test, ainsi que les classes Test* (sans __init__). Un fichier mal nommé n'est pas exécuté — et ne signale rien.

`pytest.raises`

Gestionnaire de contexte qui vérifie qu'un bloc lève bien l'exception attendue : with pytest.raises(ValueError):. L'argument match= compare le message à une expression régulière.

Fixture

Une fonction décorée par @pytest.fixture qui prépare un objet. Un test qui déclare son nom en paramètre le reçoit. Elle factorise la préparation sans créer d'état partagé entre tests.

conftest.py

Fichier de configuration local : les fixtures qu'il définit sont disponibles dans tout son répertoire et ses sous-répertoires, sans import. Sa présence ajoute aussi la racine du projet aux chemins d'import.

Arranger / Agir / Vérifier

La structure d'un bon test : on prépare les données, on appelle une fois ce qu'on teste, on vérifie le résultat. Trois temps visibles rendent le test lisible en dix secondes.

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.