Lancer le diaporama

1. Le cadre

• Tests
  • Surveiller le bon fonctionnement du programme
  • Automatisation
• Documentation
  • Décrire le fonctionnement du programme au travers d’exemples
  • Dans le même fichier
• En Python, les doctests sont de la documentation exécutable et vérifiable.

2. Docstrings

• Ouvrir le modèle dans un nouvel onglet et le télécharger.
• Noter que les docstrings doivent apparaître à certains endroits précis pour être attachés à ce que vous voulez. Voir la documentation officielle, le PEP 257.
• Les doctests sont en fait des docstrings dans lesquelles Python va chercher des tests. Voir la documentation officielle. Voyons en détail…

3. Doctests

• Ouvrir le modèle dans un nouvel onglet et le télécharger.
• Attention à ne pas renommer un fichier doctest.py :
  • garder le « s »,
  • ne pas nommer votre fichier (ou un autre dans le même dossier) :
    doctest.py,
  • sinon c’est lui qui sera importé.

4. Principe

• Une fonction contient :
  • sa docstring,
    • qui peut contenir un ou plusieurs doctests,
    • indiqués par des >>> (comme une session interactive),
  • l’implémentation à tester.
• En fin de fichier, on déclenche les tests.

5. Détail d’un échec

**********************************************************************
File "input/squelettes/doctests.py", line 5, in __main__
Failed example:
    add(2, 2)
Expected:
    5
Got:
    4
**********************************************************************
1 items had failures:
   1 of   1 in __main__
***Test Failed*** 1 failures.

6. Un autre échec

• Si le test échoue avec Got nothing,
• c’est que votre fonction ne retourne
• rien, il faut utiliser le mot-clef return.

7. Ne pas oublier

• TDD Test Driven Development
  • Écrire un test,
    • Exécuter le fichier, la fonction ne sera pas trouvée.
  • Créer la fonction, retournant une fausse valeur,
    • Exécuter le fichier, le test va échouer.
  • Travailler la fonction,
    • Jusqu’à ce que le test passe.
• Sinon, penser à vérifier de temps en temps que les tests sont bien effectués.

8. Un peu d’humour