afterpython 0.1.0.dev8__py3-none-any.whl → 0.1.0.dev9__py3-none-any.whl

afterpython/_io/toml.py

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

afterpython/_paths.py

@@ -1,5 +1,5 @@
-from pathlib import Path
 from dataclasses import dataclass, field
+from pathlib import Path
 
 
 @dataclass

afterpython/_typing.py

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

afterpython/builders/__init__.py

@@ -1,7 +1,6 @@
 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/builders/metadata.py

@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 from typing import TYPE_CHECKING
 
 if TYPE_CHECKING:
@@ -8,7 +9,6 @@ import json
 
 import afterpython as ap
 
-
 build_path = ap.paths.build_path
 
 

afterpython/builders/molab.py

@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 from typing import TYPE_CHECKING
 
 if TYPE_CHECKING:
@@ -10,8 +11,8 @@ 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
+from afterpython.tools.pyproject import read_metadata
 
 
 def _get_molab_badge() -> str:

afterpython/cli/__init__.py

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

afterpython/cli/commands/add.py

@@ -0,0 +1,67 @@
+import subprocess
+
+import click
+from click.exceptions import Exit
+
+from afterpython.utils import has_pixi, has_uv
+
+
+@click.command()
+@click.option(
+    "--optional",
+    type=str,
+    default=None,
+    required=False,
+    help="Add to an optional dependency group (pixi: mapped to 'optional' feature)",
+)
+@click.option(
+    "--group",
+    type=str,
+    default=None,
+    required=False,
+    help="Add to a dependency group (pixi: mapped to same-named feature)",
+)
+@click.argument("lib", type=str, required=True)
+def add(optional: str | None, group: str | None, lib: str):
+    """Add a new dependency to the project (manages both uv and pixi if present)"""
+    if not has_uv():
+        click.echo("uv not found. Please install uv first.")
+        return
+
+    if optional and group:
+        click.echo("Error: Cannot specify both --optional and --group")
+        raise Exit(1)
+
+    result = subprocess.run(
+        [
+            "uv",
+            "add",
+            *(["--optional", optional] if optional else []),
+            *(["--group", group] if group else []),
+            lib,
+        ],
+        check=False,
+    )
+    if result.returncode != 0:
+        raise Exit(result.returncode)
+
+    if has_pixi():
+        # NOTE: pixi doesn't support --optional, so we need to use --feature instead
+        if optional:
+            feature_name = "optional"
+        elif group:
+            feature_name = group
+        else:
+            feature_name = None
+        result = subprocess.run(
+            [
+                "pixi",
+                "add",
+                "--pypi",
+                *(["--feature", feature_name] if feature_name else []),
+                lib,
+            ],
+            check=False,
+        )
+        if result.returncode != 0:
+            raise Exit(result.returncode)

afterpython/cli/commands/build.py

@@ -1,11 +1,13 @@
 from __future__ import annotations
-from typing import TYPE_CHECKING
+
 from collections.abc import Callable
+from typing import TYPE_CHECKING
 
 if TYPE_CHECKING:
-    from afterpython._typing import NodeEnv
     from pathlib import Path
 
+    from afterpython._typing import NodeEnv
+
 import os
 import shutil
 import subprocess
@@ -14,12 +16,12 @@ 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,
+    build_metadata,
 )
+from afterpython.const import CONTENT_TYPES
+from afterpython.utils import find_node_env
 
 
 def determine_base_path() -> str:
