Black format

docs/extensions/attributetable.py

@@ -152,7 +152,7 @@ def build_lookup_table(env: Optional[BuildEnvironment]) -> Dict[str, List[str]]:
     # Given an environment, load up a lookup table of
     # full-class-name: objects
     result = {}
-    domain = env.domains['py'] #type: ignore
+    domain = env.domains['py']  # type: ignore
 
     ignored = {
         'data',
@@ -181,7 +181,7 @@ class TableElement(NamedTuple):
 
 
 def process_attributetable(app: Sphinx, doctree: nodes.Node, fromdocname: str) -> None:
-    env = app.builder.env #type: ignore
+    env = app.builder.env  # type: ignore
 
     lookup = build_lookup_table(env)
     for node in doctree.traverse(attributetableplaceholder):

docs/extensions/builder.py

@@ -2,11 +2,11 @@ from sphinx.builders.html import StandaloneHTMLBuilder
 from sphinx.environment.adapters.indexentries import IndexEntries
 from sphinx.writers.html5 import HTML5Translator
 
+
 class DPYHTML5Translator(HTML5Translator):
     def visit_section(self, node):
         self.section_level += 1
-        self.body.append(
-            self.starttag(node, 'section'))
+        self.body.append(self.starttag(node, 'section'))
 
     def depart_section(self, node):
         self.section_level -= 1
@@ -20,16 +20,16 @@ class DPYHTML5Translator(HTML5Translator):
         super().depart_table(node)
         self.body.append('</div>')
 
+
 class DPYStandaloneHTMLBuilder(StandaloneHTMLBuilder):
     # This is mostly copy pasted from Sphinx.
     def write_genindex(self) -> None:
         # the total count of lines for each index letter, used to distribute
         # the entries into two columns
-        genindex = IndexEntries(self.env).create_index(self, group_entries=False) #type: ignore
+        genindex = IndexEntries(self.env).create_index(self, group_entries=False)  # type: ignore
         indexcounts = []
         for _k, entries in genindex:
-            indexcounts.append(sum(1 + len(subitems)
-                                   for _, (_, subitems, _) in entries))
+            indexcounts.append(sum(1 + len(subitems) for _, (_, subitems, _) in entries))
 
         genindexcontext = {
             'genindexentries': genindex,
@@ -38,15 +38,11 @@ class DPYStandaloneHTMLBuilder(StandaloneHTMLBuilder):
         }
 
         if self.config.html_split_index:
-            self.handle_page('genindex', genindexcontext,
-                             'genindex-split.html')
-            self.handle_page('genindex-all', genindexcontext,
-                             'genindex.html')
+            self.handle_page('genindex', genindexcontext, 'genindex-split.html')
+            self.handle_page('genindex-all', genindexcontext, 'genindex.html')
             for (key, entries), count in zip(genindex, indexcounts):
-                ctx = {'key': key, 'entries': entries, 'count': count,
-                       'genindexentries': genindex}
-                self.handle_page('genindex-' + key, ctx,
-                                 'genindex-single.html')
+                ctx = {'key': key, 'entries': entries, 'count': count, 'genindexentries': genindex}
+                self.handle_page('genindex-' + key, ctx, 'genindex-single.html')
         else:
             self.handle_page('genindex', genindexcontext, 'genindex.html')
 
@@ -56,6 +52,7 @@ def add_custom_jinja2(app):
     env.tests['prefixedwith'] = str.startswith
     env.tests['suffixedwith'] = str.endswith
 
+
 def add_builders(app):
     """This is necessary because RTD injects their own for some reason."""
     app.set_translator('html', DPYHTML5Translator, override=True)
@@ -66,12 +63,14 @@ def add_builders(app):
     except KeyError:
         pass
     else:
-        injected_mro = tuple(base if base is not StandaloneHTMLBuilder else DPYStandaloneHTMLBuilder
-                             for base in original.mro()[1:])
+        injected_mro = tuple(
+            base if base is not StandaloneHTMLBuilder else DPYStandaloneHTMLBuilder for base in original.mro()[1:]
+        )
         new_builder = type(original.__name__, injected_mro, {'name': 'readthedocs'})
         app.set_translator('readthedocs', DPYHTML5Translator, override=True)
         app.add_builder(new_builder, override=True)
 
+
 def setup(app):
     add_builders(app)
     app.connect('builder-inited', add_custom_jinja2)

docs/extensions/details.py

@@ -1,27 +1,34 @@
 from docutils.parsers.rst import Directive
-from docutils.parsers.rst import states, directives #type: ignore
+from docutils.parsers.rst import states, directives  # type: ignore
 from docutils.parsers.rst.roles import set_classes
 from docutils import nodes
 
+
 class details(nodes.General, nodes.Element):
     pass
 
+
 class summary(nodes.General, nodes.Element):
     pass
 
+
 def visit_details_node(self, node):
     self.body.append(self.starttag(node, 'details', CLASS=node.attributes.get('class', '')))
 
+
 def visit_summary_node(self, node):
     self.body.append(self.starttag(node, 'summary', CLASS=node.attributes.get('summary-class', '')))
     self.body.append(node.rawsource)
 
+
 def depart_details_node(self, node):
     self.body.append('</details>\n')
 
+
 def depart_summary_node(self, node):
     self.body.append('</summary>')
 
+
 class DetailsDirective(Directive):
     final_argument_whitespace = True
     optional_arguments = 1
@@ -48,8 +55,8 @@ class DetailsDirective(Directive):
         self.state.nested_parse(self.content, self.content_offset, node)
         return [node]
 
+
 def setup(app):
     app.add_node(details, html=(visit_details_node, depart_details_node))
     app.add_node(summary, html=(visit_summary_node, depart_summary_node))
     app.add_directive('details', DetailsDirective)
-

docs/extensions/exception_hierarchy.py

@@ -1,18 +1,22 @@
 from docutils.parsers.rst import Directive
-from docutils.parsers.rst import states, directives #type: ignore
+from docutils.parsers.rst import states, directives  # type: ignore
 from docutils.parsers.rst.roles import set_classes
 from docutils import nodes
 from sphinx.locale import _
 
+
 class exception_hierarchy(nodes.General, nodes.Element):
     pass
 
+
 def visit_exception_hierarchy_node(self, node):
     self.body.append(self.starttag(node, 'div', CLASS='exception-hierarchy-content'))
 
+
 def depart_exception_hierarchy_node(self, node):
     self.body.append('</div>\n')
 
+
 class ExceptionHierarchyDirective(Directive):
     has_content = True
 
@@ -22,6 +26,7 @@ class ExceptionHierarchyDirective(Directive):
         self.state.nested_parse(self.content, self.content_offset, node)
         return [node]
 
+
 def setup(app):
     app.add_node(exception_hierarchy, html=(visit_exception_hierarchy_node, depart_exception_hierarchy_node))
     app.add_directive('exception_hierarchy', ExceptionHierarchyDirective)

docs/extensions/nitpick_file_ignorer.py

@@ -5,7 +5,6 @@ from sphinx.util import logging as sphinx_logging
 
 
 class NitpickFileIgnorer(logging.Filter):
-    
     def __init__(self, app: Sphinx) -> None:
         self.app = app
         super().__init__()

docs/extensions/resourcelinks.py

@@ -16,13 +16,7 @@ from sphinx.util.typing import RoleFunction
 
 def make_link_role(resource_links: Dict[str, str]) -> RoleFunction:
     def role(
-        typ: str,
-        rawtext: str,
-        text: str,
-        lineno: int,
-        inliner: Inliner,
-        options: Dict = {},
-        content: List[str] = []
+        typ: str, rawtext: str, text: str, lineno: int, inliner: Inliner, options: Dict = {}, content: List[str] = []
     ) -> Tuple[List[Node], List[system_message]]:
 
         text = utils.unescape(text)
@@ -32,12 +26,14 @@ def make_link_role(resource_links: Dict[str, str]) -> RoleFunction:
             title = full_url
         pnode = nodes.reference(title, title, internal=False, refuri=full_url)
         return [pnode], []
+
     return role
 
 
 def add_link_role(app: Sphinx) -> None:
     app.add_role('resource', make_link_role(app.config.resource_links))
 
+
 def setup(app: Sphinx) -> Dict[str, Any]:
     app.add_config_value('resource_links', {}, 'env')
     app.connect('builder-inited', add_link_role)