Использование sphinx autodoc для fabfile

Можно ли использовать 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>
6
задан mzjn 13 January 2012 в 15:51
поделиться