mirror of
https://github.com/samschott/maestral.git
synced 2024-09-22 11:27:35 +03:00
3ffa09205d
... and remove leftovers from Python 2. This was done using https://github.com/asottile/pyupgrade as a pre-commit hook. The hook makes sure that there will be no regression with old Python syntax in future.
67 lines
2.0 KiB
Python
67 lines
2.0 KiB
Python
import os
|
|
import sys
|
|
import time
|
|
|
|
# -- Path setup ------------------------------------------------------------------------
|
|
|
|
sys.path.insert(0, os.path.abspath("../src"))
|
|
|
|
# -- Project information ---------------------------------------------------------------
|
|
|
|
author = "Sam Schott"
|
|
version = "1.5.1"
|
|
release = version
|
|
project = "Maestral"
|
|
title = "Maestral API Documentation"
|
|
copyright = f"{time.localtime().tm_year}, {author}"
|
|
|
|
# -- General configuration -------------------------------------------------------------
|
|
|
|
extensions = [
|
|
"sphinxext.opengraph",
|
|
"sphinx.ext.viewcode",
|
|
"sphinx.ext.napoleon",
|
|
"sphinx.ext.todo",
|
|
"sphinx.ext.intersphinx",
|
|
"sphinx.ext.autodoc",
|
|
"m2r2",
|
|
]
|
|
source_suffix = [".rst", ".md"]
|
|
master_doc = "index"
|
|
language = "en"
|
|
# html4_writer = True
|
|
|
|
# -- Options for HTML output -----------------------------------------------------------
|
|
|
|
html_theme = "sphinx_rtd_theme"
|
|
html_logo = "maestral-symbolic.svg"
|
|
|
|
# -- Options for LaTeX output ----------------------------------------------------------
|
|
|
|
latex_documents = [
|
|
(master_doc, "maestral.tex", title, author, "manual"),
|
|
]
|
|
|
|
# -- Extension configuration -----------------------------------------------------------
|
|
|
|
# sphinx.ext.autodoc
|
|
autodoc_typehints = "description"
|
|
autoclass_content = "both"
|
|
autodoc_member_order = "bysource"
|
|
autodoc_inherit_docstrings = False
|
|
|
|
# sphinx.ext.todo
|
|
todo_include_todos = True
|
|
|
|
# sphinx.ext.intersphsinx
|
|
intersphinx_mapping = {
|
|
"click": ("https://click.palletsprojects.com/en/master/", None),
|
|
"dropbox": ("https://dropbox-sdk-python.readthedocs.io/en/latest/", None),
|
|
"fasteners": ("https://fasteners.readthedocs.io/en/latest/", None),
|
|
"Pyro5": ("https://pyro5.readthedocs.io/en/latest/", None),
|
|
"python": ("https://docs.python.org/3/", None),
|
|
"requests": ("https://requests.readthedocs.io/en/master/", None),
|
|
"sqlalchemy": ("https://docs.sqlalchemy.org/en/latest/", None),
|
|
"watchdog": ("https://python-watchdog.readthedocs.io/en/latest/", None),
|
|
}
|