Sphinx extension
================

   
Source file processing can be done with sphinx, we just need to respond to "doctree-resolved" event that
gives us processed doctree ::

    #@@sphinx_extension@@
    def sphinx_get_doctree(app, doctree, docname):
        logging.debug("Got doctree")
        scan_doctree(doctree,docname)

We wait for "build-finished" event to create source code files (SEE? maybe we should do it before ?) ::

    #@@sphinx_extension@@
    def sphinx_build_finished(app, exception):
        env = app.builder.env
        OUTPUT_DIR = app.config.rst2code_output_dir
        process_blocks()
        clean_output_dir()
        write_files()


To use rst2code within sphinx, [configuration]... So we need a "setup" function ::

    #@@sphinx_extension@@
    def setup(app):
        app.add_config_value("rst2code_output_dir", "./src", "env")
        app.add_config_value("rst2code_max_iterations", 10, "env")
        app.connect('doctree-resolved',sphinx_get_doctree)
        app.connect('build-finished', sphinx_build_finished)