doc: enable apidoc generation

Signed-off-by: Jan Luebbe <jlu@pengutronix.de>
labgrid-project · Mar 20, 2017 · c37dce8 · c37dce8
1 parent 8f6f770
commit c37dce8
Show file tree

Hide file tree

Showing 2 changed files with 18 additions and 1 deletion.
diff --git a/doc/conf.py b/doc/conf.py
@@ -156,4 +156,20 @@
 ]
 
 
-
+# -- Options for autodoc --------------------------------------------------
+
+autodoc_member_order = 'bysource'
+autodoc_mock_imports = ['onewire', 'txaio']
+
+def run_apidoc(_):
+    from sphinx.apidoc import main
+    import os
+    import sys
+    output_path = os.path.join(
+        os.path.abspath(os.path.dirname(__file__)),
+        'api'
+    )
+    main(['', '-T', '-o', output_path, 'labgrid', '--force'])
+
+def setup(app):
+    app.connect('builder-inited', run_apidoc)
diff --git a/doc/index.rst b/doc/index.rst
@@ -12,6 +12,7 @@ Welcome to labgrid's documentation!
    development
    components
    design_decisions
+   api/labgrid
    :maxdepth: 2
    :caption: Contents: