Forum Programmation.python Pyment: patcher les docstrings Python

Posté par  . Licence CC By‑SA.
3
14
mar.
2014

Voici Pyment, une application Python qui permet de générer des patches sur du code Python pour ajouter ou modifier des docstrings.
Vous pouvez par exemple remplacer/harmoniser toutes les docstrings d'un projet par des docstrings dans un format particulier (reST pour Sphinx, Google style, javadoc style).

Voici le projet:

https://github.com/dadadel/pyment

Il est possible de spécifier un fichier python ou un dossier qui sera parsé (avec ses sous-dossiers) à la recherche de fichiers Python. Pour chaque fichier un patche sera généré.

Pyment reconnaît automatiquement pour chaque docstring son style et effectue la conversion si nécessaire.
Il ajoute également les valeurs par défaut s'il y en a et qu'elles ne sont pas mentionnées. Si une fonction n'a pas de docstring il en créée une (un squelette).

Il s'agit d'une première version alpha. Si ça vous intéresse, n'hésitez pas à la tester et faire des critiques.

Suivre le flux des commentaires

Note : les commentaires appartiennent à celles et ceux qui les ont postés. Nous n’en sommes pas responsables.