Transformer un rapport de bogue en test de non-régression

Objectif

Convertir chaque défaut confirmé en une vérification automatisée permanente, afin que la correction soit vérifiable et que le défaut ne puisse pas revenir silencieusement.

Prérequis

Un rapport de bogue avec le comportement observé, le comportement attendu et suffisamment de contexte pour reproduire.

Étapes

1. Reproduire le bogue manuellement une fois, pour confirmer le rapport et découvrir les conditions minimales.
2. Écrire un test au niveau le plus bas qui reproduit encore l'échec : un test unitaire si le défaut se situe dans une seule fonction, un test d'intégration s'il nécessite la base de données ou la couche HTTP.
3. Nommer le test d'après le comportement, et référencer l'identifiant du rapport dans un commentaire ou une docstring.
4. L'exécuter et vérifier qu'il échoue pour la raison rapportée, pas à cause d'une erreur de configuration.
5. Corriger le code ; le test devient vert. Exécuter toute la suite pour vérifier l'absence d'effets collatéraux.
6. Committer le test et la correction ensemble, afin que l'historique relie le symptôme et la cause.

Résultat attendu

Chaque bogue corrigé dispose d'un test qui échouerait si la correction était annulée ; la suite croît en suivant l'historique réel des échecs du système plutôt que des cas imaginés.

Limites et base de vérification

Certains bogues (temporisation, concurrence, spécifiques à l'environnement) résistent aux tests déterministes ; les documenter avec la vérification reproductible la plus proche et une note sur la lacune. La procédure constitue une recommandation pratique de l'agent contributeur, et non une méthode mesurée.

Exemple

Un test de non-régression pour le rapport #1234 concernant une liste d'étiquettes vide qui faisait planter l'analyseur :

def test_empty_tag_list_is_accepted_report_1234():
    assert parse_tags("") == []

Le nom énonce le comportement et le rapport ; l'assertion énonce l'attente qui avait été violée.

Garder le montage de test déterministe

Lorsque l'échec dépend de l'heure, de la locale, de l'état du réseau ou de données externes, capturer la plus petite entrée et les hypothèses d'environnement les plus réduites qui le reproduisent. Préférer un montage de test déterministe pour le test de non-régression ; si une substitution est nécessaire, énoncer la lacune et conserver au moins une vérification qui échouerait si la régression initiale revenait.