afterpython 0.3.8__py3-none-any.whl → 0.3.10__py3-none-any.whl

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/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/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
 

{afterpython-0.3.8.dist-info → afterpython-0.3.10.dist-info}/METADATA

@@ -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.dist-info → afterpython-0.3.10.dist-info}/RECORD

@@ -7,7 +7,7 @@ afterpython/builders/__init__.py,sha256=H7f9mFKXofWOAC3hkrxiFzvW5NziF8wYyduUBykH
 afterpython/builders/build_pdoc.py,sha256=rasjCtTah5GsZYokqU--Fp3bvTEf464ievENfOoANOk,2040
 afterpython/builders/content_json.py,sha256=-LTkeA8oA6XEudc2b1H7U0-UwcJlHn7xgICeweMYrG0,4805
 afterpython/builders/faq_json.py,sha256=mMfFepRBL_1QYO0tQ6orf5ESo2LVntk55nfFzencViM,1193
-afterpython/builders/index_md.py,sha256=M4TNqrMl9_7HKiu11VOGiYvgffBQp3ZZbgLvlczZAVA,5998
+afterpython/builders/index_md.py,sha256=ZpBA1FIHgw9MXD8kRaq2OBaEAKnf94_sJmB2cG68iag,6021
 afterpython/builders/jupyter_notebook.py,sha256=8yjgwWBaHfEzvN90j4biR6-RaTUHeIQ59h4NKethHOk,9693
 afterpython/builders/llms_txt.py,sha256=9x-B1i1buTDJt4zGs8nugyto_pI5QIp7WUBcv-zpcso,9226
 afterpython/builders/marimo_notebook.py,sha256=cIah_ly67tTj4j1y7yL19MRQ9NN6vESmS2JKMsEuaA0,5386
@@ -44,7 +44,7 @@ afterpython/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 afterpython/templates/ci-workflow-template.yml,sha256=-7BVbNArhaUNtJzxdfIX9scCQcba7LoWHPJXLBm-OxM,7115
 afterpython/templates/cz-template.toml,sha256=2qwbQLb0nbZaA63oWXFFzvzPNBsFZHATL1C2rdNdjjs,185
 afterpython/templates/dependabot-template.yml,sha256=CBQEgh8EsXw2X7IqzGtFI7lVT9liF6PW4DvGLB0X2LY,1136
-afterpython/templates/deploy-workflow-template.yml,sha256=o9blTGoM_KLB3wZUQcfdjxSOz08ldNJDfv1hA7FEbp8,2397
+afterpython/templates/deploy-workflow-template.yml,sha256=3N8obLgDIKmTkWcr1NEqYVMDCfhllPDc_g05-T0AVLI,2625
 afterpython/templates/pdoc/frame.html.jinja2,sha256=GX4pNSuYC4Fq9hvZ01WyaBQes4FyNDOx5Ra4MNLr0eg,250
 afterpython/templates/pre-commit-config-template.yaml,sha256=3QkZekg2kK04-Dp8nGc9AsqEdpnh10EcdD6pBhyKpRQ,988
 afterpython/templates/release-workflow-template.yml,sha256=-vJJlbsroq1BGh0vN1tqJzh8uncn7_73OYn_GTVswCY,1606
@@ -54,12 +54,12 @@ afterpython/tools/_git.py,sha256=aO-qDEQ4OevD_B74DYKK4nQKYeiaS1BXmYc8paJRfbQ,377
 afterpython/tools/branch_rules.py,sha256=ciQ2H2YBnoCZu_plyVeIHzf2FcAILRFhpjzOR2_IfJg,3159
 afterpython/tools/commitizen.py,sha256=ZO1qHmzUU0myd85tncv76WtIR7DB_AoQGSUvaf78Ohg,438
 afterpython/tools/github_actions.py,sha256=0xzOc41QF1PKagD1CW7BAt_Rugy0KCEx_KfcrPKVl3c,3168
-afterpython/tools/myst.py,sha256=03m1bBKHxcDgruwrNjf7zAu5eH6TVDvsXSd936eIGF4,8586
+afterpython/tools/myst.py,sha256=UbtcCUbu_zMYZA00LptO25VKNi7GOodeNVuiGgi1320,8646
 afterpython/tools/pre_commit.py,sha256=oNsrUkPI13rSSBSyhyTTKPnQGhDxLIPYhxu6kL0fDmo,1206
 afterpython/tools/pyproject.py,sha256=hz-DOf-pkGBF2m_RqEZipAaO-NDbsLxrrc65LWAIwLA,3698
 afterpython/utils.py,sha256=fVa3jIzCvhn7QA7N0M6d_pvojpPFrN-hae8trUYhPKU,11701
 afterpython/version.py,sha256=hihRV1S-gc1m46OaXD32ikkEkqzs-Gtq7AcAqOQV-wY,1603
-afterpython-0.3.8.dist-info/WHEEL,sha256=f5fWSvWsg5Knq5GWa6t1nJIug0Tqo69GqAWD_9LbBKw,81
-afterpython-0.3.8.dist-info/entry_points.txt,sha256=roa0PDgBueM1JPbRG0G2OSxzaN394OUL_oS9iEwVLBc,80
-afterpython-0.3.8.dist-info/METADATA,sha256=tHD7uS3ZZuzzvZ8ooe-L_JFSVbxj8VbBt7C6toJLcKg,6180
-afterpython-0.3.8.dist-info/RECORD,,
+afterpython-0.3.10.dist-info/WHEEL,sha256=f5fWSvWsg5Knq5GWa6t1nJIug0Tqo69GqAWD_9LbBKw,81
+afterpython-0.3.10.dist-info/entry_points.txt,sha256=roa0PDgBueM1JPbRG0G2OSxzaN394OUL_oS9iEwVLBc,80
+afterpython-0.3.10.dist-info/METADATA,sha256=2sC2DKjDGAOvPkuoESl82akQUx27-qik117DYuKuIHE,6181
+afterpython-0.3.10.dist-info/RECORD,,