From 1e5f9771625e67da0c9b886ac9283ff7c9aaa97a Mon Sep 17 00:00:00 2001
From: "Lex Darlog (DRL)" <3897975+Lex-DRL@users.noreply.github.com>
Date: Tue, 15 Jul 2025 00:26:59 +0500
Subject: [PATCH] + detect lists in docstrings

---
 docstring_formatter.py | 17 ++++++++++++++---
 1 file changed, 14 insertions(+), 3 deletions(-)

diff --git a/docstring_formatter.py b/docstring_formatter.py
index 899fd43..b8a7ede 100644
--- a/docstring_formatter.py
+++ b/docstring_formatter.py
@@ -10,6 +10,15 @@ import re as _re
 
 _re_indent_match = _re.compile("(\t*)( +)(\t*)(.*?)$").match
 _re_tab_indent_match = _re.compile("(\t+)(.*?)$").match
+_re_list_line_match = _re.compile(
+	"(\s*)("
+	"[-*•]+"
+	"|"
+	"[a-zA-Z]\s*[.)]"
+	"|"
+	"[0-9+]\s*[.)]"
+	")\s+"
+).match
 
 
 def _recover_tab_indents(line: str, tab_size: int):
@@ -57,15 +66,17 @@ def _join_paragraph_and_format_tabs(paragraph: _t.List[str], tab_size: int):
 			tab_indent, chunk = match.groups()  # We've detected indent. Now, get rid of it.
 			cur_indent = len(tab_indent)
 
-		if cur_indent == pending_indent:
+		match_list_line = _re_list_line_match(chunk)
+		# In case of a bulleted/numbered list, we'll need to start a new block, too.
+		if cur_indent == pending_indent and not match_list_line:
 			pending_chunks.append(chunk)
 			continue
 
-		# Indent mismatch - we're either ended one block or entered another. Either way, the previous block ends.
+		# Indent mismatch or a list line:
+		# we're either ended one block or entered another. Either way, the previous block ends.
 		if pending_chunks:
 			yield join_pending_chunks()
 			pending_chunks = list()
-
 		assert not pending_chunks
 		pending_chunks.append(chunk)
 		pending_indent = cur_indent