Add API docs to fluent.runtime

This adds the entry points to the fluent.runtime to the docs.

I've abstracted the documentation from a single-person project
a bit as I go.

Author: Pike

fluent.runtime/docs/Makefile

@@ -16,4 +16,4 @@ help:
 # Catch-all target: route all unknown targets to Sphinx using the new
 # "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).
 %: Makefile
-	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)

fluent.runtime/docs/conf.py

@@ -20,8 +20,7 @@
 # -- Project information -----------------------------------------------------
 
 project = 'fluent.runtime'
-copyright = '2019, Luke Plant'
-author = 'Luke Plant'
+copyright = '2020'
 
 # The short X.Y version
 version = '0.3'
@@ -41,6 +40,7 @@
 extensions = [
     'sphinx.ext.intersphinx',
     'sphinx.ext.viewcode',
+    'sphinx.ext.autodoc',
 ]
 
 # Add any paths that contain templates here, relative to this directory.
@@ -128,56 +128,16 @@
 
 # Grouping the document tree into LaTeX files. List of tuples
 # (source start file, target name, title,
-#  author, documentclass [howto, manual, or own class]).
-latex_documents = [
-    (master_doc, 'fluentruntime.tex', 'fluent.runtime Documentation',
-     'Luke Plant', 'manual'),
-]
-
-
-# -- Options for manual page output ------------------------------------------
-
-# One entry per manual page. List of tuples
-# (source start file, name, description, authors, manual section).
-man_pages = [
-    (master_doc, 'fluentruntime', 'fluent.runtime Documentation',
-     [author], 1)
-]
-
-
-# -- Options for Texinfo output ----------------------------------------------
-
-# Grouping the document tree into Texinfo files. List of tuples
-# (source start file, target name, title, author,
-#  dir menu entry, description, category)
-texinfo_documents = [
-    (master_doc, 'fluentruntime', 'fluent.runtime Documentation',
-     author, 'fluentruntime', 'One line description of project.',
-     'Miscellaneous'),
-]
-
-
-# -- Options for Epub output -------------------------------------------------
-
-# Bibliographic Dublin Core info.
-epub_title = project
-
-# The unique identifier of the text. This can be a ISBN number
-# or the project homepage.
-#
-# epub_identifier = ''
-
-# A unique identification for the text.
-#
-# epub_uid = ''
-
-# A list of files that should not be packed into the epub file.
-epub_exclude_files = ['search.html']
-
 
 # -- Extension configuration -------------------------------------------------
 
 # -- Options for intersphinx extension ---------------------------------------
 
 # Example configuration for intersphinx: refer to the Python standard library.
 intersphinx_mapping = {'https://docs.python.org/': None}
+
+# -- Options for autodoc extension --------------------------------------------
+
+autodoc_mock_imports = [
+     'attr',
+]

fluent.runtime/docs/index.rst

@@ -16,4 +16,5 @@ significant changes.
    installation
    usage
    internals
+   reference
    history

fluent.runtime/docs/reference.rst

@@ -0,0 +1,5 @@
+API Reference
+=============
+
+.. automodule:: fluent.runtime
+   :members: