afterpython 0.3.5__py3-none-any.whl → 0.3.7__py3-none-any.whl

afterpython/builders/index_md.py

@@ -1,7 +1,50 @@
 import click
 
 import afterpython as ap
-from afterpython.const import CONTENT_TYPES
+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
+
+Welcome to your project's {content_type}! This is a starter page to help you get started.
+
+## Getting Started
+
+Replace this placeholder content with your own. Here's what you can do:
+
+- Creating new `.md` or `.ipynb` files in the `afterpython/{content_type}/` directory
+- Writing in MyST Markdown format
+- Adding images to the `afterpython/static/` directory and referencing them
+
+## Resources
+
+- [AfterPython's Project Website](https://afterpython.afterpython.org)
+- [MyST Markdown Guide](https://mystmd.org)
+
+Start building your amazing project! 🚀
+"""
+
+
+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")
+    normalized_content = content.strip()
+
+    return (
+        PLACEHOLDER_INDEX_MARKER in content
+        or normalized_content == _legacy_placeholder_content(content_type).strip()
+        or normalized_content == _legacy_welcome_content(content_type).strip()
+    )
 
 
 def create_placeholder_index_md_files():
@@ -71,10 +114,23 @@ def delete_placeholder_index_md_files():
         myst_yml_path = content_path / "myst.yml"
         index_md = content_path / "index.md"
 
-        # Delete index.md from source
+        # Delete index.md from source only when it is an AfterPython-generated placeholder.
         if index_md.exists():
+            if not _is_afterpython_placeholder_index(index_md, content_type):
+                raise click.ClickException(
+                    f"Found existing 'afterpython/{content_type}/index.md'.\n"
+                    f"\n"
+                    f"'afterpython/{content_type}/index.md' is reserved for internal use by AfterPython.\n"
+                    f"The '/{content_type}' route is owned by the SvelteKit listing page,\n"
+                    f"so user-authored non-doc index.md files are not supported.\n"
+                    f"\n"
+                    f"Please rename this file to something else "
+                    f"(e.g., '{content_type}_intro.md') and update the reference in "
+                    f"afterpython/{content_type}/myst.yml."
+                )
+
             index_md.unlink()
-            click.echo(f"Deleted: {index_md}")
+            click.echo(f"Deleted placeholder: {index_md}")
 
         # Delete index.html from build output
         index_html = content_path / "_build" / "html" / "index.html"

afterpython/builders/metadata.py

@@ -57,6 +57,11 @@ def build_metadata():
     website = _from_tomlkit(afterpython.get("website", {}))
     metadata_json["announcement"] = str(website.get("announcement", "")).strip()
     metadata_json["readme_py"] = _resolve_readme_py(website)
+    # Logos are served from the site root in _website/ (assets copied from
+    # afterpython/static/ to _website/static/), so we normalize to a leading-
+    # 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", ""))
 
     with open(build_path / "metadata.json", "w") as f:
         json.dump(metadata_json, f, indent=2)
@@ -64,6 +69,22 @@ def build_metadata():
     convert_paths()
 
 
+def _resolve_logo_path(raw: object) -> str:
+    """Normalize a logo path from afterpython.toml for consumption by _website/.
+
+    normalize_static_path() returns either a bare filename ("logo.svg") or an
+    absolute path ("/some/dir/logo.svg"). The Svelte side passes this to
+    `asset()`, which expects a leading slash, so we prepend one when missing.
+    Returns "" when unset so the Svelte side can fall back to its default.
+    """
+    from afterpython.utils import normalize_static_path
+
+    path = normalize_static_path(str(raw))
+    if not path:
+        return ""
+    return path if path.startswith("/") else f"/{path}"
+
+
 def _resolve_readme_py(website_config: dict) -> str:
     """Resolve the readme_py field for metadata.json.
 

afterpython/cli/commands/update.py

@@ -112,8 +112,6 @@ def dependencies(upgrade: bool, all_: bool, exclude: tuple[str, ...]):
                 "uv not found. Updated pyproject.toml only (packages not installed)."
             )
     if upgrade and all_:
-        subprocess.run(["ap", "pre-commit", "autoupdate"])
-        click.echo("All pre-commit hooks updated successfully.")
         if has_pixi():
             click.echo("Upgrading dependencies with pixi...")
             pixi_exclude_args = ["--exclude", "python"]
@@ -137,6 +135,16 @@ def dependencies(upgrade: bool, all_: bool, exclude: tuple[str, ...]):
                     bold=True,
                 )
             )