@@ -29,9 +31,9 @@ def determine_base_path() -> str:
         Empty string if custom domain is configured (no github.io in URL)
         /repo-name if using default GitHub Pages URL (contains github.io)
     """
+    from afterpython._io.toml import _from_tomlkit
     from afterpython.tools._afterpython import read_afterpython
     from afterpython.tools.pyproject import read_metadata
-    from afterpython._io.toml import _from_tomlkit
 
     # Read website URL from afterpython.toml
     afterpython = read_afterpython()
@@ -167,8 +169,7 @@ def build(ctx, dev: bool, execute: bool):
 
     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
+    from afterpython.utils import handle_passthrough_help, has_content_for_myst
 
     # Show both our options and myst's help and exit
     handle_passthrough_help(

afterpython/cli/commands/clean.py

@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 from typing import TYPE_CHECKING
 
 if TYPE_CHECKING:
@@ -10,8 +11,8 @@ import subprocess
 import click
 from click.exceptions import Exit
 
-from afterpython.utils import find_node_env, has_content_for_myst
 from afterpython.const import CONTENT_TYPES
+from afterpython.utils import find_node_env, has_content_for_myst
 
 
 @click.command(

afterpython/cli/commands/commit.py

@@ -15,7 +15,13 @@ import click
 @click.option(
     "--no-cz", "--no-commitizen", is_flag=True, help="Skip running 'cz commit'"
 )
-def commit(ctx, no_cz: bool):
+@click.option(
+    "--no-pc",
+    "--no-pre-commit",
+    is_flag=True,
+    help="Skip running pre-commit checks before commit",
+)
+def commit(ctx, no_cz: bool, no_pc: bool):
     """Run 'cz commit'"""
     from afterpython.utils import handle_passthrough_help
 
@@ -26,6 +32,15 @@ def commit(ctx, no_cz: bool):
         show_underlying=True,
     )
 
+    # Run pre-commit checks first (unless --no-pc is set)
+    if not no_pc:
+        result = subprocess.run(["ap", "pc", "run"])
+        if result.returncode != 0:
+            click.echo(
+                "❌ Pre-commit checks failed. Please fix the issues and try again."
+            )
+            ctx.exit(1)
+
     if not no_cz:
         subprocess.run(["ap", "cz", "commit", *ctx.args])
     else:

afterpython/cli/commands/dev.py

@@ -1,17 +1,18 @@
 from __future__ import annotations
+
 from typing import TYPE_CHECKING
 
 if TYPE_CHECKING:
     from afterpython._typing import NodeEnv
 
-import time
 import subprocess
+import time
 
 import click
 from click.exceptions import Exit
 
-from afterpython.utils import find_node_env, find_available_port
 from afterpython.const import CONTENT_TYPES
+from afterpython.utils import find_available_port, find_node_env
 
 
 @click.command(

afterpython/cli/commands/init.py

@@ -22,7 +22,7 @@ def init_ruff_toml():
         "repos": [
             {
                 "repo": "https://github.com/astral-sh/ruff-pre-commit",
-                "rev": "v0.14.5",
+                "rev": "v0.14.6",
                 "hooks": [
                     {
                         "id": "ruff-check",
@@ -56,15 +56,15 @@ def init_website():
 @click.pass_context
 def init(ctx, yes):
     """Initialize afterpython with MyST Markdown (by default) and project website template"""
-    from afterpython.tools.pyproject import init_pyproject
     from afterpython.tools._afterpython import init_afterpython
-    from afterpython.tools.myst import init_myst
-    from afterpython.tools.pre_commit import init_pre_commit
     from afterpython.tools.commitizen import init_commitizen
     from afterpython.tools.github_actions import (
-        create_workflow,
         create_dependabot,
+        create_workflow,
     )
+    from afterpython.tools.myst import init_myst
+    from afterpython.tools.pre_commit import init_pre_commit
+    from afterpython.tools.pyproject import init_pyproject
 
     paths = ctx.obj["paths"]
     click.echo("Initializing afterpython...")

afterpython/cli/commands/install.py

@@ -3,7 +3,7 @@ import subprocess
 import click
 from click.exceptions import Exit
 
-from afterpython.utils import has_uv
+from afterpython.utils import has_pixi, has_uv
 
 
 @click.command(
@@ -13,10 +13,16 @@ from afterpython.utils import has_uv
     )
 )
 def install():
-    """Run 'uv sync --all-extras --all-groups' to install all dependencies"""
+    """Install all dependencies (runs 'uv sync --all-extras --all-groups' and 'pixi install' if present)"""
     if not has_uv():
         click.echo("uv not found. Please install uv first.")
         return
+
     result = subprocess.run(["uv", "sync", "--all-extras", "--all-groups"], check=False)
     if result.returncode != 0:
         raise Exit(result.returncode)
+
+    if has_pixi():
+        result = subprocess.run(["pixi", "install"], check=False)
+        if result.returncode != 0:
+            raise Exit(result.returncode)

afterpython/cli/commands/lock.py

@@ -0,0 +1,23 @@
+import subprocess
+
+import click
+from click.exceptions import Exit
+
+from afterpython.utils import has_pixi, has_uv
+
+
+@click.command()
+def lock():
+    """Lock the dependencies (runs 'uv lock' and 'pixi lock' if present)"""
+    if not has_uv():
+        click.echo("uv not found. Please install uv first.")
+        return
+
+    result = subprocess.run(["uv", "lock"], check=False)
+    if result.returncode != 0:
+        raise Exit(result.returncode)
+
+    if has_pixi():
+        result = subprocess.run(["pixi", "lock"], check=False)
+        if result.returncode != 0:
+            raise Exit(result.returncode)

afterpython/cli/commands/remove.py

@@ -0,0 +1,67 @@
+import subprocess
+
+import click
+from click.exceptions import Exit
+
+from afterpython.utils import has_pixi, has_uv
+
+
+@click.command()
+@click.option(
+    "--optional",
+    type=str,
+    default=None,
+    required=False,
+    help="Remove from an optional dependency group (pixi: mapped to 'optional' feature)",
+)
+@click.option(
+    "--group",
+    type=str,
+    default=None,
+    required=False,
+    help="Remove from a dependency group (pixi: mapped to same-named feature)",
+)
+@click.argument("lib", type=str, required=True)
+def remove(optional: str | None, group: str | None, lib: str):
+    """Remove a dependency from the project (manages both uv and pixi if present)"""
+    if not has_uv():
+        click.echo("uv not found. Please install uv first.")
+        return
+
+    if optional and group:
+        click.echo("Error: Cannot specify both --optional and --group")
+        raise Exit(1)
+
+    result = subprocess.run(
+        [
+            "uv",
+            "remove",
+            *(["--optional", optional] if optional else []),
+            *(["--group", group] if group else []),
+            lib,
+        ],
+        check=False,
+    )
+    if result.returncode != 0:
+        raise Exit(result.returncode)
+
+    if has_pixi():
+        # NOTE: pixi doesn't support --optional, so we need to use --feature instead
+        if optional:
+            feature_name = "optional"
+        elif group:
+            feature_name = group
+        else:
+            feature_name = None
+        result = subprocess.run(
+            [
+                "pixi",
+                "remove",
+                "--pypi",
+                *(["--feature", feature_name] if feature_name else []),
+                lib,
+            ],
+            check=False,
+        )
+        if result.returncode != 0:
+            raise Exit(result.returncode)

afterpython/cli/commands/start.py

@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 from typing import TYPE_CHECKING
 
 if TYPE_CHECKING:
@@ -9,7 +10,6 @@ import subprocess
 import click
 from click.exceptions import Exit
 
-
 command_kwargs = {
     "add_help_option": False,  # disable click's --help option so that myst start --help can work
     "context_settings": dict(
@@ -43,9 +43,12 @@ command_kwargs = {
 )
 def start(ctx, doc: bool, blog: bool, tutorial: bool, example: bool, guide: bool):
     """Simple wrapper for `myst start` for convenience"""
-    from afterpython.utils import find_node_env, has_content_for_myst
     from afterpython.const import CONTENT_TYPES
-    from afterpython.utils import handle_passthrough_help
+    from afterpython.utils import (
+        find_node_env,
+        handle_passthrough_help,
+        has_content_for_myst,
+    )
 
     # Show both our options and myst's help and exit
     handle_passthrough_help(

afterpython/cli/commands/sync.py

@@ -10,8 +10,8 @@ from afterpython.utils import convert_author_name_to_id
 
 def _sync_authors_yml(authors: list[tuple[str, str | None]]):
     """Sync authors.yml with authors in pyproject.toml"""
-    from afterpython.tools.myst import update_authors_yml
     from afterpython._io.yaml import read_yaml
+    from afterpython.tools.myst import update_authors_yml
 
     # read myst.yml from docs path to get "version"
     doc_myst_yml = read_yaml(ap.paths.afterpython_path / "doc" / "myst.yml")
@@ -37,15 +37,15 @@ 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"""
+    from afterpython._io.toml import _from_tomlkit
     from afterpython.const import CONTENT_TYPES
     from afterpython.tools._afterpython import read_afterpython
