1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
|
#!/usr/bin/env python3
# This file is managed by 'repo_helper'. Don't edit it directly.
# stdlib
import os
import re
import sys
# 3rd party
from sphinx_pyproject import SphinxConfig
sys.path.append('.')
config = SphinxConfig(globalns=globals())
project = config["project"]
author = config["author"]
documentation_summary = config.description
github_url = "https://github.com/{github_username}/{github_repository}".format_map(config)
rst_prolog = f""".. |pkgname| replace:: enum_tools
.. |pkgname2| replace:: ``enum_tools``
.. |browse_github| replace:: `Browse the GitHub Repository <{github_url}>`__
"""
slug = re.sub(r'\W+', '-', project.lower())
release = version = config.version
sphinx_builder = os.environ.get("SPHINX_BUILDER", "html").lower()
todo_include_todos = int(os.environ.get("SHOW_TODOS", 0)) and sphinx_builder != "latex"
intersphinx_mapping = {
"python": ("https://docs.python.org/3/", None),
"sphinx": ("https://www.sphinx-doc.org/en/stable/", None),
}
html_theme_options = {"logo_only": False}
html_context = {
"display_github": True,
"github_user": "domdfcoding",
"github_repo": "enum_tools",
"github_version": "master",
"conf_py_path": "/doc-source/",
}
htmlhelp_basename = slug
latex_documents = [("index", f'{slug}.tex', project, author, "manual")]
man_pages = [("index", slug, project, [author], 1)]
texinfo_documents = [("index", slug, project, author, slug, project, "Miscellaneous")]
toctree_plus_types = set(config["toctree_plus_types"])
autodoc_default_options = {
"members": None, # Include all members (methods).
"special-members": None,
"autosummary": None,
"show-inheritance": None,
"exclude-members": ','.join(config["autodoc_exclude_members"]),
}
latex_elements = {
"printindex": "\\begin{flushleft}\n\\printindex\n\\end{flushleft}",
"tableofcontents": "\\pdfbookmark[0]{\\contentsname}{toc}\\sphinxtableofcontents",
}
def setup(app):
# 3rd party
from sphinx_toolbox.latex import better_header_layout
app.connect("config-inited", lambda app, config: better_header_layout(config))
html_logo = "../enum_tools.png"
autosummary_widths_builders = ["latex"]
nitpicky = True
needspace_amount = "1\\baselineskip"
ignore_missing_xrefs = [
"^sphinx.ext.autodoc.(Class|Attribute)?Documenter$",
"^enum.EnumMeta$",
"^docutils.nodes.Element$",
"^sphinx.domains"
]
# stdlib
from typing import Type
# 3rd party
import enum_tools.autoenum
from sphinx.ext.autodoc.directive import DocumenterBridge
enum_tools.autoenum.DocumenterBridge = DocumenterBridge
enum_tools.autoenum.Type = Type
|
