Format with default line-length=88 (was 79 with Sanic).

guide/webapp/display/page/docobject.py

@@ -119,9 +119,7 @@ def _extract_docobjects(package_name: str) -> dict[str, DocObject]:
     docstrings = {}
     package = importlib.import_module(package_name)
 
-    for _, name, _ in pkgutil.walk_packages(
-        package.__path__, package_name + "."
-    ):
+    for _, name, _ in pkgutil.walk_packages(package.__path__, package_name + "."):
         module = importlib.import_module(name)
         for obj_name, obj in inspect.getmembers(module):
             if (
@@ -155,9 +153,7 @@ def _docobject_to_html(
 ) -> None:
     anchor_id = slugify(docobject.full_name.replace(".", "-"))
     anchor = E.a("#", class_="anchor", href=f"#{anchor_id}")
-    class_name, heading = _define_heading_and_class(
-        docobject, anchor, as_method
-    )
+    class_name, heading = _define_heading_and_class(docobject, anchor, as_method)
 
     with builder.div(class_=class_name):
         builder(heading)
@@ -211,9 +207,7 @@ def _docobject_to_html(
 
         if docobject.docstring.params:
             with builder.div(class_="box mt-5"):
-                builder.h5(
-                    "Parameters", class_="is-size-5 has-text-weight-bold"
-                )
+                builder.h5("Parameters", class_="is-size-5 has-text-weight-bold")
                 _render_params(builder, docobject.docstring.params)
 
         if docobject.docstring.returns:
@@ -238,9 +232,7 @@ def _signature_to_html(
     parts = []
     parts.append("<span class='function-signature'>")
     for decorator in decorators:
-        parts.append(
-            f"<span class='function-decorator'>@{decorator}</span><br>"
-        )
+        parts.append(f"<span class='function-decorator'>@{decorator}</span><br>")
     parts.append(
         f"<span class='is-italic'>{object_type}</span> "
         f"<span class='has-text-weight-bold'>{name}</span>("
@@ -254,9 +246,7 @@ def _signature_to_html(
         annotation = ""
         if param.annotation != inspect.Parameter.empty:
             annotation = escape(str(param.annotation))
-            parts.append(
-                f": <span class='param-annotation'>{annotation}</span>"
-            )
+            parts.append(f": <span class='param-annotation'>{annotation}</span>")
         if param.default != inspect.Parameter.empty:
             default = escape(str(param.default))
             if annotation == "str":
@@ -267,9 +257,7 @@ def _signature_to_html(
     parts.append(")")
     if signature.return_annotation != inspect.Signature.empty:
         return_annotation = escape(str(signature.return_annotation))
-        parts.append(
-            f": -> <span class='return-annotation'>{return_annotation}</span>"
-        )
+        parts.append(f": -> <span class='return-annotation'>{return_annotation}</span>")
     parts.append("</span>")
     return "".join(parts)
 
@@ -317,10 +305,7 @@ def _render_params(builder: Builder, params: list[DocstringParam]) -> None:
             builder.dd(
                 HTML(
                     render_markdown(
-                        param.description
-                        or param.arg_name
-                        or param.type_name
-                        or ""
+                        param.description or param.arg_name or param.type_name or ""
                     )
                 )
             )
@@ -333,11 +318,7 @@ def _render_raises(builder: Builder, raises: list[DocstringRaises]) -> None:
             with builder.dl(class_="mt-2"):
                 builder.dt(raise_.type_name, class_="is-family-monospace")
                 builder.dd(
-                    HTML(
-                        render_markdown(
-                            raise_.description or raise_.type_name or ""
-                        )
-                    )
+                    HTML(render_markdown(raise_.description or raise_.type_name or ""))
                 )
 
 
@@ -353,11 +334,7 @@ def _render_returns(builder: Builder, docobject: DocObject) -> None:
         if not return_type or return_type == inspect.Signature.empty:
             return_type = "N/A"
 
-        term = (
-            "Return"
-            if not docobject.docstring.returns.is_generator
-            else "Yields"
-        )
+        term = "Return" if not docobject.docstring.returns.is_generator else "Yields"
         builder.h5(term, class_="is-size-5 has-text-weight-bold")
         with builder.dl(class_="mt-2"):
             builder.dt(return_type, class_="is-family-monospace")
@@ -372,17 +349,11 @@ def _render_returns(builder: Builder, docobject: DocObject) -> None:
             )
 
 
-def _render_examples(
-    builder: Builder, examples: list[DocstringExample]
-) -> None:
+def _render_examples(builder: Builder, examples: list[DocstringExample]) -> None:
     with builder.div(class_="box mt-5"):
         builder.h5("Examples", class_="is-size-5 has-text-weight-bold")
         for example in examples:
             with builder.div(class_="mt-2"):
                 builder(
-                    HTML(
-                        render_markdown(
-                            example.description or example.snippet or ""
-                        )
-                    )
+                    HTML(render_markdown(example.description or example.snippet or ""))
                 )

guide/webapp/display/page/page.py

@@ -11,9 +11,7 @@ from ..layouts.main import MainLayout
 from ..markdown import render_markdown
 from .docobject import organize_docobjects
 
-_PAGE_CACHE: dict[
-    str, dict[str, tuple[Page | None, Page | None, Page | None]]
-] = {}
+_PAGE_CACHE: dict[str, dict[str, tuple[Page | None, Page | None, Page | None]]] = {}
 _LAYOUTS_CACHE: dict[str, type[BaseLayout]] = {
     "home": HomeLayout,
     "main": MainLayout,

guide/webapp/display/page/renderer.py

@@ -20,13 +20,9 @@ class PageRenderer(BaseRenderer):
         self._body(request, builder, language, path)
         return builder
 
-    def _body(
-        self, request: Request, builder: Builder, language: str, path: str
-    ):
+    def _body(self, request: Request, builder: Builder, language: str, path: str):
         prev_page, current_page, next_page = Page.get(language, path)
-        request.ctx.language = (
-            Page.DEFAULT_LANGUAGE if language == "api" else language
-        )
+        request.ctx.language = Page.DEFAULT_LANGUAGE if language == "api" else language
         request.ctx.current_page = current_page
         request.ctx.previous_page = prev_page
         request.ctx.next_page = next_page
@@ -38,9 +34,7 @@ class PageRenderer(BaseRenderer):
 
     @contextmanager
     def _base(self, request: Request, builder: Builder, page: Page | None):
-        layout_type: type[BaseLayout] = (
-            page.get_layout() if page else BaseLayout
-        )
+        layout_type: type[BaseLayout] = page.get_layout() if page else BaseLayout
         layout = layout_type(builder)
         with layout(request, builder.full):
             yield