URL: https://linuxfr.org/users/dadadel/journaux/pyment-patcher-les-docstrings-python
Title: Pyment: patcher les docstrings Python
Authors: dadadel
Date: 2014年03月14日T10:41:47+01:00
License: CC By-SA
Tags: google, python, patch, docstring, javadoc, rest et sphinx
Score: 17
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.
</div><div class="naked_ctrl">
<form action="/index.cgi/contrast" method="get" name="gate">
<p><a href="http://altstyle.alfasado.net">AltStyle</a> によって変換されたページ <a href="httpS://linuxfr.org/users/dadadel/journaux/pyment-patcher-les-docstrings-python.md">(-&gt;オリジナル)</a>
/ <label>アドレス: <input type="text" name="naked_post_url" value="httpS://linuxfr.org/users/dadadel/journaux/pyment-patcher-les-docstrings-python.md" size="22" /></label> <label>モード: <select name="naked_post_mode">
<option value="default">デフォルト</option>
<option value="speech">音声ブラウザ</option>
<option value="ruby">ルビ付き</option>
<option value="contrast" selected="selected">配色反転</option>
<option value="larger-text">文字拡大</option>
<option value="mobile">モバイル</option>
</select>
<input type="submit" value="表示" />
</p>
</form>
</div>