Création d’un script documenté (avec des docstrings)
Script « script_documente.py » :
"""module permettant à partir de deux nombres nb1 et nb2 d'exécuter les quatre opérations fondamentales""" def addition (nb1, nb2) : """fonction de l'addition""" print (nb1, "+", nb2, "=", nb1+nb2) def soustraction (nb1, nb2) : """fonction de la soustraction""" print (nb1, "-", nb2, "=", nb1-nb2) def multiplication (nb1, nb2) : """fonction de la multiplication""" print (nb1, "X", nb2, "=", nb1*nb2) def division (nb1, nb2) : """fonction de la division""" print (nb1, "/", nb2, "=", nb1/nb2)
Les docstrings s’écrivent entre 2 triples doubles guillemets
"""docstring"""
Exécution via F5 et appel de l’aide help ( ) :
>>> help ("script_documente") Help on module script_documente: NAME script_documente DESCRIPTION module permettant à partir de deux nombres nb1 et nb2 d'exécuter les quatre opérations fondamentales FUNCTIONS addition(nb1, nb2) fonction de l'addition division(nb1, nb2) fonction de la division multiplication(nb1, nb2) fonction de la multiplication soustraction(nb1, nb2) fonction de la soustraction FILE c:\users\fabricedumont\desktop\script_documente.py >>>
Vous pouvez donc documenter votre script en général ainsi que toutes vos fonctions
Exécution avec appel des fonctions :
>>> addition (10,3) 10 + 3 = 13 >>> division (10,4) 10 / 4 = 2.5 >>> multiplication (4,8) 4 X 8 = 32 >>> soustraction (45,6) 45 - 6 = 39 >>>