+        result = subprocess.run(["ap", "pre-commit", "autoupdate"], check=False)
+        if result.returncode == 0:
+            click.echo("All pre-commit hooks updated successfully.")
+        else:
+            click.echo(
+                click.style(
+                    "Skipped pre-commit autoupdate (no config or command failed).",
+                    fg="yellow",
+                )
+            )
 
 
 update.add_command(dependencies, name="deps")  # alias for "dependencies"

afterpython/const.py

@@ -2,3 +2,4 @@ from afterpython._typing import tContentType
 
 NODEENV_VERSION = "24.11.0"
 CONTENT_TYPES: set[tContentType] = {"doc", "blog", "tutorial", "example", "guide"}
+PLACEHOLDER_INDEX_MARKER = "<!-- afterpython:placeholder-index -->"

afterpython/templates/ci-workflow-template.yml

@@ -124,7 +124,7 @@ jobs:
         uses: actions/checkout@v6
 
       - name: Set up pixi
-        uses: prefix-dev/setup-pixi@v0.9.5
+        uses: prefix-dev/setup-pixi@v0.9.6
         with:
           pixi-version: v0.67.2
           cache: true

afterpython/tools/myst.py

@@ -9,8 +9,11 @@ if TYPE_CHECKING:
 
 import subprocess
 
+import click
+
 import afterpython as ap
 from afterpython._io.yaml import read_yaml, write_yaml
+from afterpython.const import PLACEHOLDER_INDEX_MARKER
 from afterpython.utils import deep_merge
 
 
@@ -113,7 +116,7 @@ def _write_index_file(content_type: tContentType):
     Note: This only creates the file. TOC modification is handled by the build process.
 
     Raises:
