Merge branch 'main' of https://github.com/braboj/tutorial-python

# Conflicts:
#	.scripts/gen_markdown_chapters.py

Author: braboj

.scripts/gen_markdown_chapters.py

@@ -2,7 +2,7 @@
 """Generate aggregated Markdown files for each examples subfolder.
 
 Usage:
-    python .scripts/examples_to_markdown_files.py \
+    python .scripts/gen_markdown_chapters.py \
         --examples-dir examples \
         --output-dir docs
 
@@ -18,6 +18,11 @@
 import re
 from pathlib import Path
 
+# Load user-defined acronyms once when the module is imported
+ACRONYMS_PATH = Path(__file__).resolve().parent / "acronyms.json"
+with ACRONYMS_PATH.open("r", encoding="utf-8") as json_data:
+    USER_ACRONYMS = json.load(json_data)
+
 def to_title(name: str) -> str:
     """Return *name* in title format with spaces and preserved acronyms."""
 
@@ -27,22 +32,15 @@ def to_title(name: str) -> str:
     # Split on underscores, dashes, or spaces
     parts = re.split(r"[_\-\s]+", name)
 
-    # Import JSON file containing user-defined acronyms
-    with open('acronyms.json') as json_data:
-        user_acronyms = json.load(json_data)
-
     # Capitalize each part, preserving all-uppercase acronyms
     words = []
     for part in parts:
-
-        print(part)
-
         # Skip empty parts that may result from leading/trailing separators
         if not part:
             continue
 
-        # Check user-defined acronyms from `docs/acronyms.txt`
-        if part.upper() in user_acronyms:
+        # Check user-defined acronyms loaded from ``acronyms.json``
+        if part.upper() in USER_ACRONYMS:
             words.append(part.upper())
 
         # If the part is all uppercase and contains only alphanumeric characters,
@@ -56,13 +54,6 @@ def to_title(name: str) -> str:
 
     return " ".join(words)
 
-def to_camel_case(name: str) -> str:
-    """Return *name* converted to CamelCase without leading digits."""
-    # Strip leading numeric prefixes like ``01_``
-    name = re.sub(r"^\d+_?", "", name)
-    parts = re.split(r"[_\-\s]+", name)
-    return " ".join(word.capitalize() for word in parts if word)
-
 def generate_aggregate(folder: Path, output_dir: Path) -> None:
     """Create a single Markdown file aggregating all examples in *folder*."""
     examples = []

.scripts/gen_markdown_pages.py

@@ -2,7 +2,7 @@
 """Generate a Markdown file for each Python example.
 
 Usage:
-    python .scripts/examples_to_markdown_files.py \
+    python .scripts/gen_markdown_pages.py \
         --examples-dir examples \
         --template templates/example_file.mustache \
         --output-dir docs

.scripts/gen_single_markdown.py

@@ -2,7 +2,7 @@
 """Generate a Markdown page from Python example files.
 
 Usage::
-    python .scripts/examples_to_markdown.py \
+    python .scripts/gen_single_markdown.py \
         --examples-dir examples \
         --template templates/examples_page.mustache \
         --output examples.md