|
18 | 18 | # documentation root, use os.path.abspath to make it absolute, like shown here. |
19 | 19 | # |
20 | 20 |
|
21 | | -from typing import Dict |
22 | | - |
23 | 21 | import os |
24 | 22 | import sys |
25 | | -sys.path.insert(0, os.path.abspath('..')) |
| 23 | +from typing import Dict |
| 24 | + |
| 25 | +sys.path.insert(0, os.path.abspath("..")) |
26 | 26 |
|
27 | 27 |
|
28 | 28 | # -- General configuration ------------------------------------------------ |
|
35 | 35 | # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom |
36 | 36 | # ones. |
37 | 37 | extensions = [ |
38 | | - 'sphinx.ext.autodoc', |
39 | | - 'sphinx.ext.intersphinx', |
| 38 | + "sphinx.ext.autodoc", |
| 39 | + "sphinx.ext.intersphinx", |
40 | 40 | ] |
41 | 41 |
|
42 | 42 | intersphinx_mapping = { |
43 | | - 'python': ('https://docs.python.org/3', (None, 'python-inv.txt')), |
44 | | - 'werkzeug': ('https://werkzeug.palletsprojects.com/en/2.1.x', None) |
| 43 | + "python": ("https://docs.python.org/3", (None, "python-inv.txt")), |
| 44 | + "werkzeug": ("https://werkzeug.palletsprojects.com/en/2.1.x", None), |
45 | 45 | } |
46 | 46 |
|
47 | 47 | # Add any paths that contain templates here, relative to this directory. |
48 | | -templates_path = ['_templates'] |
| 48 | +templates_path = ["_templates"] |
49 | 49 |
|
50 | 50 | # The suffix(es) of source filenames. |
51 | 51 | # You can specify multiple suffix as a list of string: |
52 | 52 | # |
53 | 53 | # source_suffix = ['.rst', '.md'] |
54 | | -source_suffix = '.rst' |
| 54 | +source_suffix = ".rst" |
55 | 55 |
|
56 | 56 | # The master toctree document. |
57 | | -master_doc = 'index' |
| 57 | +master_doc = "index" |
58 | 58 |
|
59 | 59 | # General information about the project. |
60 | | -project = 'pytest_httpserver' |
61 | | -copyright = '2020, Zsolt Cserna' |
62 | | -author = 'Zsolt Cserna' |
| 60 | +project = "pytest_httpserver" |
| 61 | +copyright = "2020, Zsolt Cserna" |
| 62 | +author = "Zsolt Cserna" |
63 | 63 |
|
64 | 64 | # The version info for the project you're documenting, acts as replacement for |
65 | 65 | # |version| and |release|, also used in various other places throughout the |
66 | 66 | # built documents. |
67 | 67 | # |
68 | 68 | # The short X.Y version. |
69 | | -version = '1.0.4' |
| 69 | +version = "1.0.4" |
70 | 70 | # The full version, including alpha/beta/rc tags. |
71 | 71 | release = version |
72 | 72 |
|
|
80 | 80 | # List of patterns, relative to source directory, that match files and |
81 | 81 | # directories to ignore when looking for source files. |
82 | 82 | # This patterns also effect to html_static_path and html_extra_path |
83 | | -exclude_patterns = ['_build', 'Thumbs.db', '.DS_Store'] |
| 83 | +exclude_patterns = ["_build", "Thumbs.db", ".DS_Store"] |
84 | 84 |
|
85 | 85 | # The name of the Pygments (syntax highlighting) style to use. |
86 | | -pygments_style = 'sphinx' |
| 86 | +pygments_style = "sphinx" |
87 | 87 |
|
88 | 88 | # If true, `todo` and `todoList` produce output, else they produce nothing. |
89 | 89 | todo_include_todos = False |
|
94 | 94 | # The theme to use for HTML and HTML Help pages. See the documentation for |
95 | 95 | # a list of builtin themes. |
96 | 96 | # |
97 | | -html_theme = 'sphinx_rtd_theme' |
| 97 | +html_theme = "sphinx_rtd_theme" |
98 | 98 |
|
99 | 99 | # Theme options are theme-specific and customize the look and feel of a theme |
100 | 100 | # further. For a list of options available for each theme, see the |
|
103 | 103 | # html_theme_options = {} |
104 | 104 |
|
105 | 105 | html_theme_options = { |
106 | | - 'canonical_url': '', |
107 | | - 'analytics_id': '', |
108 | | - 'logo_only': False, |
109 | | - 'display_version': True, |
110 | | - 'prev_next_buttons_location': 'bottom', |
111 | | - 'style_external_links': False, |
| 106 | + "canonical_url": "", |
| 107 | + "analytics_id": "", |
| 108 | + "logo_only": False, |
| 109 | + "display_version": True, |
| 110 | + "prev_next_buttons_location": "bottom", |
| 111 | + "style_external_links": False, |
112 | 112 | # Toc options |
113 | | - 'collapse_navigation': True, |
114 | | - 'sticky_navigation': True, |
115 | | - 'navigation_depth': 4, |
116 | | - 'includehidden': True, |
117 | | - 'titles_only': False |
| 113 | + "collapse_navigation": True, |
| 114 | + "sticky_navigation": True, |
| 115 | + "navigation_depth": 4, |
| 116 | + "includehidden": True, |
| 117 | + "titles_only": False, |
118 | 118 | } |
119 | 119 |
|
120 | 120 | # Add any paths that contain custom static files (such as style sheets) here, |
121 | 121 | # relative to this directory. They are copied after the builtin static files, |
122 | 122 | # so a file named "default.css" will overwrite the builtin "default.css". |
123 | | -html_static_path = ['_static'] |
| 123 | +html_static_path = ["_static"] |
124 | 124 |
|
125 | 125 | # Custom sidebar templates, must be a dictionary that maps document names |
126 | 126 | # to template names. |
127 | 127 | # |
128 | 128 | # This is required for the alabaster theme |
129 | 129 | # refs: http://alabaster.readthedocs.io/en/latest/installation.html#sidebars |
130 | 130 | html_sidebars = { |
131 | | - '**': [ |
132 | | - 'relations.html', # needs 'show_related': True theme option to display |
133 | | - 'searchbox.html', |
| 131 | + "**": [ |
| 132 | + "relations.html", # needs 'show_related': True theme option to display |
| 133 | + "searchbox.html", |
134 | 134 | ] |
135 | 135 | } |
136 | 136 |
|
137 | 137 |
|
138 | 138 | # -- Options for HTMLHelp output ------------------------------------------ |
139 | 139 |
|
140 | 140 | # Output file base name for HTML help builder. |
141 | | -htmlhelp_basename = 'pytest_httpserverdoc' |
| 141 | +htmlhelp_basename = "pytest_httpserverdoc" |
142 | 142 |
|
143 | 143 |
|
144 | 144 | # -- Options for LaTeX output --------------------------------------------- |
|
147 | 147 | # The paper size ('letterpaper' or 'a4paper'). |
148 | 148 | # |
149 | 149 | # 'papersize': 'letterpaper', |
150 | | - |
151 | 150 | # The font size ('10pt', '11pt' or '12pt'). |
152 | 151 | # |
153 | 152 | # 'pointsize': '10pt', |
154 | | - |
155 | 153 | # Additional stuff for the LaTeX preamble. |
156 | 154 | # |
157 | 155 | # 'preamble': '', |
158 | | - |
159 | 156 | # Latex figure (float) alignment |
160 | 157 | # |
161 | 158 | # 'figure_align': 'htbp', |
|
165 | 162 | # (source start file, target name, title, |
166 | 163 | # author, documentclass [howto, manual, or own class]). |
167 | 164 | latex_documents = [ |
168 | | - (master_doc, 'pytest_httpserver.tex', 'pytest\\_httpserver Documentation', |
169 | | - 'Zsolt Cserna', 'manual'), |
| 165 | + (master_doc, "pytest_httpserver.tex", "pytest\\_httpserver Documentation", "Zsolt Cserna", "manual"), |
170 | 166 | ] |
171 | 167 |
|
172 | 168 |
|
173 | 169 | # -- Options for manual page output --------------------------------------- |
174 | 170 |
|
175 | 171 | # One entry per manual page. List of tuples |
176 | 172 | # (source start file, name, description, authors, manual section). |
177 | | -man_pages = [ |
178 | | - (master_doc, 'pytest_httpserver', 'pytest_httpserver Documentation', |
179 | | - [author], 1) |
180 | | -] |
| 173 | +man_pages = [(master_doc, "pytest_httpserver", "pytest_httpserver Documentation", [author], 1)] |
181 | 174 |
|
182 | 175 |
|
183 | 176 | # -- Options for Texinfo output ------------------------------------------- |
|
186 | 179 | # (source start file, target name, title, author, |
187 | 180 | # dir menu entry, description, category) |
188 | 181 | texinfo_documents = [ |
189 | | - (master_doc, 'pytest_httpserver', 'pytest_httpserver Documentation', |
190 | | - author, 'pytest_httpserver', 'One line description of project.', |
191 | | - 'Miscellaneous'), |
| 182 | + ( |
| 183 | + master_doc, |
| 184 | + "pytest_httpserver", |
| 185 | + "pytest_httpserver Documentation", |
| 186 | + author, |
| 187 | + "pytest_httpserver", |
| 188 | + "One line description of project.", |
| 189 | + "Miscellaneous", |
| 190 | + ), |
192 | 191 | ] |
0 commit comments