+    from afterpython.tools.myst import update_myst_yml
     from afterpython.tools.pyproject import (
         read_metadata,
         read_pyproject,
         write_pyproject,
     )
-    from afterpython._io.toml import _from_tomlkit
-    from afterpython.tools.myst import update_myst_yml
 
     pyproject: StandardMetadata = read_metadata()
     project_name = str(pyproject.name)

afterpython/cli/commands/update.py

@@ -1,12 +1,13 @@
 from __future__ import annotations
+
 from typing import TYPE_CHECKING
 
 if TYPE_CHECKING:
     from afterpython._typing import NodeEnv
     from afterpython.pcu import Dependencies
 
-import subprocess
 import shutil
+import subprocess
 
 import click
 from click.exceptions import Exit
@@ -33,7 +34,7 @@ def update():
 def dependencies(upgrade: bool, all: bool):
     """Update pyproject.toml dependencies to the latest version"""
     from afterpython.pcu import get_dependencies, update_dependencies
-    from afterpython.utils import has_uv
+    from afterpython.utils import has_pixi, has_uv
 
     dependencies: Dependencies = get_dependencies()
     has_at_least_one_update = False
@@ -79,7 +80,9 @@ def dependencies(upgrade: bool, all: bool):
                 raise Exit(result.returncode)
             click.echo(
                 click.style(
-                    "✓ All dependencies upgraded successfully 🎉", fg="green", bold=True
+                    "✓ All dependencies in pyproject.toml upgraded successfully 🎉",
+                    fg="green",
+                    bold=True,
                 )
             )
         else:
@@ -89,6 +92,26 @@ def dependencies(upgrade: bool, all: bool):
     if all:
         subprocess.run(["ap", "pre-commit", "autoupdate"])
         click.echo("All pre-commit hooks updated successfully.")
+        if has_pixi():
+            click.echo("Upgrading dependencies with pixi...")
+            result = subprocess.run(
+                ["pixi", "upgrade", "--exclude", "python"], check=False
+            )
+            if result.returncode != 0:
+                raise Exit(result.returncode)
+            result = subprocess.run(["pixi", "lock"], check=False)
+            if result.returncode != 0:
+                raise Exit(result.returncode)
+            result = subprocess.run(["pixi", "install"], check=False)
+            if result.returncode != 0:
+                raise Exit(result.returncode)
+            click.echo(
+                click.style(
+                    "✓ All dependencies in pixi.toml upgraded successfully 🎉",
+                    fg="green",
+                    bold=True,
+                )
+            )
 
 
 update.add_command(dependencies, name="deps")  # alias for "dependencies"

