From cc4b49a34e7f44e2626a3a7a8430590734977f9b Mon Sep 17 00:00:00 2001 From: Vladan Popovic Date: Fri, 4 Sep 2020 22:17:58 +0200 Subject: [PATCH] Enable documentation build with tox --- docs/source/apidocs.rst | 33 +++++++++++++++++++++++++ docs/source/conf.py | 53 +++++++++++++++++++++++++++++++++++++++++ docs/source/index.rst | 22 +++++++++++++++++ 3 files changed, 108 insertions(+) create mode 100644 docs/source/apidocs.rst create mode 100644 docs/source/conf.py create mode 100644 docs/source/index.rst diff --git a/docs/source/apidocs.rst b/docs/source/apidocs.rst new file mode 100644 index 0000000..e9633bc --- /dev/null +++ b/docs/source/apidocs.rst @@ -0,0 +1,33 @@ +======================================================= +API documentation on all modules present in the package +======================================================= + +Autogenerated documentation from the docstrings of every module. + +chweb.base +========== + +.. automodule:: chweb.base + :members: + :undoc-members: + +chweb.models +============ + +.. automodule:: chweb.models + :members: + :undoc-members: + +chweb.collector +=============== + +.. automodule:: chweb.collector + :members: + :undoc-members: + +chweb.consumer +============== + +.. automodule:: chweb.consumer + :members: + :undoc-members: diff --git a/docs/source/conf.py b/docs/source/conf.py new file mode 100644 index 0000000..247c95b --- /dev/null +++ b/docs/source/conf.py @@ -0,0 +1,53 @@ +# Configuration file for the Sphinx documentation builder. +# +# This file only contains a selection of the most common options. For a full +# list see the documentation: +# https://www.sphinx-doc.org/en/master/usage/configuration.html + +# -- Path setup -------------------------------------------------------------- + +# If extensions (or modules to document with autodoc) are in another directory, +# add these directories to sys.path here. If the directory is relative to the +# documentation root, use os.path.abspath to make it absolute, like shown here. +# +import os +import sys +sys.path.insert(0, os.path.join(os.path.abspath('.'), + "..", "..", "src")) + +# -- Project information ----------------------------------------------------- + +project = 'chweb' +copyright = '2020, Vladan Popovic' +author = 'Vladan Popovic' + + +# -- General configuration --------------------------------------------------- + +# Add any Sphinx extension module names here, as strings. They can be +# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom +# ones. +extensions = [ + 'sphinx.ext.autodoc', +] + +# Add any paths that contain templates here, relative to this directory. +templates_path = ['_templates'] + +# List of patterns, relative to source directory, that match files and +# directories to ignore when looking for source files. +# This pattern also affects html_static_path and html_extra_path. +exclude_patterns = [] + + +# -- Options for HTML output ------------------------------------------------- + +# The theme to use for HTML and HTML Help pages. See the documentation for +# a list of builtin themes. +# +html_theme = 'alabaster' + +# Add any paths that contain custom static files (such as style sheets) here, +# relative to this directory. They are copied after the builtin static files, +# so a file named "default.css" will overwrite the builtin "default.css". +html_static_path = ['_static'] diff --git a/docs/source/index.rst b/docs/source/index.rst new file mode 100644 index 0000000..4d3c31e --- /dev/null +++ b/docs/source/index.rst @@ -0,0 +1,22 @@ +.. chweb documentation master file, created by + sphinx-quickstart on Fri Sep 4 19:58:09 2020. + You can adapt this file completely to your liking, but it should at least + contain the root `toctree` directive. + +Welcome to chweb's documentation! +================================= + +.. toctree:: + :maxdepth: 1 + :caption: Contents: + + apidocs + + + +Indices and tables +================== + +* :ref:`genindex` +* :ref:`modindex` +* :ref:`search`