afterpython 0.1.0__tar.gz → 0.1.0.dev5__tar.gz

{afterpython-0.1.0 → afterpython-0.1.0.dev5}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: afterpython
-Version: 0.1.0
-Summary: CLI tool to streamline Python package maintenance and generate a dedicated project website
+Version: 0.1.0.dev5
+Summary: CLI tool for AfterPython
 Keywords: package-maintenance,project-website,static-site-generator,developer-tools,documentation,cli-tool,ci/cd,mystmd,semantic-release,python-packaging
 Author: Stephen Yau
 Author-email: Stephen Yau <softwareentrepreneer+afterpython@gmail.com>
@@ -10,38 +10,39 @@ Classifier: Operating System :: OS Independent
 Classifier: Intended Audience :: Developers
 Classifier: Topic :: Software Development :: Build Tools
 Classifier: Topic :: Software Development :: Documentation
-Classifier: Typing :: Typed
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Requires-Dist: click>=8.3.1
 Requires-Dist: trogon>=0.6.0
 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.7.0
+Requires-Dist: pyproject-metadata>=0.9.1
+Requires-Dist: mystmd>=1.6.6
 Requires-Dist: pdoc>=16.0.0
-Requires-Dist: ruff>=0.14.8
-Requires-Dist: pre-commit>=4.5.0
+Requires-Dist: ruff>=0.14.5
+Requires-Dist: pre-commit>=4.4.0
 Requires-Dist: commitizen>=4.10.0
 Requires-Python: >=3.11
