The code has been refactored.

Author: Spirual

.gitignore

@@ -133,5 +133,7 @@ _archive/
 
 .vscode/
 .DS_Store
+.idea/
+
 
 docs/apidocs

.pre-commit-config.yaml

@@ -21,14 +21,14 @@ repos:
     - id: trailing-whitespace
 
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.8.4
+    rev: v0.9.3
     hooks:
     - id: ruff
       args: [--fix]
     - id: ruff-format
 
   - repo: https://github.com/pre-commit/mirrors-mypy
-    rev: v1.14.0
+    rev: v1.14.1
     hooks:
     - id: mypy
       args: [--config-file=pyproject.toml]

myst_parser/config/main.py

@@ -312,7 +312,7 @@ def __repr__(self) -> str:
         metadata={
             "validator": check_heading_slug_func,
             "help": (
-                "Return a case- and whitespace-normalized name."
+                "Function for normalizing text to valid html id value"
                 "or a python import path e.g. `my_package.my_module.my_function`"
                 "It can be used to transliterate any language to valid  stable html identifiers"
             ),
@@ -536,8 +536,7 @@ def merge_file_level(
     if "html_meta" in topmatter:
         warning(
             MystWarnings.MD_TOPMATTER,
-            "top-level 'html_meta' key is deprecated, "
-            "place under 'myst' key instead",
+            "top-level 'html_meta' key is deprecated, place under 'myst' key instead",
         )
         updates["html_meta"] = topmatter["html_meta"]
     if "substitutions" in topmatter:

myst_parser/parsers/docutils_.py

@@ -139,7 +139,10 @@ def _attr_to_optparse_option(at: Field, default: Any) -> tuple[dict[str, Any], s
             "metavar": "<boolean>",
             "validator": frontend.validate_boolean,
         }, str(default)
-    if at.type is str or at.name in ("heading_slug_func", "fully_normalize_name_slug_func"):
+    if at.type is str or at.name in (
+        "heading_slug_func",
+        "fully_normalize_name_slug_func",
+    ):
         return {
             "metavar": "<str>",
         }, f"(default: '{default}')"
@@ -278,7 +281,7 @@ def parse(self, inputstring: str, document: nodes.document) -> None:
             for i, line in enumerate(inputstring.split("\n")):
                 if len(line) > document.settings.line_length_limit:
                     error = document.reporter.error(
-                        f"Line {i+1} exceeds the line-length-limit:"
+                        f"Line {i + 1} exceeds the line-length-limit:"
                         f" {document.settings.line_length_limit}."
                     )
                     document.append(error)
@@ -479,7 +482,7 @@ def visit_rubric_html(self, node):
     So here we override the visit/depart methods to output the correct <h> element
     """
     if "level" in node:
-        self.body.append(self.starttag(node, f'h{node["level"]}', "", CLASS="rubric"))
+        self.body.append(self.starttag(node, f"h{node['level']}", "", CLASS="rubric"))
     else:
         self.body.append(self.starttag(node, "p", "", CLASS="rubric"))
 
@@ -490,7 +493,7 @@ def depart_rubric_html(self, node):
     See explanation in `visit_rubric_html`
     """
     if "level" in node:
-        self.body.append(f'</h{node["level"]}>\n')
+        self.body.append(f"</h{node['level']}>\n")
     else:
         self.body.append("</p>\n")