afterpython 0.1.0.dev17__py3-none-any.whl → 0.1.1__py3-none-any.whl

afterpython/cli/commands/preview.py

@@ -7,7 +7,7 @@ from click.exceptions import Exit
 @click.command()
 @click.pass_context
 def preview(ctx):
-    """Preview the production build of the project website (including myst's builds)"""
+    """Preview the production build of the project website"""
     from afterpython.utils import find_node_env
 
     paths = ctx.obj["paths"]

afterpython/cli/commands/start.py

@@ -42,7 +42,7 @@ command_kwargs = {
     "--guide", is_flag=True, help="Start the development server for guide/ directory"
 )
 def start(ctx, doc: bool, blog: bool, tutorial: bool, example: bool, guide: bool):
-    """Simple wrapper for `myst start` for convenience"""
+    """Start MyST development server for a specific content type"""
     from afterpython.const import CONTENT_TYPES
     from afterpython.utils import (
         find_node_env,

afterpython/cli/commands/sync.py

@@ -5,7 +5,7 @@ from pyproject_metadata import StandardMetadata
 from tomlkit.toml_document import TOMLDocument
 
 import afterpython as ap
-from afterpython.utils import convert_author_name_to_id
+from afterpython.utils import convert_author_name_to_id, normalize_static_path
 
 
 def _sync_authors_yml(authors: list[tuple[str, str | None]]):
@@ -36,7 +36,7 @@ def _sync_authors_yml(authors: list[tuple[str, str | None]]):
 
 @click.command()
 def sync():
-    """Sync between pyproject.toml+afterpython.toml and authors.yml+myst.yml files"""
+    """Sync configuration between pyproject.toml/afterpython.toml and authors.yml/myst.yml"""
     from afterpython._io.toml import _from_tomlkit
     from afterpython.const import CONTENT_TYPES
     from afterpython.tools._afterpython import read_afterpython
@@ -54,6 +54,23 @@ def sync():
     company_name = str(_from_tomlkit(afterpython.get("company", {})).get("name", ""))
     company_url = str(_from_tomlkit(afterpython.get("company", {})).get("url", ""))
     website_url = str(_from_tomlkit(afterpython.get("website", {})).get("url", ""))
+    try:
+        website_favicon = normalize_static_path(
+            str(_from_tomlkit(afterpython.get("website", {})).get("favicon", ""))
+        )
+        website_logo = normalize_static_path(
+            str(_from_tomlkit(afterpython.get("website", {})).get("logo", ""))
+        )
+        website_logo_dark = normalize_static_path(
+            str(_from_tomlkit(afterpython.get("website", {})).get("logo_dark", ""))
+        )
+        website_thumbnail = normalize_static_path(
+            str(_from_tomlkit(afterpython.get("website", {})).get("thumbnail", ""))
+        )
+    except ValueError as e:
+        click.echo(f"Error in reading afterpython.toml: {e}")
+        return
+
     authors = pyproject.authors
     if company_name and company_url:
         nav_bar = [{"title": company_name, "url": company_url}]
@@ -83,9 +100,9 @@ def sync():
     # based on the current values in pyproject.toml and afterpython.toml
     for content_type in CONTENT_TYPES:
         path = ap.paths.afterpython_path / content_type
-        nav_bar_per_content_type = [
-            item for item in nav_bar if item["title"] != content_type.capitalize() + "s"
-        ]
+        # nav_bar_per_content_type = [
+        #     item for item in nav_bar if item["title"] != content_type.capitalize() + "s"
+        # ]
         title = project_name + f"'s {content_type.capitalize()}"
         data = {
             "project": {
@@ -103,14 +120,24 @@ def sync():
                 "description": str(pyproject.description),
                 "keywords": list(map(str, pyproject.keywords)),
                 "github": github_url,
+                "thumbnail": "../static" + website_thumbnail
+                if website_thumbnail
+                else "",
             },
             "site": {
                 "title": title,
                 "options": {
+                    "favicon": "../static" + website_favicon if website_favicon else "",
+                    "logo": "../static" + website_logo if website_logo else "",
+                    "logo_dark": "../static" + website_logo_dark
+                    if website_logo_dark
+                    else "",
                     "logo_text": project_name,
                     "logo_url": website_url,
                 },
-                "nav": nav_bar_per_content_type,
+                # FIXME: disable nav bar for now until myst fixes the issue with the nav bar
+                # the current issue is they prepend the BASE_URL to the nav bar links even they are external
+                # "nav": nav_bar_per_content_type,
                 "actions": [
                     {
                         "title": "⭐ Star",

afterpython/cli/commands/update.py

@@ -24,15 +24,15 @@ def update():
     "-u",
     "--upgrade",
     is_flag=True,
-    help="if enabled, the dependencies will be upgraded to the latest version",
+    help="Upgrade dependencies to their latest versions",
 )
 @click.option(
     "--all",
     is_flag=True,
-    help="update all versions in dependencies and tool configurations (e.g. pre-commit-config.yaml)",
+    help="Also update pre-commit hooks and pixi dependencies",
 )
 def dependencies(upgrade: bool, all: bool):
-    """Update pyproject.toml dependencies to the latest version"""
+    """Check and update project dependencies to latest versions"""
     from afterpython.pcu import get_dependencies, update_dependencies
     from afterpython.utils import has_pixi, has_uv
 
@@ -122,10 +122,10 @@ update.add_command(dependencies, name="deps")  # alias for "dependencies"
 @click.option(
     "--no-backup",
     is_flag=True,
-    help="if enabled, the existing project website template will not be backed up",
+    help="Skip creating a backup of the existing website template",
 )
 def website(ctx, no_backup: bool):
-    """Update the project website template to the latest version"""
+    """Update project website template to the latest version"""
     from afterpython.utils import find_node_env
 
     website_template_repo = "AfterPythonOrg/project-website-template"

afterpython/templates/ci-workflow-template.yml

@@ -118,7 +118,7 @@ jobs:
       - name: Set up pixi
         uses: prefix-dev/setup-pixi@v0.9.3
         with:
-          pixi-version: v0.59.0
+          pixi-version: v0.60.0
           cache: true
           # Optional: Uncomment if you need prefix.dev authentication
           # auth-host: prefix.dev

afterpython/templates/cz-template.toml

@@ -1,6 +1,5 @@
 [tool.commitizen]
 name = "cz_conventional_commits"
-# name = "cz_customize"
 tag_format = "v$version"
 version_scheme = "pep440"
 version_provider = "uv"

afterpython/templates/pre-commit-config-template.yaml

@@ -23,7 +23,7 @@ repos:
     stages:
     - pre-commit
 - repo: https://github.com/astral-sh/ruff-pre-commit
-  rev: v0.14.6
+  rev: v0.14.8
   hooks:
   - id: ruff-check
     stages:

afterpython/tools/_afterpython.py

@@ -3,14 +3,71 @@ from __future__ import annotations
 from typing import TYPE_CHECKING
 
 if TYPE_CHECKING:
+    from pathlib import Path
+
     from tomlkit.toml_document import TOMLDocument
 
+    from afterpython._typing import tContentType
+
 import tomlkit
 
 import afterpython as ap
 from afterpython._io.toml import _to_tomlkit, read_toml, write_toml
 
 
+def get_default_thumbnail(
+    content_type: tContentType, file_path: Path | None = None
+) -> str:
+    """Get the default thumbnail value for a content type.
+
+    Reads default thumbnail configuration from afterpython.toml:
+    - Content type specific thumbnail: [website.{content_type}.thumbnail]
+    - Website-wide default thumbnail: [website.thumbnail]
+    - Falls back to empty string if no default is configured
+
+    Args:
+        content_type: The content type (blog, tutorial, etc.)
+        file_path: Optional path to the file needing the thumbnail (for calculating relative path)
+
+    Returns:
+        The thumbnail value to use (e.g., "./static/image.png", "../static/image.png", or "")
+    """
+    from afterpython._io.toml import _from_tomlkit
+    from afterpython.utils import get_relative_static_prefix, normalize_static_path
+
+    afterpython = read_afterpython()
+    try:
+        # website_default_thumbnail = normalize_static_path(
+        #     str(_from_tomlkit(afterpython.get("website", {})).get("thumbnail", ""))
+        # )
+        content_type_default_thumbnail = normalize_static_path(
+            str(
+                _from_tomlkit(afterpython.get("website", {}))
+                .get(content_type, {})
+                .get("thumbnail", "")
+            )
+        )
+    except ValueError as e:
+        print(f"Error in reading afterpython.toml for {content_type=}: {e}")
+        return "null"
+
+    # Determine the static prefix based on file location
+    if file_path is not None:
+        content_type_path = ap.paths.afterpython_path / content_type.lower()
+        static_prefix = get_relative_static_prefix(file_path, content_type_path)
+    else:
+        static_prefix = "./"  # Default fallback
+
+    if content_type_default_thumbnail:
+        return f"{static_prefix}static{content_type_default_thumbnail}"
+    # use "thumbnail" set in afterpython.toml [website]
+    # elif website_default_thumbnail:
+    # Website-wide static is one level up from content_type folder
+    # return f"{static_prefix}../static{website_default_thumbnail}"
+    else:
+        return ""
+
+
 def read_afterpython() -> TOMLDocument:
     """Read afterpython.toml"""
     return read_toml(ap.paths.afterpython_path / "afterpython.toml")
@@ -55,12 +112,17 @@ def init_afterpython():
         return
     afterpython_toml_path.touch()
     print(f"Created {afterpython_toml_path}")
-    update_afterpython(
-        {
-            "company": {
-                "name": "",
-                "url": "",
-            },
-            "website": {"url": ""},
-        }
-    )
+    default_data = {
+        "company": {
+            "name": "",
+            "url": "",
+        },
+        "website": {
+            "url": "",
+            "favicon": "favicon.svg",
+            "logo": "logo.svg",
+            "logo_dark": "logo.svg",
+            "thumbnail": "thumbnail.png",
+        },
+    }
+    update_afterpython(default_data)

afterpython/tools/myst.py

@@ -103,6 +103,48 @@ def update_myst_yml(data_update: dict, path: Path, add_comments: bool = False):
     write_yaml(file_path, existing_data)
 
 
+def _write_index_file(content_type: tContentType):
+    """Create a placeholder index.md file for MyST to prevent first file from becoming index.
+
+    MyST treats the first file in TOC as index. This placeholder ensures all actual
+    content files get proper slugs. The generated index.html is deleted post-build
+    since SvelteKit owns the landing page route.
+
+    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).
+    """
+    if content_type == "doc":
+        return  # Doc doesn't need a placeholder index.md
+
+    content_path = ap.paths.afterpython_path / content_type
+    index_file = content_path / "index.md"
+
+    # Check if user created an index.md file
+    if index_file.exists():
+        raise FileExistsError(
+            f"\n"
+            f"Found existing 'index.md' in afterpython/{content_type}/\n"
+            f"\n"
+            f"The 'index.md' file 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"\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"
+        )
+
+    index_content = f"""---
+title: ← {content_type.capitalize()}
+---
+
+This is a placeholder index page. The actual {content_type} landing page is rendered by SvelteKit.
+"""
+    index_file.write_text(index_content)
+    return index_file
+
+
 def _write_welcome_file(content_type: tContentType):
     welcome_file = ap.paths.afterpython_path / content_type / "index.md"
     if welcome_file.exists():
@@ -156,9 +198,6 @@ def init_myst():
             },
             "site": {
                 "options": {
-                    "favicon": "../static/favicon.svg",
-                    "logo": "../static/logo.svg",
-                    "logo_dark": "../static/logo.svg",
                     "analytics_google": "{{ GOOGLE_ANALYTICS_ID }}",
                     # "twitter": "",
                 },

afterpython/utils.py

@@ -224,3 +224,76 @@ def handle_passthrough_help(
             subprocess.run([*underlying_command, "--help"])
 
         ctx.exit(0)
+
+
+def normalize_static_path(path: str) -> str:
+    """
+    Normalize paths for static assets.
+
+    Only allows two formats:
+    1. Pure filename/path without ./ or ../ (e.g., "logo.svg", "somewhere/logo.svg")
+    2. Absolute path starting with / (e.g., "/somewhere/logo.svg")
+
+    Args:
+        path: User-provided path from afterpython.toml
+
+    Returns:
+        Normalized path
+
+    Raises:
+        ValueError: If path contains ./ or ../ or other invalid patterns
+
+    Examples:
+        >>> normalize_static_path("logo.svg")
+        'logo.svg'
+        >>> normalize_static_path("somewhere/logo.svg")
+        '/somewhere/logo.svg'
+        >>> normalize_static_path("/somewhere/logo.svg")
+        '/somewhere/logo.svg'
+        >>> normalize_static_path("./logo.svg")  # Raises ValueError
+        >>> normalize_static_path("../logo.svg")  # Raises ValueError
+        >>> normalize_static_path("static/logo.svg")  # Raises ValueError
+    """
+    if not path:
+        return ""
+
+    # Reject paths with ./ or ../
+    if "./" in path or "../" in path or path.startswith(".") or path.startswith(".."):
+        raise ValueError(
+            f"Invalid path '{path}': paths cannot contain './' or '../'. "
+            f"Use either a pure filename (e.g., 'logo.svg') or absolute path (e.g., '/somewhere/logo.svg')"
+        )
+
+    # Reject paths with 'static' in them
+    if "static" in path.lower():
+        raise ValueError(
+            f"Invalid path '{path}': do not include 'static' in the path. "
+            f"Files are assumed to be in the static/ directory."
+        )
+
+    # If it starts with /, it's absolute - keep as is
+    if not path.startswith("/"):
+        return "/" + path
+    else:
+        return path
+
+
+def get_relative_static_prefix(file_path: Path, content_type_path: Path) -> str:
+    """Calculate the relative path prefix from a file to its content type's static/ folder.
+
+    Args:
+        file_path: Path to the content file (e.g., blog/layer/blog5.ipynb)
+        content_type_path: Path to the content type folder (e.g., blog/)
+
+    Returns:
+        Relative prefix to reach static/ (e.g., "./" or "../" or "../../")
+    """
+    # Get the depth: how many directories deep the file is from content_type_path
+    relative = file_path.parent.relative_to(content_type_path)
+    depth = len(relative.parts)
+
+    # Build the correct prefix
+    if depth == 0:
+        return "./"  # File is directly in content_type_path
+    else:
+        return "../" * depth

{afterpython-0.1.0.dev17.dist-info → afterpython-0.1.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: afterpython
-Version: 0.1.0.dev17
+Version: 0.1.1
 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
@@ -20,12 +20,11 @@ Requires-Dist: httpx>=0.28.1
 Requires-Dist: tomlkit>=0.13.3
 Requires-Dist: ruamel-yaml>=0.18.16
 Requires-Dist: gitpython>=3.1.45
-Requires-Dist: pygithub>=2.8.1
 Requires-Dist: python-dotenv>=1.2.1
 Requires-Dist: pyproject-metadata>=0.10.0
-Requires-Dist: mystmd>=1.6.6
+Requires-Dist: mystmd>=1.7.0
 Requires-Dist: pdoc>=16.0.0
-Requires-Dist: ruff>=0.14.6
+Requires-Dist: ruff>=0.14.8
 Requires-Dist: pre-commit>=4.5.0
 Requires-Dist: commitizen>=4.10.0
 Requires-Python: >=3.11
@@ -105,6 +104,17 @@ ap init
 ```
 
 
+---
+## CLI Commands
+```bash
+# show all commands
+ap --help
+
+# or use terminal UI (TUI)
+ap tui
+```
+
+
 ---
 ## Tech Stack
 - [MyST]
@@ -119,8 +129,3 @@ ap init
 - [WebLLM]
 <!-- - ty -->
 <!-- - [pixi] -->
-
-
----
-## *Our Mission*
-> Only by making package maintenance and documentation easy can we encourage more Python developers to publish their own packages and grow the ecosystem even further.

afterpython-0.1.1.dist-info/RECORD

@@ -0,0 +1,57 @@
+afterpython/__init__.py,sha256=aNochs72gU2NR1cBzIkk3NxSsdJ7ceHluI5gdYwaFpI,289
+afterpython/_io/toml.py,sha256=dvmq6n4MhlJ02u_YjfC3mOnCWatfCn_J1lugavigoJw,3410
+afterpython/_io/yaml.py,sha256=raksve_gaIFJim8lQrq-kQHkRjTloed7CT2FY0oUJSg,654
+afterpython/_paths.py,sha256=FTwQ7necKYuRosCyMZPfv1eqaEmGIsyqd3yXpm-WQTA,1584
+afterpython/_typing.py,sha256=FbphSGoujPuTfCZqt0HaKQrBgzhRpCOEAEQU6Cbl7oA,145
+afterpython/builders/__init__.py,sha256=YMfYfsbSJNMjqfq9GRsQj8ayWUhtZKpvrc0oFUASICo,575
+afterpython/builders/content_json.py,sha256=-LTkeA8oA6XEudc2b1H7U0-UwcJlHn7xgICeweMYrG0,4805
+afterpython/builders/index_md.py,sha256=SDVHnVftL4D1AA8jw2YvRdTem_Ho8v8DcrORVjVtW8A,3762
+afterpython/builders/jupyter_notebook.py,sha256=2H5Qv_IIkmOud-GYZPYjB0E30fVZubpUUQ5gFrtGSqU,10140
+afterpython/builders/markdown.py,sha256=0ExfRqvOTWsgUkAVaGGNkiNDtNedRr7JR1yTGxpbsmA,8736
+afterpython/builders/metadata.py,sha256=--0zWaI0ZI1wKeezcyqSUy-h1IuLqnI33ateoAHIaBU,1337
+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=Vvyd7AkL2Tw3vEDhi4bEOWD9hdtxon7SgAzXUeh5D8w,9050
+afterpython/cli/commands/bump.py,sha256=2MZBQ1kxjr0bWhA--_xHwdwjsUlCyrXPn3pJ5NDZO4k,4088
+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=YIJECfroGRQnuMWWRC4W_DMA0eJoQssufj8WBDjQVOM,6796
+afterpython/cli/commands/format.py,sha256=VFwCG9KDTF6j4Y_Ewp4_RpS8uNBQNOAj9HU_G97my5A,710
+afterpython/cli/commands/init.py,sha256=UiE8QIhDV9NqoqU2EU_FMAlJ2Y18lFF0x2JmcyiAQxc,3044
+afterpython/cli/commands/init_branch_rules.py,sha256=fzAm8D5qbW3u4bEMpqPuRgO-0akuCGG7pu09JlKhYn4,243
+afterpython/cli/commands/install.py,sha256=B8JuQmtU_4EZpHct2J5j30BGLkGmvwKvU26upbmabvQ,750
+afterpython/cli/commands/lock.py,sha256=Kppu_0tnqdbP6Gbulxf123f-cFzTGIw39si2O7rDo3Q,603
+afterpython/cli/commands/pre_commit.py,sha256=QIuzTZEfw4uPMqmQT8YmyD0yewBcwjLvcnbVjRbonQE,1978
+afterpython/cli/commands/preview.py,sha256=sBwe46H0V-U7I4d0-u-nXmPBWGmkjKhkUTbqV927zRM,593
+afterpython/cli/commands/release.py,sha256=6SDEnPtuCL0_XUqWUlvRSKxAv011QqOD0kc5pKu7378,2479
+afterpython/cli/commands/remove.py,sha256=Fl79JSI9IdHyzYflocXxcxgBkBPkNFAW98Yuijly26g,1812
+afterpython/cli/commands/start.py,sha256=q4rUkIllOO8wJQ9ABtsx-dqkW1yC0vltAtSkiHN_GH4,4002
+afterpython/cli/commands/sync.py,sha256=u9L3aq04M5VHh0FByDSpmBD7F1RYCNsIgvZFifnRZ6A,6042
+afterpython/cli/commands/update.py,sha256=4h_zKp72e4RmXUKHyeP6kfHqr4V3IugSOnxa-E1F55I,6312
+afterpython/cli/main.py,sha256=m3BJ5rOlllUyOngD2HF2fosDLrduREzAQKpsTqcYPZc,4956
+afterpython/const.py,sha256=B_yUBmHPyu98aOibwt7idWbhKNBBed0TeYXNBd8tPTk,157
+afterpython/main.py,sha256=w0z6mTib3u4p2HxMrk-tIJlZtur7uRaqsbE0ewlYlSs,490
+afterpython/pcu.py,sha256=EoEhSzFZ49b5qc9KH2RLxIHSzY8YFM5uhtw07chcrr8,6093
+afterpython/templates/ci-workflow-template.yml,sha256=w0BiV9F_y9YNTd6mTD7xRlJgwRQw61AinhiACXlEQqk,5933
+afterpython/templates/cz-template.toml,sha256=2qwbQLb0nbZaA63oWXFFzvzPNBsFZHATL1C2rdNdjjs,185
+afterpython/templates/dependabot-template.yml,sha256=CBQEgh8EsXw2X7IqzGtFI7lVT9liF6PW4DvGLB0X2LY,1136
+afterpython/templates/deploy-workflow-template.yml,sha256=2W4K3lKMYjSTPrlXIsMweBzqP9IoLtZXAAcUu5FA5NA,2365
+afterpython/templates/pre-commit-config-template.yaml,sha256=u_JF4YHGHIWxLdcX5BS__VsVgOwwVQQsSZGPNR2Yyf0,915
+afterpython/templates/release-workflow-template.yml,sha256=3YBkgrqmi--uznslpMxPz7Vj7L4_NPlhDxgwYBt-Ui8,1606
+afterpython/templates/ruff-template.toml,sha256=lNCd4EthoLScr4cyVEgGUH4xK5CfIX3f9I3zkJHAYgg,1008
+afterpython/tools/_afterpython.py,sha256=G1075u8VT6s-TjEcGajqEYS3pZoW0sGyJM7DJohMOPE,4244
+afterpython/tools/_git.py,sha256=aO-qDEQ4OevD_B74DYKK4nQKYeiaS1BXmYc8paJRfbQ,3772
+afterpython/tools/branch_rules.py,sha256=ciQ2H2YBnoCZu_plyVeIHzf2FcAILRFhpjzOR2_IfJg,3159
+afterpython/tools/commitizen.py,sha256=ZO1qHmzUU0myd85tncv76WtIR7DB_AoQGSUvaf78Ohg,438
+afterpython/tools/github_actions.py,sha256=zVmg9aqUg-EO0CnbRHl9i8TmFtXpt7nd0VjzckqqE30,1527
+afterpython/tools/myst.py,sha256=2VO-gD25PbGSD8-v1sLI1v3Q9loahRd3ednKrW4_Utc,8113
+afterpython/tools/pre_commit.py,sha256=oNsrUkPI13rSSBSyhyTTKPnQGhDxLIPYhxu6kL0fDmo,1206
+afterpython/tools/pyproject.py,sha256=kb7BDn24yH_xS2F5_L0dK-GL4KgOJS-MIIUQhHnLorI,3507
+afterpython/utils.py,sha256=s1FIJP6FvpAcK8SujB8glFbiKx-ZCltywh5ihaOhL0U,9516
+afterpython/version.py,sha256=hihRV1S-gc1m46OaXD32ikkEkqzs-Gtq7AcAqOQV-wY,1603
+afterpython-0.1.1.dist-info/WHEEL,sha256=93kfTGt3a0Dykt_T-gsjtyS5_p8F_d6CE1NwmBOirzo,79
+afterpython-0.1.1.dist-info/entry_points.txt,sha256=roa0PDgBueM1JPbRG0G2OSxzaN394OUL_oS9iEwVLBc,80
+afterpython-0.1.1.dist-info/METADATA,sha256=aUAV_sBsqyVQouDgnzOfN7X96zSu4p7R_GB6FUvJr_o,5779
+afterpython-0.1.1.dist-info/RECORD,,

{afterpython-0.1.0.dev17.dist-info → afterpython-0.1.1.dist-info}/WHEEL

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

afterpython/builders/molab.py

@@ -1,100 +0,0 @@
-from __future__ import annotations
-
-from typing import TYPE_CHECKING
-
-if TYPE_CHECKING:
-    from afterpython._typing import tContentType
-
-import json
-from pathlib import Path
-
-from pyproject_metadata import StandardMetadata
-
-import afterpython as ap
-from afterpython.const import CONTENT_TYPES
-from afterpython.tools.pyproject import read_metadata
-
-
-def _get_molab_badge() -> str:
-    return "https://marimo.io/molab-shield.svg"
-
-
-def _create_molab_url(github_url: str, content_path: Path):
-    """Create a molab URL for a given content type and notebook path.
-    Args:
-        github_url: str, e.g. "https://github.com/AfterPythonOrg/afterpython"
-        content_path: str, e.g. "tutorial/test.ipynb"
-    """
-    github_url = github_url.replace("https://github.com/", "github/")
-    return f"https://molab.marimo.io/{github_url}/blob/main/afterpython/{content_path.as_posix()}"
-
-
-def add_molab_badge_to_jupyter_notebooks(content_type: tContentType):
-    """Add a badge markdown cell to the top of Jupyter notebooks in the given content type directory, e.g. tutorial/, blog/, etc.
-    # NOTE
-    Note that the jupyter notebooks need to exist in the github repository first.
-    If you have renamed a notebook, you need to push the changes to the github repository first for the badge to work.
-    """
-    assert content_type.lower() in CONTENT_TYPES, (
-        f"Invalid content type: {content_type}"
-    )
-    metadata: StandardMetadata = read_metadata()
-
-    if "repository" not in metadata.urls:
-        return "Repository URL not found in [project.urls] in pyproject.toml, cannot add molab badge"
-    else:
-        github_url = metadata.urls["repository"]
-
-    path = ap.paths.afterpython_path / content_type.lower()
-
-    # iterate over all files in the path
-    for notebook_path in path.rglob("*.ipynb"):
-        # Skip files in _build directory
-        if "_build" in notebook_path.parts:
-            continue
-
-        # Get path relative to afterpython/ (includes tutorial/ in the path)
-        content_path = notebook_path.relative_to(ap.paths.afterpython_path)
-        molab_url = _create_molab_url(github_url, content_path)
-        badge_md = f"[![Open in molab]({_get_molab_badge()})]({molab_url})"
-
-        # Read the notebook
-        try:
-            # Read the notebook
-            with open(notebook_path) as f:
-                notebook = json.load(f)
-        except json.JSONDecodeError:
-            print(f"✗ Skipping {content_path} - invalid or empty JSON")
-            continue
-        except Exception as e:
-            print(f"✗ Error reading {content_path}: {e}")
-            continue
-
-        # Validate notebook structure
-        if "cells" not in notebook:
-            print(f"✗ Skipping {content_path} - not a valid Jupyter notebook")
-            continue
-
-        # Create a markdown cell with the badge
-        badge_cell = {
-            "cell_type": "markdown",
-            "id": "molab-badge-cell",  # Unique ID for the badge cell
-            "metadata": {
-                "tags": ["molab", "hide-input"]  # Optional: use MyST tags
-            },
-            "source": [badge_md],
-        }
-
-        # Check if first cell is already a badge cell (avoid duplicates)
-        if notebook["cells"] and notebook["cells"][0].get("id") == "molab-badge-cell":
-            # Update existing badge
-            notebook["cells"][0] = badge_cell
-            print(f"✓ Updated molab badge in: {content_path}")
-        else:
-            # Insert at the beginning
-            notebook["cells"].insert(0, badge_cell)
-            print(f"✓ Added molab badge to: {content_path}")
-
-        # Write back
-        with open(notebook_path, "w") as f:
-            json.dump(notebook, f, indent=1)