-Project-URL: documentation, https://afterpython.afterpython.org/doc
-Project-URL: homepage, https://afterpython.afterpython.org
+Project-URL: documentation, https://ap.afterpython.org/doc
+Project-URL: homepage, https://afterpython.org
 Project-URL: repository, https://github.com/AfterPythonOrg/afterpython
 Description-Content-Type: text/markdown
 
 # AfterPython: Python Package Maintenance Toolkit and Project Website Generator
 
 [![afterpython](https://afterpython.org/shield.svg)](https://afterpython.org)
+[![Pixi Badge](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/prefix-dev/pixi/main/assets/badge/v0.json)](https://pixi.sh)
 ![PyPI downloads](https://img.shields.io/pypi/dm/afterpython)
 [![PyPI](https://img.shields.io/pypi/v/afterpython.svg)](https://pypi.org/project/afterpython)
 ![PyPI - Support Python Versions](https://img.shields.io/pypi/pyversions/afterpython)
 [![Discussions](https://img.shields.io/badge/Discussions-Let's%20Chat-green)](https://github.com/AfterPythonOrg/afterpython/discussions)
 [![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/AfterPythonOrg/afterpython)
-<!-- [![Pixi Badge](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/prefix-dev/pixi/main/assets/badge/v0.json)](https://pixi.sh) -->
 
 
 [MyST]: https://mystmd.org
@@ -56,7 +57,6 @@ Description-Content-Type: text/markdown
 [Scikit-Learn]: https://scikit-learn.org
 [WebLLM]: https://webllm.mlc.ai/
 [project-website-template]: https://github.com/AfterPythonOrg/project-website-template
-[commitizen]: https://github.com/commitizen-tools/commitizen
 [uv]: https://docs.astral.sh/uv/
 [ruff]: https://docs.astral.sh/ruff/
 
@@ -75,54 +75,28 @@ First-time maintainers must learn multiple tools and concepts, e.g. [MyST], [Sem
 
 ## Core Features
 - [x] Write content directly in [MyST Markdown] or [Jupyter Notebook]
-- [x] Go from writing to **website deployment in minutes** — no need to learn any of the underlying tools
-- [x] Centralize all your content in a modern, **unified project website** — from documentation to blog posts
-- [x] Zero-config orchestration — Pre-configured modern tooling with sane defaults (see [Tech Stack](#tech-stack)), so you can start maintaining packages immediately **without learning each tool**
+- [x] Go from writing to website deployment in minutes — no need to learn any of the underlying tools
+- [x] Centralize all your content in a modern, unified project website — from documentation to blog posts
 - [ ] Export content as PDF — for example, combine all blog posts into a single PDF file
 - [ ] **⚡ Full-text search** across **ALL** your content in your website — docs, blogs, tutorials, everything
 - [ ] **🤖 Embedded AI Chatbot** that answers questions directly using an in-browser LLM — at no cost
 
----
-## Project Website
-> The project website for `afterpython` is created using `afterpython` itself. See the [**website**](https://afterpython.afterpython.org).
-<picture>
-  <source media="(prefers-color-scheme: dark)" srcset="afterpython/static/website-dark.png">
-  <source media="(prefers-color-scheme: light)" srcset="afterpython/static/website-light.png">
-  <img alt="Project Website" src="afterpython/static/website-light.png">
-</picture>
-
-You can create your own website too and deploy it to GitHub Pages in **less than a minute**! See [Quickstart](https://afterpython.afterpython.org/doc/quickstart).
 
----
 ## Installation
 ```bash
 # install afterpython as a dev dependency
 uv add --dev afterpython
-
 # initialize afterpython
 ap init
 ```
 
 
----
-## CLI Commands
-```bash
-# show all commands
-ap --help
-
-# or use terminal UI (TUI)
-ap tui
-```
-
-
----
 ## Tech Stack
 - [MyST]
 - [project-website-template]
 - [pre-commit]
 - [GitHub Actions]
 - [pdoc]
-- [commitizen]
 - [uv]
 - [ruff]
 - [pagefind]

{afterpython-0.1.0 → afterpython-0.1.0.dev5}/README.md

@@ -1,12 +1,12 @@
 # AfterPython: Python Package Maintenance Toolkit and Project Website Generator
 
 [![afterpython](https://afterpython.org/shield.svg)](https://afterpython.org)
+[![Pixi Badge](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/prefix-dev/pixi/main/assets/badge/v0.json)](https://pixi.sh)
 ![PyPI downloads](https://img.shields.io/pypi/dm/afterpython)
 [![PyPI](https://img.shields.io/pypi/v/afterpython.svg)](https://pypi.org/project/afterpython)
 ![PyPI - Support Python Versions](https://img.shields.io/pypi/pyversions/afterpython)
 [![Discussions](https://img.shields.io/badge/Discussions-Let's%20Chat-green)](https://github.com/AfterPythonOrg/afterpython/discussions)
 [![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/AfterPythonOrg/afterpython)
-<!-- [![Pixi Badge](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/prefix-dev/pixi/main/assets/badge/v0.json)](https://pixi.sh) -->
 
 
 [MyST]: https://mystmd.org
@@ -21,7 +21,6 @@
 [Scikit-Learn]: https://scikit-learn.org
 [WebLLM]: https://webllm.mlc.ai/
 [project-website-template]: https://github.com/AfterPythonOrg/project-website-template
-[commitizen]: https://github.com/commitizen-tools/commitizen
 [uv]: https://docs.astral.sh/uv/
 [ruff]: https://docs.astral.sh/ruff/
 
@@ -40,54 +39,28 @@ First-time maintainers must learn multiple tools and concepts, e.g. [MyST], [Sem
 
 ## Core Features
 - [x] Write content directly in [MyST Markdown] or [Jupyter Notebook]
-- [x] Go from writing to **website deployment in minutes** — no need to learn any of the underlying tools
-- [x] Centralize all your content in a modern, **unified project website** — from documentation to blog posts
-- [x] Zero-config orchestration — Pre-configured modern tooling with sane defaults (see [Tech Stack](#tech-stack)), so you can start maintaining packages immediately **without learning each tool**
+- [x] Go from writing to website deployment in minutes — no need to learn any of the underlying tools
+- [x] Centralize all your content in a modern, unified project website — from documentation to blog posts
 - [ ] Export content as PDF — for example, combine all blog posts into a single PDF file
 - [ ] **⚡ Full-text search** across **ALL** your content in your website — docs, blogs, tutorials, everything
 - [ ] **🤖 Embedded AI Chatbot** that answers questions directly using an in-browser LLM — at no cost
 
----
-## Project Website
-> The project website for `afterpython` is created using `afterpython` itself. See the [**website**](https://afterpython.afterpython.org).
-<picture>
-  <source media="(prefers-color-scheme: dark)" srcset="afterpython/static/website-dark.png">
-  <source media="(prefers-color-scheme: light)" srcset="afterpython/static/website-light.png">
-  <img alt="Project Website" src="afterpython/static/website-light.png">
-</picture>
-
-You can create your own website too and deploy it to GitHub Pages in **less than a minute**! See [Quickstart](https://afterpython.afterpython.org/doc/quickstart).
 
----
 ## Installation
 ```bash
 # install afterpython as a dev dependency
 uv add --dev afterpython
-
 # initialize afterpython
 ap init
 ```
 
 
----
-## CLI Commands
-```bash
-# show all commands
-ap --help
-
-# or use terminal UI (TUI)
-ap tui
-```
-
-
----
 ## Tech Stack
 - [MyST]
 - [project-website-template]
 - [pre-commit]
 - [GitHub Actions]
 - [pdoc]
-- [commitizen]
 - [uv]
 - [ruff]
 - [pagefind]

afterpython-0.1.0/src/afterpython/templates/pre-commit-config-template.yaml → afterpython-0.1.0.dev5/afterpython/.pre-commit-config.yaml

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

{afterpython-0.1.0/src → afterpython-0.1.0.dev5}/afterpython/_io/toml.py

@@ -1,11 +1,9 @@
 from __future__ import annotations
-
 from typing import TYPE_CHECKING
 
 if TYPE_CHECKING:
-    from pathlib import Path
-
     from tomlkit.toml_document import TOMLDocument
+    from pathlib import Path
 
 import tomlkit
 
@@ -18,7 +16,7 @@ def _from_tomlkit(value):
     - tomlkit containers → plain Python containers
     - tomlkit primitives → plain Python primitives
     """
-    from tomlkit.items import AoT, Array, InlineTable, Table
+    from tomlkit.items import Array, InlineTable, Table, AoT
 
     if value is None:
         return None
@@ -60,7 +58,7 @@ def _to_tomlkit(value):
     - List of dicts → array of inline tables: [{key = val}]
     - Nested dicts → nested tables with proper structure
     """
-    from tomlkit import array, inline_table
+    from tomlkit import inline_table, array
 
     if value is None:
         return None

{afterpython-0.1.0/src → afterpython-0.1.0.dev5}/afterpython/_typing.py

@@ -1,4 +1,5 @@
-from typing import Literal, TypeAlias
+from typing import TypeAlias, Literal
+
 
 NodeEnv: TypeAlias = dict[str, str]
 tContentType = Literal["doc", "blog", "tutorial", "example", "guide"]

afterpython-0.1.0.dev5/afterpython/builders/__init__.py

@@ -0,0 +1,8 @@
+from afterpython.builders.metadata import build_metadata
+from afterpython.builders.molab import add_molab_badge_to_jupyter_notebooks
+
+
+__all__ = (
+    "add_molab_badge_to_jupyter_notebooks",
+    "build_metadata",
+)

{afterpython-0.1.0/src → afterpython-0.1.0.dev5}/afterpython/builders/metadata.py

@@ -1,5 +1,4 @@
 from __future__ import annotations
-
 from typing import TYPE_CHECKING
 
 if TYPE_CHECKING:
@@ -7,10 +6,9 @@ if TYPE_CHECKING:
 
 import json
 
-import click
-
 import afterpython as ap
 
+
 build_path = ap.paths.build_path
 
 
@@ -25,22 +23,20 @@ def convert_paths():
         markdown_text = metadata["description"]
 
     # Replace with the correct paths
-    updated_markdown = markdown_text.replace("afterpython/static/", "/")
+    updated_markdown = markdown_text.replace("./afterpython/static/", "/")
 
     # Write back to metadata.json
     metadata["description"] = updated_markdown
     with open(build_path / "metadata.json", "w") as f:
         json.dump(metadata, f, indent=2)
 
-    click.echo("Completed path conversion in metadata.json")
+    print("Completed path conversion in metadata.json")
 
 
 def build_metadata():
     """Build metadata.json using pyproject.toml"""
     from afterpython.tools.pyproject import read_metadata
 
-    click.echo("Building metadata.json...")
-
     metadata: StandardMetadata = read_metadata()
 
     # Write to metadata.json

afterpython-0.1.0.dev5/afterpython/builders/molab.py

@@ -0,0 +1,99 @@
+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.tools.pyproject import read_metadata
+from afterpython.const import CONTENT_TYPES
+
+
+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)

{afterpython-0.1.0/src → afterpython-0.1.0.dev5}/afterpython/cli/__init__.py

@@ -1,3 +1,4 @@
 from afterpython.cli.main import afterpython_group
 
+
 __all__ = ["afterpython_group"]

afterpython-0.1.0.dev5/afterpython/cli/commands/build.py

@@ -0,0 +1,190 @@
+from __future__ import annotations
+from typing import TYPE_CHECKING
+from collections.abc import Callable
+
+if TYPE_CHECKING:
+    from afterpython._typing import NodeEnv
+    from pathlib import Path
+
+import os
+import shutil
+import subprocess
+
+import click
+from click.exceptions import Exit
+
+import afterpython as ap
+from afterpython.utils import find_node_env
+from afterpython.const import CONTENT_TYPES
+from afterpython.builders import (
+    build_metadata,
+    add_molab_badge_to_jupyter_notebooks,
+)
+
+
+def prebuild():
+    def _check_initialized():
+        # Check if 'ap init' has been run
+        afterpython_toml = ap.paths.afterpython_path / "afterpython.toml"
+        if not afterpython_toml.exists():
+            raise click.ClickException(
+                "AfterPython is not initialized!\n"
+                "Run 'ap init' first to set up your project."
+            )
+
+    def _clean_build_directory():
+        print("Cleaning up build directory...")
+        build_path = ap.paths.build_path
+        if build_path.exists():
+            shutil.rmtree(build_path)
+        build_path.mkdir(parents=True, exist_ok=True)
+
+    _check_initialized()
+    _clean_build_directory()
+
+    if os.getenv("AP_MOLAB_BADGE", "0") == "1":
+        for content_type in CONTENT_TYPES:
+            add_molab_badge_to_jupyter_notebooks(content_type)
+
+
+def postbuild():
+    def _move_files(
+        source: Path,
+        destination: Path,
+        is_copy: bool = True,
+        ignore_copy: Callable[[str, list[str]], set[str]] | None = None,
+    ):
+        """
+        Move or copy files from source to destination.
+
+        Args:
+            source: Source path
+            destination: Destination path
+            is_copy: If True, copy files (merge with existing). If False, move files (replace destination)
+            ignore_copy: Optional ignore function for copytree, takes (directory, contents) and returns set of names to ignore
+        """
+        if not source.exists():
+            return
+        if is_copy:
+            shutil.copytree(source, destination, dirs_exist_ok=True, ignore=ignore_copy)
+            print(f"Copied: {source} to {destination}")
+        else:
+            # Remove destination if it exists (move will fail otherwise)
+            if destination.exists():
+                shutil.rmtree(destination)
+            shutil.move(str(source), str(destination))
+            print(f"Moved: {source} to {destination}")
+
+    website_static = ap.paths.website_path / "static"
+    website_static.mkdir(parents=True, exist_ok=True)
+
+    for content_type in CONTENT_TYPES:
+        myst_build = ap.paths.afterpython_path / content_type / "_build"
+        afterpython_content_build = ap.paths.build_path / content_type
+        # Move myst builds from afterpython/{content_type}/_build to afterpython/_build/{content_type}
+        _move_files(myst_build, afterpython_content_build, is_copy=False)
+        # Copy afterpython/_build/{content_type}/html to afterpython/_website/static/{content_type}
+        _move_files(
+            afterpython_content_build / "html",
+            website_static / content_type,
+            is_copy=True,
+        )
+
+    # Copy all files from afterpython/_build to afterpython/_website/static/
+    _move_files(
+        ap.paths.build_path,
+        website_static,
+        is_copy=True,
+        # ignore all content builds e.g. doc/, blog/, only their html/ files will be copied
+        ignore_copy=lambda dir, contents: [
+            name for name in contents if name in CONTENT_TYPES
+        ],
+    )
+
+    # Copy all static files from afterpython/static/ to afterpython/_website/static/
+    _move_files(ap.paths.static_path, website_static, is_copy=True)
+
+
+@click.command(
+    add_help_option=False,  # disable click's --help option so that ap build --help can work
+    context_settings=dict(
+        ignore_unknown_options=True,
+        allow_extra_args=True,
+    ),
+)
+@click.pass_context
+@click.option(
+    "--dev",
+    is_flag=True,
+    hidden=True,  # Internal flag used by `ap dev`, not exposed to users
+    help="Development build - only build metadata for the landing page, skip content and production builds",
+)
+@click.option(
+    "--execute", is_flag=True, help="Execute Jupyter notebooks for all content types"
+)
+def build(ctx, dev: bool, execute: bool):
+    """Build the project website and all contents for production.
+
+    This command builds MyST content (doc/blog/tutorial/example/guide) and the SvelteKit website.
+
+    Any extra arguments are passed to the 'myst build --html' command for each content type.
+    See "myst build --help" for more details.
+
+    Use --execute to execute Jupyter notebooks for all content types.
+    """
+    from afterpython.utils import has_content_for_myst
+    from afterpython.utils import handle_passthrough_help
+
+    # Show both our options and myst's help and exit
+    handle_passthrough_help(
+        ctx,
+        ["myst", "build"],
+        show_underlying=True,
+    )
+
+    paths = ctx.obj["paths"]
+    prebuild()
+
+    click.echo("Building metadata.json...")
+    build_metadata()
+
+    # myst's production build
+    if not dev:
+        node_env: NodeEnv = find_node_env()
+        for content_type in CONTENT_TYPES:
+            content_path = paths.afterpython_path / content_type
+            if not has_content_for_myst(content_path):
+                click.echo(f"Skipping {content_type}/ (no content files found)")
+                continue
+
+            click.echo(f"Building {content_type}/...")
+            # NOTE: needs to set BASE_URL so that the project website can link to the content pages correctly at e.g. localhost:5173/doc
+            # BASE_PATH is set by the GitHub Actions workflow
+            base_path = os.getenv("BASE_PATH", "")
+            base_url = f"{base_path}/{content_type}"
+            build_env = {**node_env, "BASE_URL": base_url}
+            result = subprocess.run(
+                [
+                    "myst",
+                    "build",
+                    "--html",
+                    *(["--execute"] if execute else []),
+                    *ctx.args,
+                ],
+                cwd=content_path,
+                env=build_env,
+                check=False,
+            )
+            if result.returncode != 0:
+                raise Exit(result.returncode)
+
+    postbuild()
+
+    # website's production build
+    if not dev:
+        click.echo("Building project website...")
+        result = subprocess.run(
+            ["pnpm", "build"], cwd=paths.website_path, env=node_env, check=False
+        )
+        if result.returncode != 0:
+            raise Exit(result.returncode)

{afterpython-0.1.0/src → afterpython-0.1.0.dev5}/afterpython/cli/commands/bump.py

@@ -1,9 +1,6 @@
 import subprocess
 
 import click
-from click.exceptions import Exit
-
-from afterpython.utils import has_pixi
 
 
 @click.command(
@@ -89,30 +86,3 @@ def bump(ctx, release: bool, pre: bool):
                 args = ["--prerelease", prerelease_type, *ctx.args]
 
         subprocess.run(["ap", "cz", "bump", *args])
-
-    # Update pixi.lock after version bump (editable install requires lock refresh)
-    if has_pixi():
-        result = subprocess.run(["pixi", "install"], check=False)
-        if result.returncode != 0:
-            raise Exit(result.returncode)
-
-        # Check if pixi.lock was modified
-        status = subprocess.run(
-            ["git", "diff", "--name-only", "pixi.lock"],
-            capture_output=True,
-            text=True,
-            check=False,
-        )
-        if status.stdout.strip():
-            # Stage and commit pixi.lock
-            subprocess.run(["git", "add", "pixi.lock"], check=True)
-            subprocess.run(
-                [
-                    "git",
-                    "commit",
-                    "-m",
-                    "build: update pixi.lock after version bump",
-                ],
-                check=True,
-            )
-            click.echo("✓ Committed pixi.lock update")

{afterpython-0.1.0/src → afterpython-0.1.0.dev5}/afterpython/cli/commands/check.py

@@ -13,7 +13,7 @@ from click.exceptions import Exit
 )
 @click.pass_context
 def check(ctx):
-    """Run ruff linter (uses afterpython/ruff.toml if available)"""
+    """Simple wrapper for ruff check for convenience, always use the afterpython/ruff.toml if it exists"""
     from afterpython.utils import handle_passthrough_help
 
     # Show both our options and ruff's help and exit

{afterpython-0.1.0/src → afterpython-0.1.0.dev5}/afterpython/cli/commands/clean.py

@@ -1,5 +1,4 @@
 from __future__ import annotations
-
 from typing import TYPE_CHECKING
 
 if TYPE_CHECKING:
@@ -11,8 +10,8 @@ import subprocess
 import click
 from click.exceptions import Exit
 
-from afterpython.const import CONTENT_TYPES
 from afterpython.utils import find_node_env, has_content_for_myst
+from afterpython.const import CONTENT_TYPES
 
 
 @click.command(
@@ -26,10 +25,10 @@ from afterpython.utils import find_node_env, has_content_for_myst
 @click.option(
     "--all",
     is_flag=True,
-    help="Also clean AfterPython build directories (_build/ and _website/build/)",
+    help='--all passed to "myst clean", also clean afterpython build directories (_build/ and _website/build/)',
 )
 def clean(ctx, all: bool):
-    """Clean build artifacts from content types and website"""
+    """Clean the build directory"""
     from afterpython.utils import handle_passthrough_help
 
     # Show both our options and myst's help and exit