afterpython 0.3.14__tar.gz → 0.3.16__tar.gz

{afterpython-0.3.14 → afterpython-0.3.16}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: afterpython
-Version: 0.3.14
+Version: 0.3.16
 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

{afterpython-0.3.14 → afterpython-0.3.16}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "afterpython"
-version = "0.3.14"
+version = "0.3.16"
 description = "CLI tool to streamline Python package maintenance and generate a dedicated project website"
 license = "Apache-2.0"
 authors = [

{afterpython-0.3.14 → afterpython-0.3.16}/src/afterpython/builders/jupyter_notebook.py

@@ -222,7 +222,7 @@ def build_jupyter_notebooks():
     from afterpython.tools._afterpython import get_default_thumbnail
 
     # Check if molab badge feature is enabled
-    add_molab_badge = os.getenv("AP_MOLAB_BADGE", "1") == "1"
+    add_molab_badge = os.getenv("AP_MOLAB_BADGE", "0") == "1"
 
     # Get GitHub URL once if needed for molab badges
     github_url = None

{afterpython-0.3.14 → afterpython-0.3.16}/src/afterpython/builders/marimo_notebook.py

@@ -130,7 +130,7 @@ def build_marimo_notebook(
     if mode == "wasm":
         return
 
-    add_molab_badge = os.getenv("AP_MOLAB_BADGE", "1") == "1"
+    add_molab_badge = os.getenv("AP_MOLAB_BADGE", "0") == "1"
     if not add_molab_badge:
         return
 

{afterpython-0.3.14 → afterpython-0.3.16}/src/afterpython/builders/url_md.py

@@ -74,7 +74,12 @@ def _publish_for_type(content_type: tContentType) -> int:
 
     count = 0
     for source in sorted(source_dir.rglob("*")):
-        if "_build" in source.parts:
+        # Skip MyST build output and any hidden tool directory. The latter is
+        # essential: jupyterlab-lsp writes `.virtual_documents/*.ipynb` and
+        # jupyter writes `.ipynb_checkpoints/*.ipynb` — these carry an `.ipynb`
+        # extension but are NOT notebooks (the virtual-documents ones are raw
+        # Python source), so jupytext.read() chokes on them.
+        if "_build" in source.parts or any(p.startswith(".") for p in source.parts):
             continue
         if not source.is_file():
             continue

{afterpython-0.3.14 → afterpython-0.3.16}/src/afterpython/cli/commands/sync.py

@@ -6,7 +6,11 @@ from pyproject_metadata import StandardMetadata
 from tomlkit.toml_document import TOMLDocument
 
 import afterpython as ap
-from afterpython.utils import convert_author_name_to_id, normalize_static_path
+from afterpython.utils import (
+    build_author_name,
+    convert_author_name_to_id,
+    normalize_static_path,
+)
 
 
 def _myst_favicon_path(path: str) -> str:
@@ -23,20 +27,21 @@ def _sync_authors_yml(authors: list[tuple[str, str | None]]):
 
     # read myst.yml from docs path to get "version"
     doc_myst_yml = read_yaml(ap.paths.afterpython_path / "doc" / "myst.yml")
+    entries = []
+    for author in authors:
+        # author is a tuple of (name, email)
+        name = str(author[0]).strip()
+        entries.append(
+            {
+                "id": convert_author_name_to_id(name),
+                "name": build_author_name(name),
+                "email": str(author[1]),
+                # "github": ...
+            }
+        )
     data = {
         "version": doc_myst_yml["version"],
-        "project": {
-            "contributors": [
-                # NOTE: author is a tuple of (name, email), so author[0] is the name and author[1] is the email
-                {
-                    "id": convert_author_name_to_id(str(author[0])),
-                    "name": str(author[0]),
-                    "email": str(author[1]),
-                    # "github": ...
-                }
-                for author in authors
-            ]
-        },
+        "project": {"authors": entries},
     }
     update_authors_yml(data)
     click.echo("✓ Synced authors.yml with pyproject.toml")
@@ -114,7 +119,8 @@ def sync():
         # nav_bar_per_content_type = [
         #     item for item in nav_bar if item["title"] != content_type.capitalize() + "s"
         # ]
-        title = project_name + f"'s {content_type.capitalize()}"
+        project_title = content_type.capitalize()
+        site_title = project_name + f"'s {content_type.capitalize()}"
         data = {
             "project": {
                 # using author ids defined in authors.yml
@@ -127,7 +133,7 @@ def sync():
                     "url": company_url,
                 },
                 "copyright": f"© {company_name or project_name} {datetime.now().year}. All rights reserved.",
-                "title": "",
+                "title": project_title,
                 "description": str(pyproject.description),
                 "keywords": list(map(str, pyproject.keywords)),
                 "github": github_url,
@@ -136,7 +142,7 @@ def sync():
                 else "",
             },
             "site": {
-                "title": title,
+                "title": site_title,
                 "options": {
                     "favicon": "../static" + myst_favicon if myst_favicon else "",
                     "logo": "../static" + website_logo if website_logo else "",

{afterpython-0.3.14 → afterpython-0.3.16}/src/afterpython/tools/myst.py

@@ -30,8 +30,7 @@ def update_authors_yml(data_update: dict):
     # merge authors, keep the author with more fields (e.g. github, x, etc.) to avoid duplication
     merged_authors = {}
     for author in (
-        existing_data["project"]["contributors"]
-        + data_update["project"]["contributors"]
+        existing_data["project"].get("authors", []) + data_update["project"]["authors"]
     ):
         author_id = author["id"]
         if author_id not in merged_authors:
@@ -40,14 +39,14 @@ def update_authors_yml(data_update: dict):
             # keep the author with more fields (e.g. github, x, etc.)
             if len(author.keys()) > len(merged_authors[author_id].keys()):
                 merged_authors[author_id] = author
-    existing_data["project"]["contributors"] = list(merged_authors.values())
+    existing_data["project"]["authors"] = list(merged_authors.values())
 
     # set comments for project section for convenience
     if "project" in existing_data and not existing_data["project"].ca.items.get(
-        "contributors"
+        "authors"
     ):
         existing_data["project"].yaml_set_comment_before_after_key(
-            "contributors",
+            "authors",
             before="See more at: https://mystmd.org/guide/frontmatter#frontmatter-authors",
         )
     write_yaml(file_path, existing_data)

{afterpython-0.3.14 → afterpython-0.3.16}/src/afterpython/utils.py

@@ -149,6 +149,25 @@ def convert_author_name_to_id(name: str) -> str:
     return name.replace(" ", "_").lower()
 
 
+def build_author_name(name: str) -> dict:
+    """Build a MyST name object from a display name.
+
+    A multi-word name ("Stephen Yau") is split into ``given``/``surname`` so MyST
+    can render and cite it properly. A single-token name (e.g. a username like
+    "softwareentrepreneer") uses ``literal`` so MyST treats it as the full name
+    verbatim instead of warning about a missing given name.
+
+    Examples:
+        - "Stephen Yau" -> {"given": "Stephen", "surname": "Yau"}
+        - "softwareentrepreneer" -> {"literal": "softwareentrepreneer"}
+    """
+    name = name.strip()
+    if " " in name:
+        given, surname = name.split(" ", 1)
+        return {"given": given, "surname": surname}
+    return {"literal": name}
+
+
 def find_available_port(
     start_port: int = 3000, max_port: int = 3100, host: str = "localhost"
 ) -> int:
@@ -188,9 +207,7 @@ def find_available_port(
 def has_content_for_myst(content_path: Path) -> bool:
     """Check if a content directory has any content files"""
     return any(
-        content_path.glob("*.md")
-        or content_path.glob("*.ipynb")
-        or content_path.glob("*.tex")
+        any(content_path.glob(pattern)) for pattern in ("*.md", "*.ipynb", "*.tex")
     )