Figer, nettoyer, structurer et faire évoluer un module sans rien casser.
Scénario
Tu reprends facturation.py, un module de HashBox de 120 lignes sans tests : calcul de remises, TVA, arrondis, texte de facture, envoi par e-mail et écriture en base, le tout dans deux grosses fonctions. Maya demande une nouvelle règle (remise « fidélité ») pour la semaine prochaine.
Objectif
Mettre le module sous tests de caractérisation, le refactorer par petits pas vers une architecture à forte cohésion et faible couplage, puis ajouter la règle demandée sans toucher à l'infrastructure.
Environnement
Python 3.10 ou plus. Modules standard. Git recommandé : un commit par pas de refactoring.
État de départ
Tu écris toi-même facturation_legacy.py en respectant le cahier des charges ci-dessus (volontairement mal conçu : noms obscurs, nombres magiques, effets de bord, dépendances en dur).
Tâches
- Écris
facturation_legacy.py(deux fonctions longues, une connexion SQLite en dur, unprintpour l'e-mail). - Écris 25 tests de caractérisation qui figent sa sortie sur des cas variés (graine fixe).
- Mesure complexité, longueur et imbrication avec l'outil d'audit.
- Refactore en au moins 10 petits pas : constantes, extraction de fonctions, séparation calcul/présentation/persistance, objets-valeurs, injection du dépôt et de la messagerie.
- Après chaque pas, relance les tests et note le pas dans un journal.
- Introduis une interface
DepotetMessagerie(Protocol), avec un fake pour les tests et une version SQLite. - Ajoute la règle « remise fidélité » en suivant la règle des deux chapeaux (nouveau commit, nouveaux tests).
- Fais relire ton code à une autre personne (ou relis-le après une pause) avec la checklist de revue et corrige les remarques bloquantes.
- Rédige un ADR pour la décision d'architecture la plus importante, et un registre de dette de 5 entrées.
Observations attendues
- Les 25 tests de caractérisation passent avant et après le refactoring.
- La complexité maximale baisse nettement (par exemple de plus de 12 à moins de 5).
- Le calcul des remises et de la TVA se teste sans base ni e-mail.
- La règle de fidélité s'ajoute en modifiant un seul module.
- Le journal de refactoring montre des pas petits et vérifiés.
Validation
python -m unittest (ou pytest) passe ; l'audit avant/après est reproduit ; une personne extérieure peut lire le journal et comprendre chaque pas.
Indices
💡 Indice 1
Fige d'abord la sortie complète (texte de facture + effets de bord enregistrés).
💡 Indice 2
Commence par les refactorings qui ne changent aucune signature publique.
💡 Indice 3
Sépare le calcul (fonctions pures) de ce qui touche au monde extérieur.
Preuves à rendre
- Code avant/après et journal de refactoring
- Tests de caractérisation et tests unitaires nouveaux
- Rapport d'audit avant/après
- ADR et registre de dette
Réflexion
- Quel pas de refactoring t'a donné le plus de confiance ?
- Qu'est-ce qui a été difficile à tester au départ, et pourquoi ?
HEF-080 — Génie logiciel
Atelier Python

