Qu’est-ce qu’un contrat logiciel dans un projet NSI ?
Réponse courte
Un contrat logiciel décrit précisément ce qu’une fonction reçoit, ce qu’elle doit renvoyer et comment elle traite les cas particuliers. Il permet à l’équipe d’écrire et de tester des modules compatibles.
Comprendre
Décrire le comportement attendu
Un contrat précise les entrées, le résultat attendu, les erreurs possibles et les limites d’une fonction. Il se formule du point de vue de son usage, sans imposer d’emblée le choix d’une classe ou d’une structure de code. Chaque membre de l’équipe peut ainsi comprendre ce que le programme promet.
Rendre la promesse vérifiable
Pour une fonction qui cherche un itinéraire dans un graphe, on peut préciser qu’elle reçoit un graphe non orienté et deux sommets, puis renvoie une liste représentant un chemin de longueur minimale ou une valeur distincte si aucun chemin n’existe. Le contrat indique aussi quoi faire si un sommet est inconnu. Un test peut contrôler les arêtes du chemin et son nombre de passages.
Prévoir les cas limites
Si le départ et l’arrivée sont le même sommet, une liste contenant ce sommet décrit un chemin de longueur nulle. Si deux itinéraires ont le même nombre minimal de passages, les deux réponses conviennent : le contrat ne doit pas exiger une liste unique sans raison. Un nom absent du graphe doit suivre la règle annoncée, plutôt que provoquer un comportement laissé au hasard.
Exemples
- Pour A–B–C, une recherche de A vers C peut renvoyer [A, B, C] : les deux paires successives sont des arêtes et le chemin compte deux passages.
- Si D est isolé de A, la fonction renvoie la valeur prévue pour l’absence de chemin, par exemple None, conformément au contrat.
- Dans un graphe avec deux chemins minimaux de A à C, chacun peut être accepté si le contrat exige seulement une longueur minimale.
Pièges fréquents
- Confondre contrat et choix d’implémentation : imposer une classe Python décrit un moyen technique, pas le comportement attendu de la fonction.
- Exiger toujours exactement la même liste de sommets peut rejeter un autre chemin tout aussi court et valide.
Pourquoi ça marche
Un contrat partagé sert d’interface entre les modules : on peut tester séparément le calcul et l’affichage tant que chacun respecte les mêmes entrées et sorties.
