afterpython 0.3.7__py3-none-any.whl → 0.3.9__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/builders/metadata.py

@@ -62,6 +62,7 @@ def build_metadata():
     # slash form that the Svelte side can hand straight to `asset()`.
     metadata_json["logo"] = _resolve_logo_path(website.get("logo", ""))
     metadata_json["logo_dark"] = _resolve_logo_path(website.get("logo_dark", ""))
+    metadata_json["favicon"] = _resolve_logo_path(website.get("favicon", ""))
 
     with open(build_path / "metadata.json", "w") as f:
         json.dump(metadata_json, f, indent=2)

afterpython/cli/commands/build.py

@@ -171,7 +171,13 @@ def postbuild(dev_build: bool = False):
             print(f"Moved: {source} to {destination}")
 
     build_content_json()
-    delete_placeholder_index_md_files()
+    # In dev mode the MyST `start` server is watching these files. Deleting
+    # them here would make MyST re-index without the placeholder and revert
+    # to using the first content file as the section index — exactly what
+    # the placeholder was created to prevent. `ap dev` cleans them up in
+    # its `finally` block after MyST has been shut down.
+    if not dev_build:
+        delete_placeholder_index_md_files()
 
     website_static = ap.paths.website_path / "static"
     website_static.mkdir(parents=True, exist_ok=True)

afterpython/cli/commands/dev.py

@@ -11,6 +11,7 @@ import time
 import click
 from click.exceptions import Exit
 
+from afterpython.builders import delete_placeholder_index_md_files
 from afterpython.cli.commands.build import postbuild, prebuild
 from afterpython.const import CONTENT_TYPES
 from afterpython.utils import find_available_port, find_node_env
@@ -218,3 +219,6 @@ def dev(
         pass
     finally:
         cleanup_processes()
+        # Now that MyST watchers are gone, clean up the placeholders
+        # postbuild() intentionally left behind for dev mode.
+        delete_placeholder_index_md_files()

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.7.dist-info → afterpython-0.3.9.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: afterpython
-Version: 0.3.7
+Version: 0.3.9
 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.7.dist-info → afterpython-0.3.9.dist-info}/RECORD

@@ -7,22 +7,22 @@ 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
 afterpython/builders/markdown.py,sha256=0ExfRqvOTWsgUkAVaGGNkiNDtNedRr7JR1yTGxpbsmA,8736
-afterpython/builders/metadata.py,sha256=_GNXcrVM5mFvRGrPt6Liqy-D2jBzfIZz4nI1kOD2uJ4,3752
+afterpython/builders/metadata.py,sha256=EueKoYWM__Hb9MwX0KYejxJvouoaAxD1oz9AP-Na-ZI,3830
 afterpython/builders/url_md.py,sha256=uuW3YCyphd-Qvl9Yopv48utu6y1tyfJHNc25sS-O6Yw,3526
 afterpython/cli/__init__.py,sha256=G4AB-rllhmr7tURFc5cXJfkjZZ2bXtMBg3oy4zUGEFw,84
 afterpython/cli/commands/add.py,sha256=Ppp4msdvOwN9_-fdG5-b0-IV9p0Eef9CiIEU3srUjYk,1792
-afterpython/cli/commands/build.py,sha256=h0AaZuhjuxD_2Iu_CHD-3-OMBbi-ncAYuMUIR2pha1k,11798
+afterpython/cli/commands/build.py,sha256=gKrpRIy1DNAlnP6o0PBZyis8arjAN6YEauhw2uVkO9c,12182
 afterpython/cli/commands/bump.py,sha256=9fR-wShNKhXbW2JgMExPlyI2n14TfQOtowAuALp-N-8,4122
 afterpython/cli/commands/check.py,sha256=lrPaVThAwxxnczu-VOZT7dd7aKjstnMQfX9UpZY3Lxs,1058
 afterpython/cli/commands/clean.py,sha256=havP43ZC1AKFzvscsRMF_to6TvOwruxGA5qzr6dMHvg,2529
 afterpython/cli/commands/commit.py,sha256=9QOKyt4tfTJzZEdHEPAdpUc4stYMSvG3-31uADuBxn4,1420
 afterpython/cli/commands/commitizen.py,sha256=H3jewz4VkZi5FYTWw3USVM3XosRx12kPShOQGxD3LNM,842
-afterpython/cli/commands/dev.py,sha256=LVv6WUB1RNe8w7yAQS_1TQEEn_wklbJOuduapYlg2FA,7039
+afterpython/cli/commands/dev.py,sha256=M04QgGTksIFMDglo2iUyTvFWiE-o5o4JsXqLu9DGoXY,7281
 afterpython/cli/commands/format.py,sha256=VFwCG9KDTF6j4Y_Ewp4_RpS8uNBQNOAj9HU_G97my5A,710
 afterpython/cli/commands/init.py,sha256=t-SKqmPOSpQu4821PNar0bQ6EjTX3qwQr2trAULns94,3877
 afterpython/cli/commands/init_branch_rules.py,sha256=fzAm8D5qbW3u4bEMpqPuRgO-0akuCGG7pu09JlKhYn4,243
@@ -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.7.dist-info/WHEEL,sha256=f5fWSvWsg5Knq5GWa6t1nJIug0Tqo69GqAWD_9LbBKw,81
-afterpython-0.3.7.dist-info/entry_points.txt,sha256=roa0PDgBueM1JPbRG0G2OSxzaN394OUL_oS9iEwVLBc,80
-afterpython-0.3.7.dist-info/METADATA,sha256=838abK-PJzhIAb2gK1tamV9PysHdyrZM5MwdEqFKyrk,6180
-afterpython-0.3.7.dist-info/RECORD,,
+afterpython-0.3.9.dist-info/WHEEL,sha256=f5fWSvWsg5Knq5GWa6t1nJIug0Tqo69GqAWD_9LbBKw,81
+afterpython-0.3.9.dist-info/entry_points.txt,sha256=roa0PDgBueM1JPbRG0G2OSxzaN394OUL_oS9iEwVLBc,80
+afterpython-0.3.9.dist-info/METADATA,sha256=C7LnowtwFEhNTLvjddSpDfcUx3Lv7LWAyHghKBPIr_Q,6180
+afterpython-0.3.9.dist-info/RECORD,,