documenting code python pycharm docstring doctest

python - code - Trozos de docstring personalizados de PyCharm(es decir, para formatos google docstring o numpydoc)



pycharm docstring (3)

Con PyCharm 5.0 finalmente conseguimos seleccionar Google y las plantillas de NumPy Style Python Docstrings .

También se menciona en la whatsnew sección de PyCharm 5.0.

Cómo cambiar el formato de Docstring:

Archivo -> Configuración -> Herramientas -> Herramientas integradas de Python

Allí puede elegir entre los formatos de Docstrings disponibles:

Plain, Epytext, reStructuredText, NumPy, Google

Como lo señala jstol: para usuarios de Mac, esto está bajo

PyCharm -> Preferencias -> Herramientas -> Herramientas integradas de Python.

¿PyCharm 2.7 (o PyCharm 3) tiene soporte para docstring personalizado y doctest stubs? Si es así, ¿cómo se puede escribir este tipo específico de extensión personalizada?

Mi proyecto actual se ha estandarizado al utilizar la Guía de estilo de Google Python ( http://google-styleguide.googlecode.com/svn/trunk/pyguide.html ). Me encanta el soporte de docstring de PyCharm, pero solo hay dos formatos admitidos en este momento son epytext y reStructureText. Quiero, y estoy dispuesto a escribirme, un complemento de PyCharm que crea un código de comentario de la documentación formateado en estilo de Google o Numpydoc ( https://pypi.python.org/pypi/sphinxcontrib-napoleon/ ). De especial importancia aquí es incorporar las habilidades de inferencia tipo que PyCharm tiene con los otros dos tipos de documentación.

Solo para que la respuesta de @Nras sea explícita, a partir de PyCharm 5.0 :

Archivo> Configuración> Herramientas> Herramientas integradas de Python> Docstrings> Google