sphinxcontrib-autoanysrc 0.0.1dev-20141023

Sphinx extension with some autodoc features for any sources

Attention!

Currently in early development stage

Extension for gathering reST documentation from any files. This is a documenter from ext.autodoc.

In current state this extension will only insert reST docs from files to target documentation project without auto generation definitions and signatures.

Bun it simple and clean to make documentation for API and store documentation strings in the source code.

Install

pip install sphinxcontrib-autoanysrc

Usage

Add autoanysrc to extensions list:

extenstion = ['sphinx.ext.autodoc', 'sphinxcontrib.autoanysrc', ]

Example of usage:

.. autoanysrc:: directives
    :src: app/**/*.js
    :analyzer: js

Note

directive argument not used now, but it required…

Where:

• src option is the pattern to list source files where docs are stored

• analyzer option to determine witch analyzer must be used for processing this files

Directive will iterate over app/**/*.js files and process it line by line.

JSAnalyzer

Search comments blocks starts by /*””” and ends by */ (inspired by Nuulogic/sphinx-jsapidoc).

For example services.js:

/*"""
Services
````````

The function :func:`someService` does a some function.
*/

function someService(href, callback, errback) {
/*"""
.. function:: someService(href, callback[, errback])

    :param string href: An URI to the location of the resource.
    :param callback: Gets called with the object.
    :throws SomeError: For whatever reason in that case.
    :returns: Something.
*/
    return 'some result';
};

TODO

• echo file names currently processing to stdout

• encoding option

• rebuild docs if source files was changed

• allow internal indent in comment block

• registering custom analyzers from settings

• generate signatures like ext.autodoc…