afterpython 0.3.8__tar.gz → 0.3.10__tar.gz

{afterpython-0.3.8 → afterpython-0.3.10}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: afterpython
-Version: 0.3.8
+Version: 0.3.10
 Summary: CLI tool to streamline Python package maintenance and generate a dedicated project website
 Keywords: package-maintenance,project-website,static-site-generator,developer-tools,documentation,cli-tool,ci/cd,mystmd,semantic-release,python-packaging
 Author: Stephen Yau

{afterpython-0.3.8 → afterpython-0.3.10}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "afterpython"
-version = "0.3.8"
+version = "0.3.10"
 description = "CLI tool to streamline Python package maintenance and generate a dedicated project website"
 license = "Apache-2.0"
 authors = [

{afterpython-0.3.8 → afterpython-0.3.10}/src/afterpython/builders/index_md.py

@@ -4,17 +4,12 @@ import afterpython as ap
 from afterpython.const import CONTENT_TYPES, PLACEHOLDER_INDEX_MARKER
 
 
-def _legacy_placeholder_content(content_type: str) -> str:
-    return f"""---
-title: ← {content_type.capitalize()}
----
-
-This is a placeholder index page. The actual {content_type} landing page is rendered by SvelteKit.
-"""
-
-
-def _legacy_welcome_content(content_type: str) -> str:
-    return f"""# Welcome to AfterPython
+def _placeholder_content(content_type: str) -> str:
+    """Current placeholder body. Marker is an HTML comment so it embeds invisibly;
+    _is_afterpython_placeholder_index keys off it to tell our files apart from
+    user-authored ones."""
+    return f"""{PLACEHOLDER_INDEX_MARKER}
+# Welcome to AfterPython
 
 Welcome to your project's {content_type}! This is a starter page to help you get started.
 
@@ -35,6 +30,19 @@ Start building your amazing project! 🚀
 """
 
 
+def _legacy_placeholder_content(content_type: str) -> str:
+    """Frozen fingerprint of the arrow-stub placeholder written between commits
+    49f30c1 and 3a560e2 (no marker). Kept solely so projects built in that window
+    are still recognized as ours and cleaned up rather than blocking with the
+    'reserved' error. Do not edit — that would break recognition."""
+    return f"""---
+title: ← {content_type.capitalize()}
+---
+
+This is a placeholder index page. The actual {content_type} landing page is rendered by SvelteKit.
+"""
+
+
 def _is_afterpython_placeholder_index(index_md, content_type: str) -> bool:
     """Return True only for non-doc index.md files generated by AfterPython."""
     content = index_md.read_text(encoding="utf-8", errors="ignore")
@@ -43,7 +51,6 @@ def _is_afterpython_placeholder_index(index_md, content_type: str) -> bool:
     return (
         PLACEHOLDER_INDEX_MARKER in content
         or normalized_content == _legacy_placeholder_content(content_type).strip()
-        or normalized_content == _legacy_welcome_content(content_type).strip()
     )
 
 
@@ -76,25 +83,15 @@ def create_placeholder_index_md_files():
             )
             continue
 
-        content_path = ap.paths.afterpython_path / content_type
-        myst_yml_path = content_path / "myst.yml"
-
-        # Prepend index.md to TOC in myst.yml
-        if myst_yml_path.exists():
-            # Create placeholder index.md file
-            _write_index_file(content_type)
-            myst_data = read_yaml(myst_yml_path) or {}
-            toc = myst_data.get("project", {}).get("toc", [])
+        _write_index_file(content_type)
 
-            # Check if index.md is already first in TOC
-            if not toc or toc[0].get("file") != "index.md":
-                # Prepend index.md to TOC in myst.yml
-                new_toc = [{"file": "index.md"}, *toc]
-                if "project" not in myst_data:
-                    myst_data["project"] = {}
-                myst_data["project"]["toc"] = new_toc
-                write_yaml(myst_yml_path, myst_data)
-                click.echo(f"Added index.md to TOC in {myst_yml_path}")
+        # Prepend index.md to TOC in myst.yml (skip if already first).
+        myst_data = read_yaml(myst_yml_path) or {}
+        toc = myst_data.get("project", {}).get("toc", [])
+        if not toc or toc[0].get("file") != "index.md":
+            myst_data.setdefault("project", {})["toc"] = [{"file": "index.md"}, *toc]
+            write_yaml(myst_yml_path, myst_data)
+            click.echo(f"Added index.md to TOC in {myst_yml_path}")
 
 
 def delete_placeholder_index_md_files():

{afterpython-0.3.8 → afterpython-0.3.10}/src/afterpython/templates/deploy-workflow-template.yml

@@ -63,6 +63,11 @@ jobs:
       - name: Install afterpython
         run: uv pip install --system afterpython
 
+      - name: Install marimo
+        # Needed by `ap build` when afterpython/README.py is a marimo notebook;
+        # afterpython shells out to the `marimo` CLI for the WASM export.
+        run: uv pip install --system marimo
+
       - name: Install website dependencies
         run: pnpm install
         working-directory: ./afterpython/_website

{afterpython-0.3.8 → afterpython-0.3.10}/src/afterpython/tools/myst.py

@@ -143,14 +143,11 @@ def _write_index_file(content_type: tContentType):
             f"and update the reference in afterpython/{content_type}/myst.yml."
         )
 
-    index_content = f"""---
-title: ← {content_type.capitalize()}
----
+    # Lazy import to avoid the circular dep with builders/index_md.py, which
+    # already lazy-imports _write_index_file from this module.
+    from afterpython.builders.index_md import _placeholder_content
 
-{PLACEHOLDER_INDEX_MARKER}
-
-This is a placeholder index page. The actual {content_type} landing page is rendered by SvelteKit.
-"""
+    index_content = _placeholder_content(content_type)
     index_file.write_text(index_content)
     return index_file