afterpython/cli/main.py

@@ -1,33 +1,89 @@
 import os
 import subprocess
+from collections import defaultdict
 
 import click
+from dotenv import find_dotenv, load_dotenv
 from trogon import tui
-from dotenv import load_dotenv, find_dotenv
 
 import afterpython as ap
 from afterpython import __version__
-from afterpython.cli.commands.init import init
+from afterpython.cli.commands.add import add
 from afterpython.cli.commands.build import build
-from afterpython.cli.commands.dev import dev
-from afterpython.cli.commands.update import update
+from afterpython.cli.commands.bump import bump
 from afterpython.cli.commands.check import check
-from afterpython.cli.commands.install import install
-from afterpython.cli.commands.format import format
-from afterpython.cli.commands.sync import sync
-from afterpython.cli.commands.start import start, doc, blog, tutorial, example, guide
-from afterpython.cli.commands.preview import preview
 from afterpython.cli.commands.clean import clean
-from afterpython.cli.commands.pre_commit import pre_commit
-from afterpython.cli.commands.commitizen import commitizen
 from afterpython.cli.commands.commit import commit
-from afterpython.cli.commands.bump import bump
-from afterpython.cli.commands.release import release
+from afterpython.cli.commands.commitizen import commitizen
+from afterpython.cli.commands.dev import dev
+from afterpython.cli.commands.format import format
+from afterpython.cli.commands.init import init
 from afterpython.cli.commands.init_branch_rules import init_branch_rules
+from afterpython.cli.commands.install import install
+from afterpython.cli.commands.lock import lock
+from afterpython.cli.commands.pre_commit import pre_commit
+from afterpython.cli.commands.preview import preview
+from afterpython.cli.commands.release import release
+from afterpython.cli.commands.remove import remove
+from afterpython.cli.commands.start import blog, doc, example, guide, start, tutorial
+from afterpython.cli.commands.sync import sync
+from afterpython.cli.commands.update import update
+
+
+class AliasGroup(click.Group):
+    """Custom group that displays command aliases together."""
+
+    def __init__(self, *args, **kwargs):
+        super().__init__(*args, **kwargs)
+        self._aliases = defaultdict(list)  # Maps primary command -> list of aliases
+        self._alias_to_primary = {}  # Maps alias -> primary command name
+
+    def add_command(self, cmd, name=None):
+        """Track aliases when the same command is added with different names."""
+        name = name or cmd.name
+
+        # Check if this command object was already added under a different name
+        for existing_name, existing_cmd in self.commands.items():
+            if existing_cmd is cmd and existing_name != name:
+                # This is an alias
+                self._aliases[existing_name].append(name)
+                self._alias_to_primary[name] = existing_name
+                break
+
+        super().add_command(cmd, name)
+
+    def format_commands(self, ctx, formatter):
+        """Format commands with aliases shown together."""
+        commands = []
+        for subcommand in self.list_commands(ctx):
+            # Skip aliases - they'll be shown with their primary command
+            if subcommand in self._alias_to_primary:
+                continue
+
+            cmd = self.get_command(ctx, subcommand)
+            if cmd is None:
+                continue
+
+            # Skip hidden commands
+            if cmd.hidden:
+                continue
+
+            help_text = cmd.get_short_help_str(limit=formatter.width)
+
+            # Build command name with aliases
+            aliases = self._aliases.get(subcommand, [])
+            if aliases:
+                subcommand = f"{subcommand}, {', '.join(aliases)}"
+
+            commands.append((subcommand, help_text))
+
+        if commands:
+            with formatter.section("Commands"):
+                formatter.write_dl(commands)
 
 
 @tui(command="tui", help="Open terminal UI")
-@click.group(context_settings={"help_option_names": ["-h", "--help"]})
+@click.group(cls=AliasGroup, context_settings={"help_option_names": ["-h", "--help"]})
 @click.pass_context
 @click.version_option(version=__version__)
 def afterpython_group(ctx):
@@ -65,10 +121,12 @@ afterpython_group.add_command(preview)
 afterpython_group.add_command(clean)
 afterpython_group.add_command(pre_commit)
 afterpython_group.add_command(pre_commit, name="pc")
-afterpython_group.add_command(pre_commit, name="precommit")
 afterpython_group.add_command(commitizen)
 afterpython_group.add_command(commitizen, name="cz")
 afterpython_group.add_command(commit)
 afterpython_group.add_command(bump)
 afterpython_group.add_command(release)
 afterpython_group.add_command(init_branch_rules)
+afterpython_group.add_command(add)
+afterpython_group.add_command(remove)
+afterpython_group.add_command(lock)

afterpython/const.py

@@ -1,5 +1,4 @@
 from afterpython._typing import tContentType
 
-
 NODEENV_VERSION = "24.11.0"
 CONTENT_TYPES: set[tContentType] = {"doc", "blog", "tutorial", "example", "guide"}

afterpython/pcu.py

