Clean up AutoAPI output and naming

pull/9/head
Eric Holscher 9 years ago
parent d424993e8c
commit d0cb6ae6e0

@ -7,6 +7,8 @@ import os
import fnmatch
import shutil
from sphinx.util.console import darkgreen, bold
from .domains import DotNetDomain, PythonDomain, GoDomain, JavaScriptDomain
@ -17,7 +19,7 @@ def ignore_file(app, filename):
return False
def load_yaml(app):
def run_autoapi(app):
"""
Load AutoAPI data from the filesystem.
"""
@ -25,6 +27,7 @@ def load_yaml(app):
if not app.config.autoapi_dir:
print "You must configure an autodapi_dir setting."
return
app.env.autoapi_data = []
mapping = {
@ -36,15 +39,18 @@ def load_yaml(app):
domain = mapping[app.config.autoapi_type]
domain_obj = domain(app)
app.info('[AutoAPI] Loading Data')
app.info(bold('[AutoAPI] ') + darkgreen('Loading Data'))
domain_obj.load(
pattern=app.config.autoapi_file_pattern,
dir=os.path.normpath(app.config.autoapi_dir),
ignore=app.config.autoapi_ignore,
)
app.info('[AutoAPI] Mapping Data')
app.info(bold('[AutoAPI] ') + darkgreen('Mapping Data'))
domain_obj.map()
app.info('[AutoAPI] Rendering Data')
app.info(bold('[AutoAPI] ') + darkgreen('Rendering Data'))
domain_obj.output_rst(
root=app.config.autoapi_root,
# TODO: Better way to determine suffix?
@ -55,18 +61,18 @@ def load_yaml(app):
def build_finished(app, exception):
if not app.config.autoapi_keep_files:
if app.verbosity > 1:
print "Cleaning autoapi out"
app.info(bold('[AutoAPI] ') + darkgreen('Cleaning generated .rst files'))
shutil.rmtree(app.config.autoapi_root)
def setup(app):
app.connect('builder-inited', load_yaml)
app.connect('builder-inited', run_autoapi)
app.connect('build-finished', build_finished)
app.add_config_value('autoapi_type', 'python', 'html')
app.add_config_value('autoapi_root', 'autoapi', 'html')
app.add_config_value('autoapi_ignore', ['*migrations*'], 'html')
app.add_config_value('autoapi_file_pattern', '*', 'html')
app.add_config_value('autoapi_dir', '', 'html')
app.add_config_value('autoapi_keep_files', True, 'html')
app.add_config_value('autoapi_keep_files', False, 'html')
app.add_config_value('autoapi_template_dir', [], 'html')
app.add_stylesheet('autoapi.css')

Loading…
Cancel
Save