Пользовательские пики PyCharm docstring (т.е. Для форматов google docstring или numpydoc)
Поддерживает ли PyCharm 2.7 (или PyCharm 3) поддержку пользовательских окон docstring и doctest? Если да, то как это сделать, чтобы написать этот конкретный тип пользовательского расширения?
Мой текущий проект стандартизован по использованию Руководства по стилю Google Python (http://google-styleguide.googlecode.com/svn/trunk/pyguide.html). Мне нравится поддержка PyCharm docstring, но сейчас только два поддерживаемых формата - epytext и reStructureText. Я хочу и хочу написать сам, плагин PyCharm, который создает заглушку комментариев документации, отформатированную в стиле Google или Numpydoc (https://pypi.python.org/pypi/sphinxcontrib-napoleon/). Особое значение здесь имеет использование возможностей вывода типов, которые PyCharm имеет с двумя другими типами документации.
Ответы
Ответ 1
С PyCharm 5.0 мы наконец-то выбрали шаблоны Google и NumPy Style Python Docstrings.
Он также упоминается в разделе whatsnew для PyCharm 5.0.
Как изменить формат Docstring:
Файл → Настройки → Инструменты → Интегрированные инструменты Python
Там вы можете выбрать из доступных форматов Docstrings:
Обычный, Epytext, reStructuredText, NumPy, Google
Ответ 2
Как упоминает CrazyCoder, его билет. Прямо сейчас вы можете использовать только EpyType
и reStructuredText
.
Ответ 3
Просто для того, чтобы сделать @Nras открытым, с PyCharm 5.0:
Файл > Настройки > Инструменты > Интегрированные инструменты Python > Docstrings > Google