2020-11-20 20:09:30 +03:00
|
|
|
import os
|
2020-11-20 17:24:06 +03:00
|
|
|
import sys
|
2020-04-02 23:06:22 +03:00
|
|
|
import time
|
|
|
|
|
2020-11-20 17:24:06 +03:00
|
|
|
# -- Path setup ------------------------------------------------------------------------
|
|
|
|
|
2020-11-20 20:09:30 +03:00
|
|
|
sys.path.insert(0, os.path.abspath("../src"))
|
2020-04-02 23:06:22 +03:00
|
|
|
|
2020-10-27 19:22:10 +03:00
|
|
|
# -- Project information ---------------------------------------------------------------
|
2020-04-02 23:06:22 +03:00
|
|
|
|
2020-09-20 14:03:12 +03:00
|
|
|
author = "Sam Schott"
|
2023-07-24 23:32:23 +03:00
|
|
|
version = "1.8.0"
|
2020-09-20 01:03:05 +03:00
|
|
|
release = version
|
2020-09-20 14:03:12 +03:00
|
|
|
project = "Maestral"
|
|
|
|
title = "Maestral API Documentation"
|
2021-10-28 21:34:19 +03:00
|
|
|
copyright = f"{time.localtime().tm_year}, {author}"
|
2020-04-02 23:06:22 +03:00
|
|
|
|
2020-10-27 19:22:10 +03:00
|
|
|
# -- General configuration -------------------------------------------------------------
|
2020-04-02 23:06:22 +03:00
|
|
|
|
|
|
|
extensions = [
|
2022-02-11 01:12:53 +03:00
|
|
|
"sphinx.ext.viewcode",
|
2021-04-05 17:49:09 +03:00
|
|
|
"sphinxext.opengraph",
|
2020-11-21 00:44:56 +03:00
|
|
|
"sphinx.ext.viewcode",
|
2020-11-20 20:09:30 +03:00
|
|
|
"sphinx.ext.napoleon",
|
|
|
|
"sphinx.ext.todo",
|
|
|
|
"sphinx.ext.intersphinx",
|
2022-02-11 01:12:53 +03:00
|
|
|
"autoapi.extension",
|
2023-05-01 00:48:53 +03:00
|
|
|
"sphinx_mdinclude",
|
2020-04-02 23:06:22 +03:00
|
|
|
]
|
2020-09-20 14:03:12 +03:00
|
|
|
source_suffix = [".rst", ".md"]
|
|
|
|
master_doc = "index"
|
|
|
|
language = "en"
|
2020-09-20 14:00:46 +03:00
|
|
|
# html4_writer = True
|
2020-04-02 23:06:22 +03:00
|
|
|
|
2020-10-27 19:22:10 +03:00
|
|
|
# -- Options for HTML output -----------------------------------------------------------
|
2020-04-02 23:06:22 +03:00
|
|
|
|
2023-05-22 20:40:07 +03:00
|
|
|
html_theme = "furo"
|
2023-05-22 20:47:04 +03:00
|
|
|
html_logo = "maestral.png"
|
|
|
|
html_static_path = ['_static']
|
|
|
|
html_css_files = [
|
|
|
|
'css/custom.css',
|
|
|
|
]
|
2020-04-02 23:06:22 +03:00
|
|
|
|
2020-10-27 19:22:10 +03:00
|
|
|
# -- Options for LaTeX output ----------------------------------------------------------
|
2020-04-02 23:06:22 +03:00
|
|
|
|
2020-09-20 14:03:12 +03:00
|
|
|
latex_documents = [
|
|
|
|
(master_doc, "maestral.tex", title, author, "manual"),
|
|
|
|
]
|
2020-04-02 23:06:22 +03:00
|
|
|
|
2020-10-27 19:22:10 +03:00
|
|
|
# -- Extension configuration -----------------------------------------------------------
|
2020-04-02 23:06:22 +03:00
|
|
|
|
2020-11-20 20:09:30 +03:00
|
|
|
# sphinx.ext.autodoc
|
2020-11-20 04:55:11 +03:00
|
|
|
autodoc_typehints = "description"
|
2021-03-24 00:36:52 +03:00
|
|
|
autoclass_content = "both"
|
|
|
|
autodoc_member_order = "bysource"
|
|
|
|
autodoc_inherit_docstrings = False
|
2020-07-07 11:43:32 +03:00
|
|
|
|
2022-02-11 01:12:53 +03:00
|
|
|
# autoapi.extension
|
|
|
|
autoapi_type = "python"
|
|
|
|
autoapi_dirs = ["../src/maestral"]
|
|
|
|
autoapi_options = [
|
|
|
|
"members",
|
2022-02-19 22:02:08 +03:00
|
|
|
"undoc-members",
|
2022-02-11 01:12:53 +03:00
|
|
|
"show-inheritance",
|
|
|
|
]
|
|
|
|
autoapi_add_toctree_entry = False
|
|
|
|
|
2020-11-20 20:09:30 +03:00
|
|
|
# sphinx.ext.todo
|
2020-04-02 23:06:22 +03:00
|
|
|
todo_include_todos = True
|
2020-11-20 20:09:30 +03:00
|
|
|
|
2021-02-19 16:10:05 +03:00
|
|
|
# sphinx.ext.intersphsinx
|
2020-11-20 20:09:30 +03:00
|
|
|
intersphinx_mapping = {
|
2022-02-11 01:12:53 +03:00
|
|
|
"click": ("https://click.palletsprojects.com/en/latest/", None),
|
2020-11-21 00:44:56 +03:00
|
|
|
"dropbox": ("https://dropbox-sdk-python.readthedocs.io/en/latest/", None),
|
2020-11-21 17:31:45 +03:00
|
|
|
"fasteners": ("https://fasteners.readthedocs.io/en/latest/", None),
|
2022-02-19 21:33:12 +03:00
|
|
|
"keyring": ("https://keyring.readthedocs.io/en/latest/", None),
|
2020-11-20 21:40:52 +03:00
|
|
|
"Pyro5": ("https://pyro5.readthedocs.io/en/latest/", None),
|
2020-11-20 20:09:30 +03:00
|
|
|
"python": ("https://docs.python.org/3/", None),
|
2022-02-19 21:33:12 +03:00
|
|
|
"requests": ("https://docs.python-requests.org/en/master/", None),
|
2021-02-13 05:04:17 +03:00
|
|
|
"watchdog": ("https://python-watchdog.readthedocs.io/en/latest/", None),
|
2020-11-20 20:09:30 +03:00
|
|
|
}
|