mirror of
https://github.com/readthedocs/sphinx-autoapi
synced 2024-11-04 12:00:16 +00:00
55 lines
1.4 KiB
Python
55 lines
1.4 KiB
Python
# -*- coding: utf-8 -*-
|
|
"""
|
|
Sphinx Auto-API
|
|
"""
|
|
|
|
import fnmatch
|
|
import shutil
|
|
|
|
from .domains import DotNetDomain, PythonDomain, GoDomain
|
|
|
|
|
|
def ignore_file(app, filename):
|
|
for pat in app.config.autoapi_ignore:
|
|
if fnmatch.fnmatch(filename, pat):
|
|
return True
|
|
return False
|
|
|
|
|
|
def load_yaml(app):
|
|
"""
|
|
Load AutoAPI data from the filesystem.
|
|
"""
|
|
|
|
if not app.config.autoapi_dir:
|
|
print "You must configure an autodapi_dir setting."
|
|
return
|
|
app.env.autoapi_data = []
|
|
|
|
if app.config.autoapi_type == 'dotnet':
|
|
domain = DotNetDomain(app)
|
|
elif app.config.autoapi_type == 'python':
|
|
domain = PythonDomain(app)
|
|
elif app.config.autoapi_type == 'go':
|
|
domain = GoDomain(app)
|
|
domain.full()
|
|
|
|
|
|
def build_finished(app, exception):
|
|
if not app.config.autoapi_keep_files:
|
|
if app.verbosity > 1:
|
|
print "Cleaning autoapi out"
|
|
shutil.rmtree(app.config.autoapi_root)
|
|
|
|
|
|
def setup(app):
|
|
app.connect('builder-inited', load_yaml)
|
|
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_stylesheet('autoapi.css')
|