Bonjour,
je viens de créer une petite classe de bufferisation en python et dans le but de m'entraîner à commenter, je l'ai donc commenté en utilisant la javadoc. Néanmoins, je me suis rapidement heurté au problème que les commentaires de type : /** * */ n'existe pas en python, je les ai donc modifié par des commentaires de la sorte : """ * """.
Néanmoins, dans les deux cas, mon IDE (Geany), me montre rien des commentaires (que ce soit le début, ou les @return, @param et @see), j'aimerais donc savoir s'il existe une méthode bien spécial de documenter son code python... et surtout, que cette technique soit reconnue par les IDE (Afin d'éviter d'avoir à me replonger dedans).
Merci d'avance !

Oui, les docstring.

Merci ! Néanmoins, celle-ci semble moins puissant que la javadoc, je vais me renseigner !

Citation : jb1993

Merci ! Néanmoins, celle-ci semble moins puissant que la javadoc, je vais me renseigner !

Tu peux générer automatiquement des tests unitaires à partir des exemples écrits dans la javadoc d'une fonction donnée, par exemple ?
Avec les docstrings, en tout cas, oui, et nativement…