feat(#40): support listed code blocks

mdformat_mkdocs/_helpers.py

@@ -40,5 +40,5 @@ def separate_indent(line: str) -> tuple[str, str]:
     """
     re_indent = re.compile(r"(?P<indent>\s*)(?P<content>[^\s]?.*)")
     match = re_indent.match(line)
-    assert match is not None  # for pyright
+    assert match  # for pyright
     return (match["indent"], match["content"])

mdformat_mkdocs/_normalize_list.py

@@ -39,11 +39,10 @@ def map_lookback(
 
     """
     results = [initial]
-    if len(items) > 1:
-        for item in items[1:]:
-            result = func(results[-1], item)
-            results.append(result)
-    return results
+    for item in items:
+        result = func(results[-1], item)
+        results.append(result)
+    return results[1:]
 
 
 # ======================================================================================
@@ -59,6 +58,8 @@ def map_lookback(
 class Syntax(Enum):
     """Non-standard line types."""
 
+    CODE_BULLETED = "CODE_BULLETED"
+    CODE_NUMBERED = "CODE_NUMBERED"
     LIST_BULLETED = "LIST_BULLETED"
     LIST_NUMBERED = "LIST_NUMBERED"
     START_MARKED = "START_MARKED"
@@ -74,11 +75,10 @@ def from_content(cls, content: str) -> Syntax | None:
 
         """
         if match := RE_LIST_ITEM.fullmatch(content):
-            return (
-                cls.LIST_NUMBERED
-                if match["bullet"] not in {"-", "*"}
-                else cls.LIST_BULLETED
-            )
+            is_numbered = match["bullet"] not in {"-", "*"}
+            if match["item"].startswith("```"):
+                return cls.CODE_NUMBERED if is_numbered else cls.CODE_BULLETED
+            return cls.LIST_NUMBERED if is_numbered else cls.LIST_BULLETED
         if any(content.startswith(f"{marker} ") for marker in MARKERS):
             return cls.START_MARKED
         if content.startswith("```"):
@@ -114,7 +114,12 @@ def _is_parent_line(prev_line: LineResult, parsed: ParsedLine) -> bool:
 
 def _is_peer_list_line(prev_line: LineResult, parsed: ParsedLine) -> bool:
     """Return True if two list items share the same scope and level."""
-    list_types = {Syntax.LIST_BULLETED, Syntax.LIST_NUMBERED}
+    list_types = {
+        Syntax.CODE_BULLETED,
+        Syntax.CODE_NUMBERED,
+        Syntax.LIST_BULLETED,
+        Syntax.LIST_NUMBERED,
+    }
     return (
         parsed.syntax in list_types
         and prev_line.parsed.syntax in list_types
@@ -204,7 +209,11 @@ class BlockIndent(NamedTuple):
 def _parse_code_block(last: BlockIndent | None, line: LineResult) -> BlockIndent | None:
     """Identify fenced or indented sections internally referred to as 'code blocks'."""
     result = last
-    if line.parsed.syntax == Syntax.EDGE_CODE:
+    if line.parsed.syntax in {
+        Syntax.CODE_BULLETED,
+        Syntax.CODE_NUMBERED,
+        Syntax.EDGE_CODE,
+    }:
         # On first edge, start tracking a code block
         #   on the second edge, stop tracking
         result = (
@@ -260,7 +269,11 @@ def _parse_semantic_indent(
     # PLANNED: This works, but is very confusing
     line, code_indent = tin
 
-    if not line.parsed.content or code_indent is not None:
+    if (
+        not line.parsed.content
+        or code_indent is not None
+        or line.parsed.syntax in {Syntax.CODE_BULLETED, Syntax.CODE_NUMBERED}
+    ):
         result = SemanticIndent.EMPTY
 
     elif line.parsed.syntax == Syntax.LIST_BULLETED:
@@ -305,6 +318,15 @@ def _format_new_indent(line: LineResult, block_indent: BlockIndent | None) -> st
                 line_indent=line.parsed.indent,
             )
             result = DEFAULT_INDENT * depth + extra_indent
+        elif line.parents and line.parents[-1].syntax in {
+            Syntax.CODE_BULLETED,
+            Syntax.CODE_NUMBERED,
+        }:
+            depth = len(line.parents) - 1
+            match = RE_LIST_ITEM.fullmatch(line.parents[-1].content)
+            assert match  # for pyright
+            extra_indent = " " * (len(match["bullet"]) + 1)
+            result = DEFAULT_INDENT * depth + extra_indent
         else:
             result = DEFAULT_INDENT * len(line.parents)
     return result
@@ -327,7 +349,7 @@ def _format_new_content(line: LineResult, inc_numbers: bool, is_code: bool) -> s
         Syntax.LIST_NUMBERED,
     }:
         list_match = RE_LIST_ITEM.fullmatch(line.parsed.content)
-        assert list_match is not None  # for pyright
+        assert list_match  # for pyright
         new_bullet = "-"
         if line.parsed.syntax == Syntax.LIST_NUMBERED:
             first_peer = (
@@ -354,7 +376,7 @@ def parse_text(*, text: str, inc_numbers: bool, use_sem_break: bool) -> ParsedTe
     code_indents = map_lookback(_parse_code_block, lines, None)
     html_indents = [
         # Any indents initiated from within a `code_block_indents` should be ignored
-        indent if indent and code_indents[indent.start_line] is None else None
+        indent if (indent and code_indents[indent.start_line] is None) else None
         for indent in map_lookback(_parse_html_line, lines, None)
     ]
     # When both, code_indents take precedence

mdformat_mkdocs/mdit_plugins/_pymd_abbreviations.py

@@ -69,7 +69,7 @@ def _pymd_abbreviations(
 
     matches = [match]
     max_line = start_line
-    while match is not None:
+    while match:
         if max_line == end_line:
             break
         if match := _new_match(state, max_line + 1):