afterpython 0.4.0__tar.gz → 0.4.1__tar.gz

{afterpython-0.4.0 → afterpython-0.4.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: afterpython
-Version: 0.4.0
+Version: 0.4.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
@@ -11,26 +11,27 @@ Classifier: Intended Audience :: Developers
 Classifier: Topic :: Software Development :: Build Tools
 Classifier: Topic :: Software Development :: Documentation
 Classifier: Typing :: Typed
-Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
-Requires-Dist: click>=8.5.0
+Classifier: Programming Language :: Python :: 3.15
+Requires-Dist: click>=8.5.1
 Requires-Dist: trogon>=0.6.0
-Requires-Dist: httpx2>=2.13.1
-Requires-Dist: tomlkit>=0.15.1
+Requires-Dist: httpx2>=2.16.0
+Requires-Dist: tomlkit>=0.15.2
 Requires-Dist: ruamel-yaml>=0.19.1
-Requires-Dist: gitpython>=3.2.0
-Requires-Dist: python-dotenv>=1.2.3
+Requires-Dist: gitpython>=3.2.1
+Requires-Dist: python-dotenv>=1.2.4
 Requires-Dist: pyproject-metadata>=0.12.1
-Requires-Dist: jupytext>=1.19.5
-Requires-Dist: mystmd>=1.11.0
+Requires-Dist: jupytext>=1.19.6
+Requires-Dist: mystmd>=1.12.0
 Requires-Dist: pdoc>=16.0.0
-Requires-Dist: ruff>=0.16.9
-Requires-Dist: prek>=0.5.4
-Requires-Dist: ty>=0.0.84
+Requires-Dist: ruff>=0.17.4
+Requires-Dist: prek>=0.5.10
+Requires-Dist: ty>=0.0.99
 Requires-Dist: git-cliff>=2.14.2
-Requires-Dist: marimo[recommended,lsp]>=0.25.0 ; extra == 'marimo'
-Requires-Python: >=3.12
+Requires-Dist: questionary>=2.1.1
+Requires-Dist: marimo[recommended,lsp]>=0.25.2 ; extra == 'marimo'
+Requires-Python: >=3.13
 Project-URL: homepage, https://afterpython.afterpython.org
 Project-URL: repository, https://github.com/AfterPythonOrg/afterpython
 Project-URL: documentation, https://afterpython.afterpython.org/doc
@@ -44,8 +45,8 @@ Description-Content-Type: text/markdown
 [![PyPI](https://img.shields.io/pypi/v/afterpython.svg?cacheSeconds=300)](https://pypi.org/project/afterpython)
 ![PyPI - Support Python Versions](https://img.shields.io/pypi/pyversions/afterpython?cacheSeconds=300)
 [![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)
 [![View Code Wiki](https://assets.codewiki.google/readme-badge/static.svg)](https://codewiki.google/github.com/afterpythonorg/afterpython?utm_source=badge&utm_medium=github&utm_campaign=github.com/afterpythonorg/afterpython)
+<!--[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/AfterPythonOrg/afterpython)-->
 <!-- ![PyPI downloads](https://img.shields.io/pypi/dm/afterpython) -->
 <!-- [![Pixi Badge](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/prefix-dev/pixi/main/assets/badge/v0.json)](https://pixi.sh) -->
 

{afterpython-0.4.0 → afterpython-0.4.1}/README.md

@@ -5,8 +5,8 @@
 [![PyPI](https://img.shields.io/pypi/v/afterpython.svg?cacheSeconds=300)](https://pypi.org/project/afterpython)
 ![PyPI - Support Python Versions](https://img.shields.io/pypi/pyversions/afterpython?cacheSeconds=300)
 [![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)
 [![View Code Wiki](https://assets.codewiki.google/readme-badge/static.svg)](https://codewiki.google/github.com/afterpythonorg/afterpython?utm_source=badge&utm_medium=github&utm_campaign=github.com/afterpythonorg/afterpython)
+<!--[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/AfterPythonOrg/afterpython)-->
 <!-- ![PyPI downloads](https://img.shields.io/pypi/dm/afterpython) -->
 <!-- [![Pixi Badge](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/prefix-dev/pixi/main/assets/badge/v0.json)](https://pixi.sh) -->
 

{afterpython-0.4.0 → afterpython-0.4.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "afterpython"
-version = "0.4.0"
+version = "0.4.1"
 description = "CLI tool to streamline Python package maintenance and generate a dedicated project website"
 license = "Apache-2.0"
 readme = "README.md"
@@ -22,27 +22,28 @@ classifiers = [
     "Topic :: Software Development :: Build Tools",
     "Topic :: Software Development :: Documentation",
     "Typing :: Typed",
-    "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
     "Programming Language :: Python :: 3.14",
+    "Programming Language :: Python :: 3.15",
 ]
-requires-python = ">=3.12"
+requires-python = ">=3.13"
 dependencies = [
-    "click>=8.5.0",
+    "click>=8.5.1",
     "trogon>=0.6.0",
-    "httpx2>=2.13.1",
-    "tomlkit>=0.15.1",
+    "httpx2>=2.16.0",
+    "tomlkit>=0.15.2",
     "ruamel-yaml>=0.19.1",
-    "gitpython>=3.2.0",
-    "python-dotenv>=1.2.3",
+    "gitpython>=3.2.1",
+    "python-dotenv>=1.2.4",
     "pyproject-metadata>=0.12.1",
-    "jupytext>=1.19.5",
-    "mystmd>=1.11.0",
+    "jupytext>=1.19.6",
+    "mystmd>=1.12.0",
     "pdoc>=16.0.0",
-    "ruff>=0.16.9",
-    "prek>=0.5.4",
-    "ty>=0.0.84",
+    "ruff>=0.17.4",
+    "prek>=0.5.10",
+    "ty>=0.0.99",
     "git-cliff>=2.14.2",
+    "questionary>=2.1.1",
 ]
 
 [[project.authors]]
@@ -50,7 +51,7 @@ name = "Stephen Yau"
 email = "softwareentrepreneer+afterpython@gmail.com"
 
 [project.optional-dependencies]
-marimo = ["marimo[recommended,lsp]>=0.25.0"]
+marimo = ["marimo[recommended,lsp]>=0.25.2"]
 
 [project.urls]
 homepage = "https://afterpython.afterpython.org"
@@ -62,7 +63,7 @@ ap = "afterpython.main:run_cli"
 pcu = "afterpython.main:run_pcu"
 
 [build-system]
-requires = ["uv_build>=0.12.21,<0.13.0"]
+requires = ["uv_build>=0.13.7,<0.14.0"]
 build-backend = "uv_build"
 
 [tool.uv.build-backend]

{afterpython-0.4.0 → afterpython-0.4.1}/pyproject.toml.orig

@@ -1,6 +1,6 @@
 [project]
 name = "afterpython"
-version = "0.4.0"
+version = "0.4.1"
 description = "CLI tool to streamline Python package maintenance and generate a dedicated project website"
 license = "Apache-2.0"
 authors = [
@@ -25,32 +25,32 @@ classifiers = [
     "Topic :: Software Development :: Build Tools",
     "Topic :: Software Development :: Documentation",
     "Typing :: Typed",
-    "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
     "Programming Language :: Python :: 3.14",
-    # "Programming Language :: Python :: 3.15",
+    "Programming Language :: Python :: 3.15",
 ]
-requires-python = ">=3.12"
+requires-python = ">=3.13"
 dependencies = [
-    "click>=8.5.0",
+    "click>=8.5.1",
     "trogon>=0.6.0",
-    "httpx2>=2.13.1",
-    "tomlkit>=0.15.1",
+    "httpx2>=2.16.0",
+    "tomlkit>=0.15.2",
     "ruamel-yaml>=0.19.1",
-    "gitpython>=3.2.0",
-    "python-dotenv>=1.2.3",
+    "gitpython>=3.2.1",
+    "python-dotenv>=1.2.4",
     "pyproject-metadata>=0.12.1",
-    "jupytext>=1.19.5",
-    "mystmd>=1.11.0",
+    "jupytext>=1.19.6",
+    "mystmd>=1.12.0",
     "pdoc>=16.0.0",
-    "ruff>=0.16.9",
-    "prek>=0.5.4",
-    "ty>=0.0.84",
+    "ruff>=0.17.4",
+    "prek>=0.5.10",
+    "ty>=0.0.99",
     "git-cliff>=2.14.2",
+    "questionary>=2.1.1",
 ]
 
 [project.optional-dependencies]
-marimo = ["marimo[recommended,lsp]>=0.25.0"]
+marimo = ["marimo[recommended,lsp]>=0.25.2"]
 
 [project.urls]
 homepage = "https://afterpython.afterpython.org"
@@ -62,7 +62,7 @@ ap = "afterpython.main:run_cli"
 pcu = "afterpython.main:run_pcu"
 
 [build-system]
-requires = ["uv_build>=0.12.21,<0.13.0"]
+requires = ["uv_build>=0.13.7,<0.14.0"]
 build-backend = "uv_build"
 
 [tool.uv]

{afterpython-0.4.0 → afterpython-0.4.1}/src/afterpython/builders/__init__.py

@@ -1,4 +1,5 @@
 from afterpython.builders.build_pdoc import build_pdoc
+from afterpython.builders.comments_json import build_comments_json
 from afterpython.builders.content_json import build_content_json
 from afterpython.builders.faq_json import build_faq_json
 from afterpython.builders.index_md import (
@@ -13,6 +14,7 @@ from afterpython.builders.metadata import build_metadata
 from afterpython.builders.url_md import build_url_md
 
 __all__ = (
+    "build_comments_json",
     "build_content_json",
     "build_faq_json",
     "build_jupyter_notebooks",

{afterpython-0.4.0 → afterpython-0.4.1}/src/afterpython/builders/build_pdoc.py

@@ -19,9 +19,15 @@ def build_pdoc(base_path: str) -> None:
     project logo appears in the top-left of every API page and links
     back to the project website root (matches MyST's UX).
     """
+    from afterpython._io.toml import _from_tomlkit
+    from afterpython.tools._afterpython import read_afterpython
+
     package_dir = find_package_directory()
     output_dir = ap.paths.build_path / "api_reference"
     template_dir = ap.paths.templates_path / "pdoc"
+    # e.g. "google"; unset leaves it to pdoc (a module's __docformat__, else restructuredtext)
+    website = _from_tomlkit(read_afterpython().get("website", {}))
+    docformat = website.get("api_reference_docformat")
 
     click.echo("Building api_reference/...")
 
@@ -45,6 +51,7 @@ def build_pdoc(base_path: str) -> None:
             f"{base_path}/",
             "--template-directory",
             str(template_dir),
+            *(["--docformat", str(docformat)] if docformat else []),
             str(package_dir),
         ],
         env=env,

afterpython-0.4.1/src/afterpython/builders/comments_json.py

@@ -0,0 +1,107 @@
+from __future__ import annotations
+
+import json
+import re
+
+import click
+
+import afterpython as ap
+
+GISCUS_API = "https://giscus.app/api/discussions/categories"
+DEFAULT_CATEGORY = "Announcements"
+
+
+def _read_comments_config() -> dict:
+    from afterpython._io.toml import _from_tomlkit
+    from afterpython.tools._afterpython import read_afterpython
+
+    website = _from_tomlkit(read_afterpython().get("website", {}))
+    return dict(website.get("comments", {}))
+
+
+def _get_github_repo() -> str | None:
+    """Return "owner/repo" from pyproject.toml's repository URL, or the git remote."""
+    from afterpython.tools._git import get_github_url
+    from afterpython.tools.pyproject import read_metadata
+
+    url = str(read_metadata().urls.get("repository", "")) or get_github_url() or ""
+    match = re.search(r"github\.com[/:]([^/]+)/([^/]+?)(?:\.git)?/?$", url)
+    return f"{match[1]}/{match[2]}" if match else None
+
+
+def _fetch_giscus_categories(repo: str) -> dict:
+    """Fetch the repo and category IDs giscus needs. Raises click.ClickException on failure."""
+    import httpx2
+
+    try:
+        response = httpx2.get(GISCUS_API, params={"repo": repo}, timeout=10.0)
+    except httpx2.HTTPError as e:
+        raise click.ClickException(f"could not reach giscus.app ({e})") from e
+    try:
+        data = response.json()
+    except ValueError:
+        data = {}
+    if response.status_code != 200 or "repositoryId" not in data:
+        error = data.get("error") or f"HTTP {response.status_code}"
+        raise click.ClickException(error)
+    return data
+
+
+def build_comments_json():
+    """Build comments.json for the giscus comment section on content pages.
+
+    Reads [website.comments] in afterpython.toml. The website template only
+    shows comments when comments.json exists, so a disabled or failed setup
+    just leaves it out. Never fails the build.
+    """
+    stale = ap.paths.website_path / "static" / "comments.json"
+    stale.unlink(missing_ok=True)
+
+    config = _read_comments_config()
+    if not config.get("enabled", False):
+        click.echo("Comments are disabled, skip building comments.json")
+        return
+
+    def warn(reason: str):
+        click.secho(f"Warning: skip comments, {reason}", fg="yellow")
+
+    repo = _get_github_repo()
+    if not repo:
+        warn(
+            "no GitHub repository found "
+            "(set [project.urls] repository in pyproject.toml)"
+        )
+        return
+
+    category = str(config.get("category") or DEFAULT_CATEGORY)
+    try:
+        data = _fetch_giscus_categories(repo)
+    except click.ClickException as e:
+        warn(
+            f"giscus is not ready for {repo}: {e.message}\n"
+            f"  1. Enable Discussions: https://github.com/{repo}/settings\n"
+            "  2. Install the giscus app: https://github.com/apps/giscus\n"
+            "  Or set [website.comments] enabled = false in afterpython.toml"
+        )
+        return
+
+    category_id = next(
+        (c["id"] for c in data.get("categories", []) if c["name"] == category), None
+    )
+    if not category_id:
+        names = ", ".join(c["name"] for c in data.get("categories", []))
+        warn(
+            f'Discussions category "{category}" not found in {repo} '
+            f"(available: {names or 'none'})"
+        )
+        return
+
+    click.echo(f"Building comments.json ({repo}, {category})...")
+    comments = {
+        "repo": repo,
+        "repoId": data["repositoryId"],
+        "category": category,
+        "categoryId": category_id,
+    }
+    with open(ap.paths.build_path / "comments.json", "w") as f:
+        json.dump(comments, f, indent=2)

{afterpython-0.4.0 → afterpython-0.4.1}/src/afterpython/cli/commands/build.py

@@ -17,6 +17,7 @@ from click.exceptions import Exit
 
 import afterpython as ap
 from afterpython.builders import (
+    build_comments_json,
     build_content_json,
     build_faq_json,
     build_jupyter_notebooks,
@@ -137,6 +138,7 @@ def prebuild():
     create_placeholder_index_md_files()
     build_metadata()
     build_faq_json()
+    build_comments_json()
     build_marimo_readme(mode=_get_readme_py_mode())
     build_markdown()
     build_jupyter_notebooks()

{afterpython-0.4.0 → afterpython-0.4.1}/src/afterpython/cli/commands/init.py

@@ -169,14 +169,62 @@ def init_py_typed():
     click.echo(f"Created {py_typed_path}")
 
 
-def _preflight_init(skip_website: bool) -> None:
+def _preflight_init(website: bool) -> None:
     """Validate external prerequisites before any filesystem writes, so a
     failure aborts cleanly instead of leaving a half-initialized project."""
-    if not skip_website:
-        from afterpython.tools.myst import ensure_pnpm_11
+    if website:
+        from afterpython.tools.myst import ensure_pnpm_12
         from afterpython.utils import find_node_env
 
-        ensure_pnpm_11(find_node_env())
+        ensure_pnpm_12(find_node_env())
+
+
+def _select_steps(yes: bool, skip_website: bool, ask_commit_types: bool) -> set[str]:
+    """Ask which optional setup steps to run, as one checkbox list (all checked by default).
+
+    Without a terminal (CI, piped input) or with --yes, nothing is asked and the defaults are used.
+    """
+    import sys
+
+    import questionary
+
+    # (step, label, checked by default)
+    options = [
+        (
+            "website",
+            "Project website (MyST, template, deploy workflow)",
+            not skip_website,
+        )
+    ]
+    # only relevant when afterpython.toml is created, it's ignored otherwise
+    if ask_commit_types:
+        options.append(
+            (
+                "commit_types",
+                "Commit message check (conventional commit types, e.g. 'feat: add X')",
+                True,
+            )
+        )
+    options += [
+        ("prek", "Pre-commit hooks (prek)", True),
+        ("ruff", "ruff: lint & format", True),
+        ("ty", "ty: type checking (`ap check`)", True),
+        ("cliff", "git-cliff: changelog", True),
+        ("release", "Release workflow (.github/workflows/release.yml)", True),
+        ("dependabot", "Dependabot (auto-update GitHub Actions versions)", True),
+    ]
+
+    if yes or not (sys.stdin.isatty() and sys.stdout.isatty()):
+        return {step for step, _, checked in options if checked}
+
+    choices = [
+        questionary.Choice(label, value=step, checked=checked)
+        for step, label, checked in options
+    ]
+    selected = questionary.checkbox("Select what to set up", choices=choices).ask()
+    if selected is None:  # Ctrl-C, before anything was written
+        raise click.Abort()
+    return set(selected)
 
 
 @click.group(invoke_without_command=True)
@@ -184,7 +232,7 @@ def _preflight_init(skip_website: bool) -> None:
     "--yes",
     "-y",
     is_flag=True,
-    help="Automatically answer yes to all prompts",
+    help="Set up everything without asking",
 )
 @click.option(
     "--skip-website",
@@ -205,32 +253,27 @@ def init(ctx, yes, skip_website: bool):
     from afterpython.tools.prek import init_prek, sync_hooks
     from afterpython.tools.pyproject import init_pyproject
 
-    _preflight_init(skip_website)
-
     paths = ctx.obj["paths"]
-    click.echo("Initializing afterpython...")
     afterpython_path = paths.afterpython_path
     static_path = paths.static_path
 
+    steps = _select_steps(
+        yes,
+        skip_website,
+        ask_commit_types=not (afterpython_path / "afterpython.toml").exists(),
+    )
+    _preflight_init(website="website" in steps)
+
+    click.echo("Initializing afterpython...")
     try:
         afterpython_path.mkdir(parents=True, exist_ok=True)
         static_path.mkdir(parents=True, exist_ok=True)
 
         init_pyproject()
 
-        # only asked when afterpython.toml is created, it's ignored otherwise
-        commit_types = (
-            yes
-            or (afterpython_path / "afterpython.toml").exists()
-            or click.confirm(
-                "\nCheck commit messages against conventional commit types "
-                "(e.g. 'feat: add X', types listed in afterpython.toml)?",
-                default=True,
-            )
-        )
-        init_afterpython(commit_types=commit_types)
+        init_afterpython(commit_types="commit_types" in steps)
 
-        if not skip_website:
+        if "website" in steps:
             # check=True so a failure inside `ap init website` aborts the parent
             # run instead of silently continuing to write more files.
             subprocess.run(["ap", "init", "website"], check=True)
@@ -239,42 +282,20 @@ def init(ctx, yes, skip_website: bool):
 
         create_workflow("ci")
 
-        if yes or click.confirm(
-            f"\nCreate .pre-commit-config.yaml in {afterpython_path}?", default=True
-        ):
+        if "prek" in steps:
             init_prek()
-
-        if yes or click.confirm(
-            f"\nCreate ruff.toml in {afterpython_path} (and point pyproject.toml's [tool.ruff] to it)?",
-            default=True,
-        ):
+        if "ruff" in steps:
             init_ruff()
-
-        if yes or click.confirm(
-            f"\nCreate ty.toml in {afterpython_path} (type checking with `ap check`)?",
-            default=True,
-        ):
+        if "ty" in steps:
             init_ty()
-        # whatever the answers: keep ruff/ty hooks only for the tools that were set up
+        # whatever was selected: keep ruff/ty hooks only for the tools that were set up
         sync_hooks()
 
-        if yes or click.confirm(
-            f"\nCreate cliff.toml in {afterpython_path} (changelog generation with git-cliff)?",
-            default=True,
-        ):
+        if "cliff" in steps:
             init_cliff()
-
-        if yes or click.confirm(
-            "\nCreate release workflow in .github/workflows/release.yml?",
-            default=True,
-        ):
+        if "release" in steps:
             create_workflow("release")
-
-        if yes or click.confirm(
-            "\nCreate Dependabot configuration (.github/dependabot.yml) "
-            "to auto-update GitHub Actions versions?",
-            default=True,
-        ):
+        if "dependabot" in steps:
             create_dependabot()
     except BaseException:
         if afterpython_path.exists():
@@ -327,12 +348,12 @@ def init_website_subcommand():
     the website to an existing AfterPython project.
     """
     from afterpython.tools.github_actions import create_workflow
-    from afterpython.tools.myst import ensure_pnpm_11, init_myst
+    from afterpython.tools.myst import ensure_pnpm_12, init_myst
     from afterpython.utils import find_node_env
 
     # Pre-flight: same rationale as `ap init` — guard the standalone entry too,
     # since this subcommand can be invoked directly via `ap init website`.
-    ensure_pnpm_11(find_node_env())
+    ensure_pnpm_12(find_node_env())
 
     init_faq()
     init_myst()
@@ -342,3 +363,44 @@ def init_website_subcommand():
     # of a broken website install.
     subprocess.run(["ap", "update", "website"], check=True)
     create_workflow("deploy")
+
+
+@init.command("content")
+@click.option("--all", is_flag=True, help="Initialize all content types")
+@click.option("--doc", is_flag=True, help="Initialize afterpython/doc/")
+@click.option("--blog", is_flag=True, help="Initialize afterpython/blog/")
+@click.option("--tutorial", is_flag=True, help="Initialize afterpython/tutorial/")
+@click.option("--example", is_flag=True, help="Initialize afterpython/example/")
+@click.option("--guide", is_flag=True, help="Initialize afterpython/guide/")
+def init_content_subcommand(
+    all: bool, doc: bool, blog: bool, tutorial: bool, example: bool, guide: bool
+):
+    """Initialize content directories (MyST config) without touching the website
+
+    Content types that already have a myst.yml are skipped.
+
+    Examples:
+      ap init content --blog             # afterpython/blog/
+      ap init content --blog --tutorial  # afterpython/blog/ and afterpython/tutorial/
+      ap init content --all              # every content type that is missing
+    """
+    from afterpython._typing import tContentType
+    from afterpython.const import CONTENT_TYPES
+    from afterpython.tools.myst import init_myst
+
+    flags: dict[tContentType, bool] = {
+        "doc": doc,
+        "blog": blog,
+        "tutorial": tutorial,
+        "example": example,
+        "guide": guide,
+    }
+    if all:
+        content_types = CONTENT_TYPES
+    else:
+        content_types = {content_type for content_type, flag in flags.items() if flag}
+    if not content_types:
+        raise click.UsageError(
+            "Specify one or more of --doc/--blog/--tutorial/--example/--guide, or --all"
+        )
+    init_myst(content_types)

{afterpython-0.4.0 → afterpython-0.4.1}/src/afterpython/const.py

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

{afterpython-0.4.0 → afterpython-0.4.1}/src/afterpython/templates/afterpython-template.toml

@@ -13,6 +13,12 @@ announcement = ""
 readme_py = "wasm"  # marimo html export format: "wasm" or "static"
 execute_readme_py = false  # execute README.py cells at build time and embed outputs as a preview (wasm mode only)
 api_reference = false  # set to true to enable the pdoc-generated API reference
+# api_reference_docformat = "google"  # docstring format for pdoc: "google", "numpy", "restructuredtext" or "markdown"
+
+[website.comments]  # giscus comment section on blog posts, tutorials, examples and guides
+enabled = true
+# Discussions category for comments. Announcement format means only maintainers can start discussions there; visitors can only reply.
+category = "Announcements"
 
 # [website.blog]
 # thumbnail = "blog_default_thumbnail.png"  # inside blog/static/ folder, default thumbnail for blog posts