afterpython 0.1.0.dev7__tar.gz → 0.1.0.dev9__tar.gz

{afterpython-0.1.0.dev7 → afterpython-0.1.0.dev9}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: afterpython
-Version: 0.1.0.dev7
-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,10 +10,10 @@ 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
@@ -22,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
@@ -76,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
@@ -91,16 +92,20 @@ First-time maintainers must learn multiple tools and concepts, e.g. [MyST], [Sem
   <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
 ```
 
 
+---
 ## Tech Stack
 - [MyST]
 - [project-website-template]
@@ -114,3 +119,8 @@ 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.0.dev7 → afterpython-0.1.0.dev9}/README.md

@@ -40,8 +40,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
@@ -55,16 +56,20 @@ First-time maintainers must learn multiple tools and concepts, e.g. [MyST], [Sem
   <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
 ```
 
 
+---
 ## Tech Stack
 - [MyST]
 - [project-website-template]
@@ -78,3 +83,8 @@ 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.0.dev7 → afterpython-0.1.0.dev9}/pyproject.toml

@@ -1,7 +1,7 @@
 [project]
 name = "afterpython"
-version = "0.1.0.dev7"
-description = "CLI tool for AfterPython"
+version = "0.1.0.dev9"
+description = "CLI tool to streamline Python package maintenance and generate a dedicated project website"
 license = "Apache-2.0"
 authors = [
     { name = "Stephen Yau", email = "softwareentrepreneer+afterpython@gmail.com" },
@@ -24,10 +24,11 @@ classifiers = [
     "Intended Audience :: Developers",
     "Topic :: Software Development :: Build Tools",
     "Topic :: Software Development :: Documentation",
+    "Typing :: Typed",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
-    "Programming Language :: Python :: 3.14",
+    # "Programming Language :: Python :: 3.14",
 ]
 requires-python = ">=3.11"
 dependencies = [
@@ -39,13 +40,13 @@ dependencies = [
     "gitpython>=3.1.45",
     "pygithub>=2.8.1",
     "python-dotenv>=1.2.1",
-    "pyproject-metadata>=0.9.1",
+    "pyproject-metadata>=0.10.0",
     # "jupytext>=1.18.1",
     # "jinja2>=3.1.6",
     "mystmd>=1.6.6",
     "pdoc>=16.0.0",
-    "ruff>=0.14.5",
-    "pre-commit>=4.4.0",
+    "ruff>=0.14.6",
+    "pre-commit>=4.5.0",
     "commitizen>=4.10.0",
     # "python-semantic-release>=10.5.2",
 ]
@@ -64,40 +65,9 @@ pcu = "afterpython.main:run_pcu"
 override-dependencies = ["platformdirs>=4.5.0", "nodeenv>=1.9.1"]
 
 [build-system]
-requires = ["uv_build>=0.9.10,<0.10.0"]
+requires = ["uv_build>=0.9.13,<0.10.0"]
 build-backend = "uv_build"
 
-[dependency-groups]
-dev = ["notebook>=7.4.7"]
-
 [tool.uv.build-backend]
 module-name = "afterpython"
-module-root = ""
-source-exclude = [
-    "afterpython/doc",
-    "afterpython/blog",
-    "afterpython/tutorial",
-    "afterpython/example",
-    "afterpython/guide",
-    "afterpython/static",
-    "afterpython/_website",
-    "afterpython/_build",
-    "afterpython/ruff.toml",
-    "afterpython/afterpython.toml",
-    "afterpython/authors.yml",
-    "afterpython/faq.yml",
-]
-wheel-exclude = [
-    "afterpython/doc",
-    "afterpython/blog",
-    "afterpython/tutorial",
-    "afterpython/example",
-    "afterpython/guide",
-    "afterpython/static",
-    "afterpython/_website",
-    "afterpython/_build",
-    "afterpython/ruff.toml",
-    "afterpython/afterpython.toml",
-    "afterpython/authors.yml",
-    "afterpython/faq.yml",
-]
+module-root = "src"

{afterpython-0.1.0.dev7 → afterpython-0.1.0.dev9/src}/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-0.1.0.dev7 → afterpython-0.1.0.dev9/src}/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-0.1.0.dev7 → afterpython-0.1.0.dev9/src}/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-0.1.0.dev7 → afterpython-0.1.0.dev9/src}/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-0.1.0.dev7 → afterpython-0.1.0.dev9/src}/afterpython/cli/__init__.py

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

afterpython-0.1.0.dev9/src/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-0.1.0.dev7 → afterpython-0.1.0.dev9/src}/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()
@@ -77,7 +79,7 @@ def prebuild():
     _check_initialized()
     _clean_build_directory()
 
-    if os.getenv("AP_MOLAB_BADGE", "0") == "1":
+    if os.getenv("AP_MOLAB_BADGE", "1") == "1":
         for content_type in CONTENT_TYPES:
             add_molab_badge_to_jupyter_notebooks(content_type)
 
@@ -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-0.1.0.dev7 → afterpython-0.1.0.dev9/src}/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-0.1.0.dev7 → afterpython-0.1.0.dev9/src}/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-0.1.0.dev7 → afterpython-0.1.0.dev9/src}/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-0.1.0.dev7 → afterpython-0.1.0.dev9/src}/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",
@@ -47,18 +47,24 @@ def init_website():
 
 
 @click.command()
+@click.option(
+    "--yes",
+    "-y",
+    is_flag=True,
+    help="Automatically answer yes to all prompts",
+)
 @click.pass_context
-def init(ctx):
+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 (
-        init_release_workflow,
-        init_deploy_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...")
@@ -79,20 +85,28 @@ def init(ctx):
 
     init_website()
 
-    if click.confirm(
+    create_workflow("deploy")
+    create_workflow("ci")
+
+    if yes or click.confirm(
         f"\nCreate .pre-commit-config.yaml in {afterpython_path}?", default=True
     ):
         init_pre_commit()
 
-    if click.confirm(f"\nCreate ruff.toml in {afterpython_path}?", default=True):
+    if yes or click.confirm(f"\nCreate ruff.toml in {afterpython_path}?", default=True):
         init_ruff_toml()
 
-    if click.confirm(
+    if yes or click.confirm(
         f"\nCreate commitizen configuration (cz.toml) in {afterpython_path} "
         f"and release workflow in .github/workflows/release.yml?",
         default=True,
     ):
         init_commitizen()
-        init_release_workflow()
+        create_workflow("release")
 
-    init_deploy_workflow()
+    if yes or click.confirm(
+        "\nCreate Dependabot configuration (.github/dependabot.yml) "
+        "to auto-update GitHub Actions versions?",
+        default=True,
+    ):
+        create_dependabot()

afterpython-0.1.0.dev9/src/afterpython/cli/commands/init_branch_rules.py

@@ -0,0 +1,9 @@
+import click
+
+
+@click.command()
+def init_branch_rules():
+    """Create default branch protection rules for the current repository"""
+    from afterpython.tools.branch_rules import create_default_branch_rules
+
+    create_default_branch_rules()

{afterpython-0.1.0.dev7 → afterpython-0.1.0.dev9/src}/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-0.1.0.dev9/src/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-0.1.0.dev9/src/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)