-        FileExistsError: If index.md already exists (users shouldn't create this file).
+        click.ClickException: If a non-placeholder index.md already exists.
     """
     if content_type == "doc":
         return  # Doc doesn't need a placeholder index.md
@@ -123,22 +126,29 @@ def _write_index_file(content_type: tContentType):
 
     # Check if user created an index.md file
     if index_file.exists():
-        raise FileExistsError(
+        existing_content = index_file.read_text(encoding="utf-8", errors="ignore")
+        if PLACEHOLDER_INDEX_MARKER in existing_content:
+            return index_file
+
+        raise click.ClickException(
             f"\n"
-            f"Found existing 'index.md' in afterpython/{content_type}/\n"
+            f"Found existing 'afterpython/{content_type}/index.md'\n"
             f"\n"
-            f"The 'index.md' file is reserved for internal use by AfterPython.\n"
+            f"'afterpython/{content_type}/index.md' is reserved for internal use by AfterPython.\n"
             f"MyST treats the first file in TOC as index, which would conflict with\n"
-            f"SvelteKit (project-website-template)'s landing page route (/{content_type}).\n"
+            f"the SvelteKit listing page route '/{content_type}', which is owned by\n"
+            f"AfterPython's project website.\n"
             f"\n"
             f"Please rename your file to something else (e.g., '{content_type}_intro.md')\n"
-            f"and update the reference in afterpython/{content_type}/myst.yml"
+            f"and update the reference in afterpython/{content_type}/myst.yml."
         )
 
     index_content = f"""---
 title: ← {content_type.capitalize()}
 ---
 
+{PLACEHOLDER_INDEX_MARKER}
+
 This is a placeholder index page. The actual {content_type} landing page is rendered by SvelteKit.
 """
     index_file.write_text(index_content)

{afterpython-0.3.5.dist-info → afterpython-0.3.7.dist-info}/METADATA

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

@@ -7,12 +7,12 @@ 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=SDVHnVftL4D1AA8jw2YvRdTem_Ho8v8DcrORVjVtW8A,3762
+afterpython/builders/index_md.py,sha256=M4TNqrMl9_7HKiu11VOGiYvgffBQp3ZZbgLvlczZAVA,5998
 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=mXTeEpxdwNFlaUwFYLLU1UXvSX2T-pzIxzssFdmnyko,2744
+afterpython/builders/metadata.py,sha256=_GNXcrVM5mFvRGrPt6Liqy-D2jBzfIZz4nI1kOD2uJ4,3752
 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
@@ -35,13 +35,13 @@ afterpython/cli/commands/remove.py,sha256=Fl79JSI9IdHyzYflocXxcxgBkBPkNFAW98Yuij
 afterpython/cli/commands/serve.py,sha256=L0LIhMGByQA_mNTOAGHQTQ8TcBfi5sgmO1_iGI24QgI,822
 afterpython/cli/commands/start.py,sha256=q4rUkIllOO8wJQ9ABtsx-dqkW1yC0vltAtSkiHN_GH4,4002
 afterpython/cli/commands/sync.py,sha256=Av67jsCBxhh1skixihPgNyvZMUsh_j0pQGmG4EoR_A8,6318
-afterpython/cli/commands/update.py,sha256=082K1rg-ctCuKB_E7g_p-UWkTA9hoC65yhkIrtLZQ18,9408
+afterpython/cli/commands/update.py,sha256=s84yzIBsG1lQQ61gWkLLP-KzxZ3GIfwosb0Ge2mR7AI,9685
 afterpython/cli/main.py,sha256=-9eQiIrUViSvof-Ic2RHF3AVZharPSQh9sJ7tkhvf6Q,5042
-afterpython/const.py,sha256=B_yUBmHPyu98aOibwt7idWbhKNBBed0TeYXNBd8tPTk,157
+afterpython/const.py,sha256=pZERFcKA60HsTob9kFCh34M_bZhyphHgLKUHab9pNFg,225
 afterpython/main.py,sha256=w0z6mTib3u4p2HxMrk-tIJlZtur7uRaqsbE0ewlYlSs,490
 afterpython/pcu.py,sha256=EoEhSzFZ49b5qc9KH2RLxIHSzY8YFM5uhtw07chcrr8,6093
 afterpython/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-afterpython/templates/ci-workflow-template.yml,sha256=B3Rn5Ta1Bot1jKQ8ALBqQI8BDQ8mwIhpIA_umnXJ9oc,7115
+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
@@ -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=VunqoTxWE6y9LXYPBh_JvLMW8kqGMGBkqYkhr_bLvj8,8269
+afterpython/tools/myst.py,sha256=03m1bBKHxcDgruwrNjf7zAu5eH6TVDvsXSd936eIGF4,8586
 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.5.dist-info/WHEEL,sha256=fWriCkzqm-pffF5af4gJC9iI5FMFaJTuN9UxxxzOmdY,81
-afterpython-0.3.5.dist-info/entry_points.txt,sha256=roa0PDgBueM1JPbRG0G2OSxzaN394OUL_oS9iEwVLBc,80
-afterpython-0.3.5.dist-info/METADATA,sha256=EJ8Q7Lihz45tBkcqE39KF3kx92cxdURpKdjmis6XKi4,6180
-afterpython-0.3.5.dist-info/RECORD,,
+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.5.dist-info → afterpython-0.3.7.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: uv 0.11.14
+Generator: uv 0.11.16
 Root-Is-Purelib: true
 Tag: py3-none-any