Les tests unitaires sont essentiels pour garantir la fiabilité et la maintenabilité d’un code. En Python, le module unittest et des bibliothèques comme pytest facilitent l’écriture et l’exécution de tests unitaires. Cet article présente les meilleures pratiques pour écrire des tests unitaires efficaces en Python.

1. Utiliser un framework de test approprié

Python propose plusieurs frameworks de test, parmi lesquels :

• unittest (intégré à Python)
• pytest (plus concis et puissant)
• doctest (pour tester les exemples dans la documentation)

pytest est souvent recommandé pour sa simplicité et sa flexibilité.

2. Organiser les tests de manière structurée

Nommer correctement les fichiers et fonctions de test

• Utiliser le préfixe test_ pour les fichiers et les fonctions, par exemple :
  • test_math_operations.py
  • test_database.py

Séparer les tests du code source

• Placer les tests dans un répertoire dédié comme tests/.

3. Écrire des tests indépendants et isolés

• Chaque test doit être indépendant des autres.
• Utiliser setUp et tearDown dans unittest ou des fixtures avec pytest pour initialiser et nettoyer les ressources.

Exemple avec pytest :

import pytest

@pytest.fixture
def sample_data():
    return {"name": "Alice", "age": 30}

def test_sample_data(sample_data):
    assert sample_data["name"] == "Alice"
    assert sample_data["age"] == 30

4. Utiliser des assertions claires

Les assertions doivent être explicites et lisibles. pytest simplifie les assertions par rapport à unittest :

Avec unittest :

import unittest

class TestMath(unittest.TestCase):
    def test_addition(self):
        self.assertEqual(2 + 3, 5)

Avec pytest :

def test_addition():
    assert 2 + 3 == 5

5. Tester différents cas et scénarios

• Tester des entrées valides, invalides et aux limites.
• Utiliser pytest.mark.parametrize pour tester plusieurs valeurs.

import pytest

@pytest.mark.parametrize("a, b, expected", [(2, 3, 5), (-1, 1, 0), (0, 0, 0)])
def test_addition(a, b, expected):
    assert a + b == expected

6. Utiliser des mocks pour les dépendances externes

Les mocks permettent de tester une fonction sans exécuter ses dépendances réelles.

Exemple avec unittest.mock :

from unittest.mock import MagicMock

def fetch_data(api):
    return api.get("https://example.com/data")

def test_fetch_data():
    mock_api = MagicMock()
    mock_api.get.return_value = {"status": "success"}
    assert fetch_data(mock_api) == {"status": "success"}

7. Automatiser l’exécution des tests

Utiliser pytest avec un outil d’intégration continue (CI) comme GitHub Actions ou GitLab CI/CD pour exécuter les tests automatiquement à chaque modification.

Exécution des tests localement :

pytest

Conclusion

Les tests unitaires sont une bonne pratique essentielle pour assurer la robustesse d’un projet Python. En suivant ces meilleures pratiques – choisir un bon framework, organiser les tests proprement, écrire des assertions claires et utiliser des mocks – vous améliorerez la fiabilité et la maintenabilité de votre code.