|
32 | 32 | # If extensions (or modules to document with autodoc) are in another directory,
|
33 | 33 | # add these directories to sys.path here. If the directory is relative to the
|
34 | 34 | # documentation root, use os.path.abspath to make it absolute, like shown here.
|
35 |
| -sys.path.insert(0, os.path.abspath('../..')) |
| 35 | +sys.path.insert(0, os.path.abspath("../..")) |
36 | 36 |
|
37 | 37 | # -- General configuration ------------------------------------------------
|
38 | 38 |
|
|
43 | 43 | # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
|
44 | 44 | # ones.
|
45 | 45 | extensions = [
|
46 |
| - 'sphinx.ext.autodoc', |
47 |
| - 'alabaster', |
| 46 | + "sphinx.ext.autodoc", |
| 47 | + "alabaster", |
48 | 48 | ]
|
49 | 49 | autodoc_member_order = "bysource"
|
50 | 50 |
|
51 | 51 | # Add any paths that contain templates here, relative to this directory.
|
52 |
| -templates_path = ['_templates'] |
| 52 | +templates_path = ["_templates"] |
53 | 53 |
|
54 | 54 | # The suffix of source filenames.
|
55 |
| -source_suffix = '.rst' |
| 55 | +source_suffix = ".rst" |
56 | 56 |
|
57 | 57 | # The encoding of source files.
|
58 | 58 | # source_encoding = 'utf-8-sig'
|
59 | 59 |
|
60 | 60 | # The master toctree document.
|
61 |
| -master_doc = 'index' |
| 61 | +master_doc = "index" |
62 | 62 |
|
63 | 63 | # General information about the project.
|
64 |
| -project = u'testinfra' |
65 |
| -copyright = u'{}, Philippe Pepiot'.format(datetime.date.today().year) |
| 64 | +project = u"testinfra" |
| 65 | +copyright = u"{}, Philippe Pepiot".format(datetime.date.today().year) |
66 | 66 |
|
67 | 67 | # The version info for the project you're documenting, acts as replacement for
|
68 | 68 | # |version| and |release|, also used in various other places throughout the
|
69 | 69 | # built documents.
|
70 | 70 | #
|
71 | 71 | # The short X.Y version.
|
72 |
| -version = subprocess.check_output( |
73 |
| - ['python3', 'setup.py', '--version'], |
74 |
| - cwd=os.path.join(os.path.dirname(__file__), os.pardir, os.pardir), |
75 |
| -).decode().strip() |
| 72 | +version = ( |
| 73 | + subprocess.check_output( |
| 74 | + ["python3", "setup.py", "--version"], |
| 75 | + cwd=os.path.join(os.path.dirname(__file__), os.pardir, os.pardir), |
| 76 | + ) |
| 77 | + .decode() |
| 78 | + .strip() |
| 79 | +) |
76 | 80 | # The full version, including alpha/beta/rc tags.
|
77 | 81 | release = version
|
78 | 82 |
|
|
106 | 110 | # show_authors = False
|
107 | 111 |
|
108 | 112 | # The name of the Pygments (syntax highlighting) style to use.
|
109 |
| -pygments_style = 'sphinx' |
| 113 | +pygments_style = "sphinx" |
110 | 114 |
|
111 | 115 | # A list of ignored prefixes for module index sorting.
|
112 | 116 | # modindex_common_prefix = []
|
|
119 | 123 |
|
120 | 124 | # The theme to use for HTML and HTML Help pages. See the documentation for
|
121 | 125 | # a list of builtin themes.
|
122 |
| -html_theme = 'alabaster' |
| 126 | +html_theme = "alabaster" |
123 | 127 |
|
124 | 128 | # Theme options are theme-specific and customize the look and feel of a theme
|
125 | 129 | # further. For a list of options available for each theme, see the
|
126 | 130 | # documentation.
|
127 | 131 | html_theme_options = {
|
128 |
| - 'logo': 'logo.svg', |
129 |
| - 'github_user': 'pytest-dev', |
130 |
| - 'github_repo': 'pytest-testinfra', |
131 |
| - 'github_button': True, |
132 |
| - 'travis_button': True, |
133 |
| - 'extra_nav_links': { |
134 |
| - 'View on github': 'https://github.com/pytest-dev/pytest-testinfra', |
| 132 | + "logo": "logo.svg", |
| 133 | + "github_user": "pytest-dev", |
| 134 | + "github_repo": "pytest-testinfra", |
| 135 | + "github_button": True, |
| 136 | + "travis_button": True, |
| 137 | + "extra_nav_links": { |
| 138 | + "View on github": "https://github.com/pytest-dev/pytest-testinfra", |
135 | 139 | },
|
136 | 140 | }
|
137 | 141 |
|
|
157 | 161 | # Add any paths that contain custom static files (such as style sheets) here,
|
158 | 162 | # relative to this directory. They are copied after the builtin static files,
|
159 | 163 | # so a file named "default.css" will overwrite the builtin "default.css".
|
160 |
| -html_static_path = ['_static'] |
| 164 | +html_static_path = ["_static"] |
161 | 165 |
|
162 | 166 | # Add any extra paths that contain custom files (such as robots.txt or
|
163 | 167 | # .htaccess) here, relative to this directory. These files are copied
|
|
174 | 178 |
|
175 | 179 | # Custom sidebar templates, maps document names to template names.
|
176 | 180 | html_sidebars = {
|
177 |
| - '**': [ |
178 |
| - 'about.html', |
179 |
| - 'navigation.html', |
180 |
| - 'searchbox.html', |
181 |
| - 'piwik.html', |
| 181 | + "**": [ |
| 182 | + "about.html", |
| 183 | + "navigation.html", |
| 184 | + "searchbox.html", |
| 185 | + "piwik.html", |
182 | 186 | ],
|
183 | 187 | }
|
184 | 188 |
|
|
213 | 217 | # html_file_suffix = None
|
214 | 218 |
|
215 | 219 | # Output file base name for HTML help builder.
|
216 |
| -htmlhelp_basename = 'testinfradoc' |
| 220 | +htmlhelp_basename = "testinfradoc" |
217 | 221 |
|
218 | 222 |
|
219 | 223 | # -- Options for LaTeX output ---------------------------------------------
|
220 | 224 |
|
221 | 225 | latex_elements = {
|
222 | 226 | # The paper size ('letterpaper' or 'a4paper')
|
223 | 227 | # 'papersize': 'letterpaper',
|
224 |
| - |
225 | 228 | # The font size ('10pt', '11pt' or '12pt').
|
226 | 229 | # 'pointsize': '10pt',
|
227 |
| - |
228 | 230 | # Additional stuff for the LaTeX preamble.
|
229 | 231 | # 'preamble': '',
|
230 | 232 | }
|
231 | 233 |
|
232 | 234 | # Grouping the document tree into LaTeX files. List of tuples
|
233 | 235 | # (source start file, target name, title,
|
234 | 236 | # author, documentclass [howto, manual, or own class]).
|
235 |
| -latex_documents = [( |
236 |
| - 'index', 'testinfra.tex', 'testinfra Documentation', |
237 |
| - 'Philippe Pepiot', 'manual'), |
| 237 | +latex_documents = [ |
| 238 | + ("index", "testinfra.tex", "testinfra Documentation", "Philippe Pepiot", "manual"), |
238 | 239 | ]
|
239 | 240 |
|
240 | 241 | # The name of an image file (relative to this directory) to place at the top of
|
|
262 | 263 |
|
263 | 264 | # One entry per manual page. List of tuples
|
264 | 265 | # (source start file, name, description, authors, manual section).
|
265 |
| -man_pages = [ |
266 |
| - ('index', 'testinfra', 'testinfra Documentation', |
267 |
| - ['Philippe Pepiot'], 1) |
268 |
| -] |
| 266 | +man_pages = [("index", "testinfra", "testinfra Documentation", ["Philippe Pepiot"], 1)] |
269 | 267 |
|
270 | 268 | # If true, show URL addresses after external links.
|
271 | 269 | # man_show_urls = False
|
|
276 | 274 | # Grouping the document tree into Texinfo files. List of tuples
|
277 | 275 | # (source start file, target name, title, author,
|
278 | 276 | # dir menu entry, description, category)
|
279 |
| -texinfo_documents = [( |
280 |
| - 'index', 'testinfra', 'testinfra Documentation', |
281 |
| - 'Philippe Pepiot', 'testinfra', 'One line description of project.', |
282 |
| - 'Miscellaneous'), |
| 277 | +texinfo_documents = [ |
| 278 | + ( |
| 279 | + "index", |
| 280 | + "testinfra", |
| 281 | + "testinfra Documentation", |
| 282 | + "Philippe Pepiot", |
| 283 | + "testinfra", |
| 284 | + "One line description of project.", |
| 285 | + "Miscellaneous", |
| 286 | + ), |
283 | 287 | ]
|
284 | 288 |
|
285 | 289 | # Documents to append as an appendix to all manuals.
|
|
0 commit comments