@@ -3,7 +3,8 @@ pcu = "pip check updates", similar to ncu (npm check updates in Node.js)
 """
 
 from __future__ import annotations
-from typing import TYPE_CHECKING, TypedDict, NamedTuple, TypeAlias
+
+from typing import TYPE_CHECKING, NamedTuple, TypeAlias, TypedDict
 
 if TYPE_CHECKING:
     from tomlkit.toml_document import TOMLDocument
@@ -60,6 +61,7 @@ async def get_latest_versions(
 ) -> dict[str, Version | None]:
     """Get latest versions for a list of dependencies from PyPI."""
     import httpx
+
     from afterpython.utils import fetch_pypi_json
 
     async def fetch_version(

afterpython/templates/ruff-template.toml

@@ -18,7 +18,7 @@ ignore = [
 ]
 # extended rules:
 extend-select = [
-    # "I",     # isort - import sorting
+    "I",     # isort - import sorting
     "UP",    # pyupgrade - upgrade syntax for newer Python
     "B",     # flake8-bugbear - find likely bugs
     "SIM",   # flake8-simplify - simplify code

afterpython/tools/_afterpython.py

@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 from typing import TYPE_CHECKING
 
 if TYPE_CHECKING:
@@ -7,7 +8,7 @@ if TYPE_CHECKING:
 import tomlkit
 
 import afterpython as ap
-from afterpython._io.toml import read_toml, write_toml, _to_tomlkit
+from afterpython._io.toml import _to_tomlkit, read_toml, write_toml
 
 
 def read_afterpython() -> TOMLDocument:

afterpython/tools/branch_rules.py

@@ -9,7 +9,6 @@ from copy import deepcopy
 
 from afterpython.tools._git import is_gh_authenticated
 
-
 DEFAULT_RULESET = {
     "name": "afterpython-default",  # The ruleset identifier in GitHub
     "target": "branch",  # This ruleset applies to branches (not tags)

afterpython/tools/commitizen.py

@@ -1,6 +1,5 @@
 import afterpython as ap
 
-
 commitizen_default = {
     "tool": {
         "commitizen": {
@@ -36,8 +35,8 @@ commitizen_pre_commit_hook = {
 
 
 def init_commitizen():
-    from afterpython.tools.pre_commit import update_pre_commit
     from afterpython._io.toml import write_toml
+    from afterpython.tools.pre_commit import update_pre_commit
 
     afterpython_path = ap.paths.afterpython_path
     commitizen_toml_path = afterpython_path / "cz.toml"

afterpython/tools/myst.py

@@ -1,15 +1,17 @@
 from __future__ import annotations
+
 from typing import TYPE_CHECKING
 
 if TYPE_CHECKING:
     from pathlib import Path
-    from afterpython._typing import tContentType, NodeEnv
+
+    from afterpython._typing import NodeEnv, tContentType
 
 import subprocess
 
 import afterpython as ap
+from afterpython._io.yaml import read_yaml, write_yaml
 from afterpython.utils import deep_merge
-from afterpython._io.yaml import write_yaml, read_yaml
 
 
 def update_authors_yml(data_update: dict):

afterpython/tools/pre_commit.py

@@ -1,9 +1,7 @@
 import subprocess
 
 import afterpython as ap
-
-from afterpython._io.yaml import write_yaml, read_yaml
-
+from afterpython._io.yaml import read_yaml, write_yaml
 
 pre_commit_default = {
     # default is only ["pre-commit"], without changing the default,

afterpython/tools/pyproject.py

@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 from typing import TYPE_CHECKING
 
 if TYPE_CHECKING:
@@ -9,7 +10,7 @@ import asyncio
 from pyproject_metadata import StandardMetadata
 
 import afterpython as ap
-from afterpython._io.toml import read_toml, write_toml, _to_tomlkit
+from afterpython._io.toml import _to_tomlkit, read_toml, write_toml
 
 
 def read_pyproject() -> TOMLDocument:
@@ -32,8 +33,9 @@ def init_pyproject():
     - add [project.urls] section with homepage, repository, and documentation URLs
     """
     import httpx
-    from afterpython.utils import fetch_pypi_json
+
     from afterpython.tools._git import get_git_user_config, get_github_url
+    from afterpython.utils import fetch_pypi_json
 
     build_backend = "uv_build"
 

afterpython/utils.py

@@ -1,9 +1,12 @@
 from __future__ import annotations
+
 from typing import TYPE_CHECKING
 
 if TYPE_CHECKING:
     from pathlib import Path
+
     from httpx import AsyncClient
+
     from afterpython._typing import NodeEnv
 
 import os
