2020-04-02 23:06:22 +03:00
|
|
|
# -*- coding: utf-8 -*-
|
|
|
|
|
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"
|
2020-12-06 18:23:47 +03:00
|
|
|
version = "1.3.2.dev0"
|
2020-09-20 01:03:05 +03:00
|
|
|
release = version
|
2020-09-20 14:03:12 +03:00
|
|
|
project = "Maestral"
|
|
|
|
title = "Maestral API Documentation"
|
|
|
|
copyright = "{}, {}".format(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 = [
|
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",
|
2020-11-20 17:24:06 +03:00
|
|
|
"sphinx.ext.autodoc",
|
2020-11-20 20:09:30 +03:00
|
|
|
"autoapi.extension",
|
|
|
|
"m2r2",
|
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
|
|
|
|
2020-09-20 14:03:12 +03:00
|
|
|
html_theme = "sphinx_rtd_theme"
|
2020-11-21 03:11:44 +03:00
|
|
|
html_logo = "maestral-symbolic.svg"
|
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"
|
|
|
|
|
2020-11-20 20:09:30 +03:00
|
|
|
# autoapi.extension
|
2020-09-20 14:03:12 +03:00
|
|
|
autoapi_type = "python"
|
2020-10-27 19:22:23 +03:00
|
|
|
autoapi_dirs = ["../src/maestral"]
|
2020-09-20 14:00:46 +03:00
|
|
|
autoapi_options = [
|
2020-09-20 14:03:12 +03:00
|
|
|
"members",
|
|
|
|
"show-inheritance",
|
2020-11-20 22:33:26 +03:00
|
|
|
"undoc-members",
|
2020-09-20 14:00:46 +03:00
|
|
|
]
|
|
|
|
autoapi_add_toctree_entry = False
|
2020-07-07 11:43:32 +03:00
|
|
|
|
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
|
|
|
|
|
|
|
# sphinx.ext.intersphinx
|
|
|
|
intersphinx_mapping = {
|
|
|
|
"click": ("https://click.palletsprojects.com/en/master/", 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),
|
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),
|
|
|
|
"requests": ("https://requests.readthedocs.io/en/master/", None),
|
|
|
|
"sqlalchemy": ("https://docs.sqlalchemy.org/en/latest/", None),
|
2020-11-21 23:36:05 +03:00
|
|
|
"watchdog": ("https://python-watchdog.readthedocs.io/en/v0.10.3/", None),
|
2020-11-20 20:09:30 +03:00
|
|
|
}
|