[pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci

Author: pre-commit-ci[bot]

AGENTS.md

@@ -191,6 +191,7 @@ def parse_directive_text(
 ```python
 import pytest
 
+
 @pytest.mark.sphinx(
     buildername="html",
     srcdir="path/to/sourcedir",

docs/configuration.md

@@ -88,7 +88,7 @@ myst_html_meta = {
     "description lang=en": "metadata description",
     "description lang=fr": "description des métadonnées",
     "keywords": "Sphinx, MyST",
-    "property=og:locale":  "en_US"
+    "property=og:locale": "en_US",
 }
 ```
 

docs/develop/test_infrastructure.md

@@ -27,11 +27,15 @@ For example, after writing:
 
 ```python
 def test_example_dict(data_regression):
-    data_regression.check({
-        "key1": "value1",
-        "key2": "value2",
-        "more": "data...",
-    })
+    data_regression.check(
+        {
+            "key1": "value1",
+            "key2": "value2",
+            "more": "data...",
+        }
+    )
+
+
 def test_example_str(file_regression):
     file_regression.check("a very long string...")
 ```

docs/intro.md

@@ -140,8 +140,8 @@ Next, add it to your list of extensions in `conf.py`:
 
 ```python
 extensions = [
-  "myst_parser",
-  "sphinx_design",
+    "myst_parser",
+    "sphinx_design",
 ]
 ```
 

docs/syntax/code_and_apis.md

@@ -9,6 +9,7 @@ This language is used to determine the syntax highlighting, using an available [
 :::{syntax-example}
 ```python
 from a import b
+
 c = "string"
 ```
 :::

docs/syntax/optional.md

@@ -332,9 +332,7 @@ Key differences:
 Adding `"substitution"` to `myst_enable_extensions` (in the {{ confpy }}) will allow you to add substitutions, added in either the `conf.py` using `myst_substitutions`:
 
 ```python
-myst_substitutions = {
-  "key1": "I'm a **substitution**"
-}
+myst_substitutions = {"key1": "I'm a **substitution**"}
 ```
 
 or at the top of the file, in the front-matter section (see [this section](syntax/frontmatter)):

myst_parser/_docs.py

@@ -404,9 +404,9 @@ def run(self):
 ### MyST Lexer ###
 # TODO when some more work and testing, this should be made available publicly
 
-from pygments import token  # noqa: E402
-from pygments.lexer import bygroups, inherit, this, using  # noqa: E402
-from pygments.lexers.markup import MarkdownLexer  # noqa: E402
+from pygments import token
+from pygments.lexer import bygroups, inherit, this, using
+from pygments.lexers.markup import MarkdownLexer
 
 
 class MystLexer(MarkdownLexer):

myst_parser/inventory.py

@@ -411,7 +411,7 @@ def filter_string(
 
 
 def fetch_inventory(
-    uri: str, *, timeout: None | float = None, base_url: None | str = None
+    uri: str, *, timeout: float | None = None, base_url: str | None = None
 ) -> InventoryType:
     """Fetch an inventory from a URL or local path."""
     if uri.startswith(("http://", "https://")):
@@ -421,7 +421,7 @@ def fetch_inventory(
         return load(stream, base_url=base_url)
 
 
-def inventory_cli(inputs: None | list[str] = None):
+def inventory_cli(inputs: list[str] | None = None):
     """Command line interface for fetching and parsing an inventory."""
     parser = argparse.ArgumentParser(description="Parse an inventory file.")
     parser.add_argument("uri", metavar="[URL|PATH]", help="URI of the inventory file")

myst_parser/mdit_to_docutils/base.py

@@ -112,7 +112,7 @@ def __init__(self, parser: MarkdownIt) -> None:
             if k.startswith("render_") and k != "render_children"
         }
         # these are lazy loaded, when needed
-        self._inventories: None | dict[str, inventory.InventoryType] = None
+        self._inventories: dict[str, inventory.InventoryType] | None = None
 
     def __getattr__(self, name: str):
         """Warn when the renderer has not been setup yet."""
@@ -300,7 +300,7 @@ def nested_render_text(
         text: str,
         lineno: int,
         inline: bool = False,
-        temp_root_node: None | nodes.Element = None,
+        temp_root_node: nodes.Element | None = None,
         heading_offset: int = 0,
     ) -> None:
         """Render unparsed text (appending to the current node).
@@ -988,7 +988,7 @@ def render_link(self, token: SyntaxTreeNode) -> None:
         return self.render_link_unknown(token)
 
     def render_link_url(
-        self, token: SyntaxTreeNode, conversion: None | UrlSchemeType = None
+        self, token: SyntaxTreeNode, conversion: UrlSchemeType | None = None
     ) -> None:
         """Render link token (including autolink and linkify),
         where the link has been identified as an external URL.
@@ -2113,7 +2113,7 @@ def default_slugify(title: str) -> str:
 def compute_unique_slug(
     token_tree: SyntaxTreeNode,
     slugs: Container[str],
-    slug_func: None | Callable[[str], str] = None,
+    slug_func: Callable[[str], str] | None = None,
 ) -> str:
     """Compute the slug for a heading token, unique against existing slugs."""
     slug_func = github_slugify if slug_func is None else slug_func

myst_parser/mdit_to_docutils/sphinx_.py

@@ -136,7 +136,7 @@ def render_link_unknown(self, token: SyntaxTreeNode) -> None:
         path_dest, *_path_ids = destination.split("#", maxsplit=1)
         path_id = _path_ids[0] if _path_ids else None
 
-        potential_path: None | Path = None
+        potential_path: Path | None = None
         if self.sphinx_env.srcdir:  # not set in some test situations
             _, path_str = self.sphinx_env.relfn2path(path_dest, self.sphinx_env.docname)
             potential_path = Path(path_str)