@@ -20,6 +23,7 @@ def find_node_env() -> NodeEnv:
     If no, install the Node.js version specified in NODEENV_VERSION
     """
     from mystmd_py.nodeenv import find_any_node
+
     from afterpython.const import NODEENV_VERSION
 
     # from mystmd_py.main import ensure_valid_version

{afterpython-0.1.0.dev8.dist-info → afterpython-0.1.0.dev9.dist-info}/METADATA

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: afterpython
-Version: 0.1.0.dev8
-Summary: CLI tool for AfterPython
+Version: 0.1.0.dev9
+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
 Author-email: Stephen Yau <softwareentrepreneer+afterpython@gmail.com>
@@ -10,6 +10,7 @@ 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
@@ -21,11 +22,11 @@ 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.9.1
+Requires-Dist: pyproject-metadata>=0.10.0
 Requires-Dist: mystmd>=1.6.6
 Requires-Dist: pdoc>=16.0.0
-Requires-Dist: ruff>=0.14.5
-Requires-Dist: pre-commit>=4.4.0
+Requires-Dist: ruff>=0.14.6
+Requires-Dist: pre-commit>=4.5.0
 Requires-Dist: commitizen>=4.10.0
 Requires-Python: >=3.11
 Project-URL: documentation, https://afterpython.afterpython.org/doc
@@ -75,8 +76,9 @@ 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] 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**
 - [ ] 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

afterpython-0.1.0.dev9.dist-info/RECORD

@@ -0,0 +1,52 @@
+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=_3x9_xP3xmMn3lJTsKZBrEC8kKFXZfkSa6KhNk1TyLQ,214
+afterpython/builders/metadata.py,sha256=NkhKQLCmdzRId_tHNldIC3h3an3QQPjqBRGnhr9az1U,1273
+afterpython/builders/molab.py,sha256=viQ3HY5tnMiHjrgsm4BAMuYtTpiFJ0SDYzcm1TyoRDI,3715
+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=kFVdu0tNn82qaHVDS9tUKHYwH73zE3adkRBG_c2t44c,8020
+afterpython/cli/commands/bump.py,sha256=Wg-q3UQIkIRGT3umZCUBPpwIQTAHwQZVs1yHSZhmzKE,3088
+afterpython/cli/commands/check.py,sha256=cLP4Vle3ENQHCXBv1okDlWK-L1XK-fv80m66xW3LQkg,1097
+afterpython/cli/commands/clean.py,sha256=ZNhOwxcdxhkzqLPwDJ2_NPLnvMz3C1EKyNttXTyIHnI,2532
+afterpython/cli/commands/commit.py,sha256=TKhlybJxbcChMzZJuTfYafCrYUraqyBpLJ4TP0WA-xs,1335
+afterpython/cli/commands/commitizen.py,sha256=naI8j4pfXIMsiOLmPMeZTGh831I3665_1_Sbn7yoKyE,811
+afterpython/cli/commands/dev.py,sha256=zuto7Z6nfD1FAhZkhZNoLhxVH78Eo3W3iO6QujOMXII,6753
+afterpython/cli/commands/format.py,sha256=cXvuc-6XwULM1VJjS2B2bJBvnV1TVHFl1CeSs0SYQ24,738
+afterpython/cli/commands/init.py,sha256=lyNcE-fmgXyLGoSRkvHg_xpDt9gnySemTh-0m6lX0Ws,3354
+afterpython/cli/commands/init_branch_rules.py,sha256=fzAm8D5qbW3u4bEMpqPuRgO-0akuCGG7pu09JlKhYn4,243
+afterpython/cli/commands/install.py,sha256=K3xYzU7XOts_xdERyd4q3wUFv0hythy7ZP6jr9N_6L4,777
+afterpython/cli/commands/lock.py,sha256=WAfZY4Jb7XLl7_zcjxCAs8VCGitX-zPlkXLTkPtOqDs,605
+afterpython/cli/commands/pre_commit.py,sha256=DdmbkcZgJ7QArAY1y5vODYZmHUXWEIuXRyp69AS-pn0,1981
+afterpython/cli/commands/preview.py,sha256=EbuB-dFcgonmqumTb2aHlLpXRiXkGE4DI3ddJdHwcaM,619
+afterpython/cli/commands/release.py,sha256=6SDEnPtuCL0_XUqWUlvRSKxAv011QqOD0kc5pKu7378,2479
+afterpython/cli/commands/remove.py,sha256=Fl79JSI9IdHyzYflocXxcxgBkBPkNFAW98Yuijly26g,1812
+afterpython/cli/commands/start.py,sha256=nXMOYQmAWqsqLphm09qxag83aLI7_w3TxjJQQt2CQjk,3992
+afterpython/cli/commands/sync.py,sha256=2PQA_jxH701l_Ijmr4hZV6K-f_G1Wx7lRScDttT3-9E,4669
+afterpython/cli/commands/update.py,sha256=inMdpNNtyDdh7311sIFwEiNzetXCzjSFG8YhyM9GVh0,6393
+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=2L-SRPB2GKlfR4bQAgpdq4r9bFdT9vCYo4oWjnIzKfg,5933
+afterpython/templates/dependabot-template.yml,sha256=CBQEgh8EsXw2X7IqzGtFI7lVT9liF6PW4DvGLB0X2LY,1136
+afterpython/templates/deploy-workflow-template.yml,sha256=2W4K3lKMYjSTPrlXIsMweBzqP9IoLtZXAAcUu5FA5NA,2365
+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=aZdRJ9dprA1HFchDFTqreJbrsI_HTPUaxtuBinVz10I,1905
+afterpython/tools/_git.py,sha256=aO-qDEQ4OevD_B74DYKK4nQKYeiaS1BXmYc8paJRfbQ,3772
+afterpython/tools/branch_rules.py,sha256=ciQ2H2YBnoCZu_plyVeIHzf2FcAILRFhpjzOR2_IfJg,3159
+afterpython/tools/commitizen.py,sha256=xpLZJuEqrRxCYz8la6po1PIlECk9O1BuAgsmSE1EY3I,1468
+afterpython/tools/github_actions.py,sha256=zVmg9aqUg-EO0CnbRHl9i8TmFtXpt7nd0VjzckqqE30,1527
+afterpython/tools/myst.py,sha256=fh0FtgL9A1dmFa98QKsWFqExsG7hPRP3nrj62U9PmaA,6603
+afterpython/tools/pre_commit.py,sha256=U4cazFxaZmyamk_n-85sL6BLOttURm-I2giksgE0qb8,2191
+afterpython/tools/pyproject.py,sha256=YiSbW-bXYtFCkXRl_Ibdca2OeYZT0lsqzRRjZFxMcp4,2327
+afterpython/utils.py,sha256=Uh4pTGeavH5pf8GCeMYQGqs3iPpZzjjAJ_R7t2mhEyY,7045
+afterpython/version.py,sha256=hihRV1S-gc1m46OaXD32ikkEkqzs-Gtq7AcAqOQV-wY,1603
+afterpython-0.1.0.dev9.dist-info/WHEEL,sha256=3id4o64OvRm9dUknh3mMJNcfoTRK08ua5cU6DFyVy-4,79
+afterpython-0.1.0.dev9.dist-info/entry_points.txt,sha256=roa0PDgBueM1JPbRG0G2OSxzaN394OUL_oS9iEwVLBc,80
+afterpython-0.1.0.dev9.dist-info/METADATA,sha256=-67mS-Do6Uw1T_KvopXaXvAJafgaAgbX_oaAzDUJqWo,5906
+afterpython-0.1.0.dev9.dist-info/RECORD,,

{afterpython-0.1.0.dev8.dist-info → afterpython-0.1.0.dev9.dist-info}/WHEEL

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

afterpython-0.1.0.dev8.dist-info/RECORD

@@ -1,49 +0,0 @@
-afterpython/__init__.py,sha256=aNochs72gU2NR1cBzIkk3NxSsdJ7ceHluI5gdYwaFpI,289
-afterpython/_io/toml.py,sha256=nrx0CFPONgmkz5WDCSMyr4caic6nzu0uCd33qOmhhF0,3408
-afterpython/_io/yaml.py,sha256=raksve_gaIFJim8lQrq-kQHkRjTloed7CT2FY0oUJSg,654
-afterpython/_paths.py,sha256=1NrPQ4erjA_rIvDggx7QRY4_01zyU-yht9s95Q-4YgM,1584
-afterpython/_typing.py,sha256=kmxBRbhft85C8Ycm5BFBP258Jozrw9tsl7KHOVPcF_o,146
-afterpython/builders/__init__.py,sha256=MOv3spIh-ABwyUtvQAHhPZ2horWb0D93WNmOPNAzKYo,215
-afterpython/builders/metadata.py,sha256=fj7rlawZCh43aJrBBfcmOTlYew1aW-om3QTpVulKbOk,1273
-afterpython/builders/molab.py,sha256=Qji8piWJB1tbzhgtld0pQWIsUA7d7RsGCfnoLVKd5EA,3714
-afterpython/cli/__init__.py,sha256=1vLZylRMnGaV7cJ-kHO96dChp33_P4fBIJ_Vi-yyZg4,85
-afterpython/cli/commands/build.py,sha256=14C30vDU1SaR_5RVnA62lAAzX_eSRnlEfZI5h5AIrsk,8051
-afterpython/cli/commands/bump.py,sha256=Wg-q3UQIkIRGT3umZCUBPpwIQTAHwQZVs1yHSZhmzKE,3088
-afterpython/cli/commands/check.py,sha256=cLP4Vle3ENQHCXBv1okDlWK-L1XK-fv80m66xW3LQkg,1097
-afterpython/cli/commands/clean.py,sha256=dCEkkWOTn93758wGTrWJG9V6c-lv2Z59CYfoP3i3rJE,2531
-afterpython/cli/commands/commit.py,sha256=yRLOBs6JetZSGkFy9_uLzgR8yAX9djeUF291gabtuUo,880
-afterpython/cli/commands/commitizen.py,sha256=naI8j4pfXIMsiOLmPMeZTGh831I3665_1_Sbn7yoKyE,811
-afterpython/cli/commands/dev.py,sha256=yI1g0v7HlVaVH6HwcHyukLYMyUbZjAd0BiCYk9QGdGw,6752
-afterpython/cli/commands/format.py,sha256=cXvuc-6XwULM1VJjS2B2bJBvnV1TVHFl1CeSs0SYQ24,738
-afterpython/cli/commands/init.py,sha256=EDX6ojHJyQzaYTef2BjaWoy4_yL-bf6DAnCKa-ylfTU,3354
-afterpython/cli/commands/init_branch_rules.py,sha256=fzAm8D5qbW3u4bEMpqPuRgO-0akuCGG7pu09JlKhYn4,243
-afterpython/cli/commands/install.py,sha256=wgH9DEuN7hsA6BslNJASqOBn4VHJrYHBvowXDHi4smE,573
-afterpython/cli/commands/pre_commit.py,sha256=DdmbkcZgJ7QArAY1y5vODYZmHUXWEIuXRyp69AS-pn0,1981
-afterpython/cli/commands/preview.py,sha256=EbuB-dFcgonmqumTb2aHlLpXRiXkGE4DI3ddJdHwcaM,619
-afterpython/cli/commands/release.py,sha256=6SDEnPtuCL0_XUqWUlvRSKxAv011QqOD0kc5pKu7378,2479
-afterpython/cli/commands/start.py,sha256=PnO1ECXnYtJxTOoDgG2ZoiVnkJVYNhPT63rabronjZ0,3992
-afterpython/cli/commands/sync.py,sha256=epgD8VvrkYB1GSKMu4UFQb3-uGjyiLzw8CjtjaGB6zs,4669
-afterpython/cli/commands/update.py,sha256=f6dzoJIiEod7j44dgnaFe-v7INVdUbopVoWPxv7-Mpo,5491
-afterpython/cli/main.py,sha256=_M5Z3msEZEZ4sIWeM8hvEmnrt9Qd2PHbC_GjibdKVfk,2832
-afterpython/const.py,sha256=KsALiC1kERK9BQQdYRXSHdYosxVExxgDN7iGYMAJrZE,158
-afterpython/main.py,sha256=w0z6mTib3u4p2HxMrk-tIJlZtur7uRaqsbE0ewlYlSs,490
-afterpython/pcu.py,sha256=RWgPcdAFyNBVhWbQPuL1seji9uyT8Pqz-zE6jCf_Qb8,6091
-afterpython/templates/ci-workflow-template.yml,sha256=2L-SRPB2GKlfR4bQAgpdq4r9bFdT9vCYo4oWjnIzKfg,5933
-afterpython/templates/dependabot-template.yml,sha256=CBQEgh8EsXw2X7IqzGtFI7lVT9liF6PW4DvGLB0X2LY,1136
-afterpython/templates/deploy-workflow-template.yml,sha256=2W4K3lKMYjSTPrlXIsMweBzqP9IoLtZXAAcUu5FA5NA,2365
-afterpython/templates/release-workflow-template.yml,sha256=3YBkgrqmi--uznslpMxPz7Vj7L4_NPlhDxgwYBt-Ui8,1606
-afterpython/templates/ruff-template.toml,sha256=_yTtZ0YPsJiCxy66ZDfYaStTJ9aXXW-JXy-KW6l2bBE,1010
-afterpython/tools/_afterpython.py,sha256=W88GhtQADB09DV4A24GOYBeYrHsnVVzllLdWFiKgS1A,1904
-afterpython/tools/_git.py,sha256=aO-qDEQ4OevD_B74DYKK4nQKYeiaS1BXmYc8paJRfbQ,3772
-afterpython/tools/branch_rules.py,sha256=Tn6PdiZjj3duQd2u2wa89Cgbkun1lT4tGbbK9Eb71Ck,3160
-afterpython/tools/commitizen.py,sha256=9aGXsO4tTyDs3s8qS_fiskdSabHqc9XjHwePThybJU0,1469
-afterpython/tools/github_actions.py,sha256=zVmg9aqUg-EO0CnbRHl9i8TmFtXpt7nd0VjzckqqE30,1527
-afterpython/tools/myst.py,sha256=w24zqWRUOLaZIC0twpGM4BF__wldmrgIvbns0FFdunA,6601
-afterpython/tools/pre_commit.py,sha256=stXUQfR0A6nPMCSuuKO-Icjc5F2z9VsZu2mKkIW1vWI,2193
-afterpython/tools/pyproject.py,sha256=YwJJAB3lIqYK9wt8UtL4dfCli9UN7uzi3e-vtycB0HE,2325
-afterpython/utils.py,sha256=LcQCXUw3OlgSeSliRm_ivq4kt7EX-_Nh7YunrYD7TqA,7041
-afterpython/version.py,sha256=hihRV1S-gc1m46OaXD32ikkEkqzs-Gtq7AcAqOQV-wY,1603
-afterpython-0.1.0.dev8.dist-info/WHEEL,sha256=AaqHSNJgTyoT6I9ETCXrbV_7cVSjA_q07lkDGeNjGdQ,79
-afterpython-0.1.0.dev8.dist-info/entry_points.txt,sha256=roa0PDgBueM1JPbRG0G2OSxzaN394OUL_oS9iEwVLBc,80
-afterpython-0.1.0.dev8.dist-info/METADATA,sha256=qSdlGSV3R2ip84sSGFOR7tNGiOz4y2KPSmnHef0sZ1w,5604
-afterpython-0.1.0.dev8.dist-info/RECORD,,