Maîtrise des tests et de la documentation en Python

📋 Plan du Cours

1. Documentation chaîne en Python
2. Tests unitaires et assert
3. Jeux de tests pertinents
4. Débogage et débogueur
5. Tests avant codage
6. Intégration doctest
7. Programmation défensive
8. Correction d’erreurs
9. Rédaction de tests efficaces
10. Vérification de programme

📖 1. Documentation chaîne en Python

🔑 Notions clés & Définitions

• Chaîne de documentation (docstring) :
  Une chaîne de caractères placée en début de fonction, entourée de triples guillemets, qui décrit le rôle, les paramètres, et les valeurs de retour d'une fonction.
  Exemple :

  def somme(a, b):  
      """Renvoie la somme de a et b."""  
      return a + b
  

• help() :
  Fonction Python permettant d’afficher la documentation d’un objet (fonction, classe, module) en consultant sa docstring.
  Exemple :

  help(somme)
  

• Assertions (assert) :
  Instruction permettant de vérifier qu’une condition est vraie ; si elle est fausse, elle lève une erreur AssertionError. Utile pour la programmation défensive.
  Exemple :

  assert x > 0, "x doit être positif"
  

• Jeux de tests :
  Ensemble de cas d’utilisation écrits pour vérifier le comportement d’une fonction. Ils permettent de détecter des erreurs et de valider la correction du code.
  Exemple :

  assert appartient([1, 2, 3], 2) == True