• [^] # Re: No comment

    Posté par . En réponse au journal Toileharicot 12 est dehors. Évalué à 9.

    Il y a même un langage dont la doc inline peut contenir une portion de code qui sera exécutable, mais j'ai pas pu retrouver où j'avais vu ça.

    C'est peut-être Python et ses doctests.
    Et c'est trop trop trop badass.
    Ça remplace pas les frameworks de test mais ça permet d'avoir des exemples dans ta doc qui s'exécutent comme des TU.

    Par exemple :

     def combi1(n):
 """
 n : (int) un entier qui ne sert à rien
 retour : (int) la valeur de 1.
 Exemples :
 >>> combi1(42)
 1
 >>> combi1(33)
 1
 >>> combi1(666)
 1
 """
 return 1

    Avec doctest, les exemples de ta documentation sont toujours bon car ils sont utilisés comme des TU (très simple).
    python -m doctest
    pour les lancer

    https://en.wikipedia.org/wiki/Doctest

    https://docs.pytest.org/en/stable/doctest.html

    https://docs.python.org/fr/3.10/library/doctest.html