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.
# Journal ?
Posté par Jiehong (site web personnel) . Évalué à 2.
Pour une fois, je pense que cette entrée de forum aurait sa place dans un journal.
Qu'en penses-tu ?
[^] # Re: Journal ?
Posté par dadadel . Évalué à 1.
En effet ça pourrait y avoir sa place mais je n'osais pas :)
Je le mets tel quel ?
[^] # Re: Journal ?
Posté par dadadel . Évalué à 2.
c'est fait: http://linuxfr.org/users/dadadel/journaux/pyment-patcher-les-docstrings-python
Suivre le flux des commentaires
Note : les commentaires appartiennent à celles et ceux qui les ont postés. Nous n’en sommes pas responsables.