|
19 | 19 | # |
20 | 20 | import os |
21 | 21 | import sys |
22 | | -sys.path.insert(0, os.path.abspath('..')) |
23 | 22 |
|
24 | | -from minos import common |
| 23 | +sys.path.insert(0, os.path.abspath("..")) |
| 24 | + |
| 25 | +import sphinx_rtd_theme |
| 26 | + |
| 27 | +from minos import ( |
| 28 | + common, |
| 29 | +) |
25 | 30 |
|
26 | 31 | # -- General configuration --------------------------------------------- |
27 | 32 |
|
|
32 | 37 | # Add any Sphinx extension module names here, as strings. They can be |
33 | 38 | # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom ones. |
34 | 39 |
|
35 | | -import sphinx_rtd_theme |
36 | 40 |
|
37 | 41 | extensions = [ |
38 | 42 | "sphinxcontrib.apidoc", |
39 | | - 'sphinx.ext.autodoc', |
| 43 | + "sphinx.ext.autodoc", |
40 | 44 | "sphinx_autodoc_typehints", |
41 | 45 | "sphinx.ext.viewcode", |
42 | 46 | "sphinx_rtd_theme", |
43 | 47 | "m2r2", |
44 | 48 | ] |
45 | 49 | # Add any paths that contain templates here, relative to this directory. |
46 | | -templates_path = ['_templates'] |
| 50 | +templates_path = ["_templates"] |
47 | 51 |
|
48 | 52 | # The suffix(es) of source filenames. |
49 | 53 | # You can specify multiple suffix as a list of string: |
50 | 54 | # |
51 | | -source_suffix = ['.rst', '.md'] |
| 55 | +source_suffix = [".rst", ".md"] |
52 | 56 |
|
53 | 57 | # The master toctree document. |
54 | | -master_doc = 'index' |
| 58 | +master_doc = "index" |
55 | 59 |
|
56 | 60 | # General information about the project. |
57 | | -project = 'Minos Microservice Common' |
| 61 | +project = "Minos Microservice Common" |
58 | 62 | copyright = "2021, Clariteia" |
59 | 63 | author = "Clariteia Devs" |
60 | 64 |
|
|
77 | 81 | # List of patterns, relative to source directory, that match files and |
78 | 82 | # directories to ignore when looking for source files. |
79 | 83 | # This patterns also effect to html_static_path and html_extra_path |
80 | | -exclude_patterns = ['_build', 'Thumbs.db', '.DS_Store'] |
| 84 | +exclude_patterns = ["_build", "Thumbs.db", ".DS_Store"] |
81 | 85 |
|
82 | 86 | # The name of the Pygments (syntax highlighting) style to use. |
83 | | -pygments_style = 'sphinx' |
| 87 | +pygments_style = "sphinx" |
84 | 88 |
|
85 | 89 | # If true, `todo` and `todoList` produce output, else they produce nothing. |
86 | 90 | todo_include_todos = False |
|
92 | 96 | # a list of builtin themes. |
93 | 97 | # |
94 | 98 |
|
95 | | -html_theme = 'sphinx_rtd_theme' |
| 99 | +html_theme = "sphinx_rtd_theme" |
96 | 100 |
|
97 | 101 | # Theme options are theme-specific and customize the look and feel of a |
98 | 102 | # theme further. For a list of options available for each theme, see the |
|
119 | 123 | # -- Options for HTMLHelp output --------------------------------------- |
120 | 124 |
|
121 | 125 | # Output file base name for HTML help builder. |
122 | | -htmlhelp_basename = 'minosdoc' |
| 126 | +htmlhelp_basename = "minosdoc" |
123 | 127 |
|
124 | 128 |
|
125 | 129 | # -- Options for LaTeX output ------------------------------------------ |
|
128 | 132 | # The paper size ('letterpaper' or 'a4paper'). |
129 | 133 | # |
130 | 134 | # 'papersize': 'letterpaper', |
131 | | - |
132 | 135 | # The font size ('10pt', '11pt' or '12pt'). |
133 | 136 | # |
134 | 137 | # 'pointsize': '10pt', |
135 | | - |
136 | 138 | # Additional stuff for the LaTeX preamble. |
137 | 139 | # |
138 | 140 | # 'preamble': '', |
139 | | - |
140 | 141 | # Latex figure (float) alignment |
141 | 142 | # |
142 | 143 | # 'figure_align': 'htbp', |
|
146 | 147 | # (source start file, target name, title, author, documentclass |
147 | 148 | # [howto, manual, or own class]). |
148 | 149 | latex_documents = [ |
149 | | - (master_doc, 'minos.tex', |
150 | | - 'Minos Microservice Common Documentation', |
151 | | - 'Clariteia Devs', 'manual'), |
| 150 | + (master_doc, "minos.tex", "Minos Microservice Common Documentation", "Clariteia Devs", "manual"), |
152 | 151 | ] |
153 | 152 |
|
154 | 153 |
|
155 | 154 | # -- Options for manual page output ------------------------------------ |
156 | 155 |
|
157 | 156 | # One entry per manual page. List of tuples |
158 | 157 | # (source start file, name, description, authors, manual section). |
159 | | -man_pages = [ |
160 | | - (master_doc, 'minos', |
161 | | - 'Minos Microservice Common Documentation', |
162 | | - [author], 1) |
163 | | -] |
| 158 | +man_pages = [(master_doc, "minos", "Minos Microservice Common Documentation", [author], 1)] |
164 | 159 |
|
165 | 160 |
|
166 | 161 | # -- Options for Texinfo output ---------------------------------------- |
|
169 | 164 | # (source start file, target name, title, author, |
170 | 165 | # dir menu entry, description, category) |
171 | 166 | texinfo_documents = [ |
172 | | - (master_doc, 'minos', |
173 | | - 'Minos Microservice Common Documentation', |
174 | | - author, |
175 | | - 'minos', |
176 | | - 'One line description of project.', |
177 | | - 'Miscellaneous'), |
| 167 | + ( |
| 168 | + master_doc, |
| 169 | + "minos", |
| 170 | + "Minos Microservice Common Documentation", |
| 171 | + author, |
| 172 | + "minos", |
| 173 | + "One line description of project.", |
| 174 | + "Miscellaneous", |
| 175 | + ), |
178 | 176 | ] |
179 | 177 |
|
180 | 178 | # "apidoc" extension |
|
193 | 191 | "--force", |
194 | 192 | "--implicit-namespaces", |
195 | 193 | ] |
196 | | -apidoc_excluded_paths = [ |
197 | | - '../minos/common/testing.py' |
198 | | -] |
| 194 | +apidoc_excluded_paths = ["../minos/common/testing.py"] |
199 | 195 | # "autodoc typehints" extension |
200 | 196 |
|
201 | 197 | set_type_checking_flag = True |
|
0 commit comments