[make] Allow for multiple categories in Makefile

Author: salkinium

tools/make/common.mk

@@ -1,7 +1,7 @@
 # Copyright 2023, Niklas Hauser
 # SPDX-License-Identifier: MPL-2.0
 
-### @Utils Utilities \1000
+### @Utils Utilities \1010
 
 log/%:
 	@mkdir -p $@
@@ -34,7 +34,7 @@ venv:
 	$(MAKE) pip-install-frozen
 
 .PHONY: clean-venv
-# Remove the virtual environment
+## Remove the virtual environment
 clean-venv:
 	@rm -rf .venv
 
@@ -55,13 +55,13 @@ build-homepage:
 serve-api-docs:
 	@pdoc --mermaid modm_data
 
-
+### @Tests Testing \1009
 # ================================== Testing ==================================
 ext/test/regression/:
 	@git clone --depth=1 [email protected]:modm-ext/modm-data-test-docs.git $@
 
 .PHONY: run-regression-tests
-## Convert some PDF pages and check against their known HTML.
+## @Tests Convert some PDF pages and check against their known HTML.
 run-regression-tests: ext/test/regression/
 	@test/convert_html.sh
 	@git diff --exit-code -- test/data/html

tools/scripts/makefile_help.py

@@ -14,19 +14,20 @@ def parse_makefiles(makefiles: list[str]):
 	for path in makefiles:
 		content = Path(path).read_text()
 		fcategory = "General"
-		if (cdoc := re.search(r"### *@([\w-]+) *(.*?) *\\(\d+)\n", content)):
-			fcategory = cdoc.group(1)
-			cdocs[fcategory] = (cdoc.group(2), int(cdoc.group(3) or 0))
-
-		rawdocs = re.findall(r"((?:##.+\n)+)(.+):", content, flags=re.MULTILINE)
-		for doc, rule in rawdocs:
-			doc = doc.replace("##", "")
-			if (category := re.search(r"@([\w-]+)", doc)):
-				doc = doc.replace(category.group(0), "")
-				category = category.group(1)
-			else:
-				category = fcategory
-			docs[category][rule] = [l.strip() for l in doc.splitlines()]
+		for groupcontent in re.split(r"### *@", content):
+			if (cdoc := re.search(r"^([\w-]+) *(.*?) *\\(\d+)\n", groupcontent)):
+				fcategory = cdoc.group(1)
+				cdocs[fcategory] = (cdoc.group(2), int(cdoc.group(3) or 0))
+
+			rawdocs = re.findall(r"((?:##.+\n)+)(.+):", groupcontent, flags=re.MULTILINE)
+			for doc, rule in rawdocs:
+				doc = doc.replace("##", "")
+				if (category := re.search(r"@([\w-]+)", doc)):
+					doc = doc.replace(category.group(0), "")
+					category = category.group(1)
+				else:
+					category = fcategory
+				docs[category][rule] = [l.strip() for l in doc.splitlines()]
 
 	return dict(docs), cdocs