Можно ли использовать Sphinx autodoc для создания документации для моего fabfile из строки документации функции?
Например. для fabfile, содержащего задачу setup_development
, я пробовал:
.. automodule::fabfile
:members:
.. autofunction:: setup_development
Но ничего не генерируется.
фрагмент fabfile:
@task
def setup_development(remote='origin', branch='development'):
"""Setup your development environment.
* Checkout development branch & pull updates from remote
* Install required python packages
* Symlink development settings
* Sync and migrate database
* Build HTML Documentation and open in web browser
Args:
remote: Name of remote git repository. Default: 'origin'.
branch: Name of your development branch. Default: 'development'.
"""
<code>