afterpython 0.1.4__py3-none-any.whl → 0.2.1__py3-none-any.whl

afterpython/cli/commands/build.py

@@ -190,6 +190,7 @@ def build(ctx: click.Context, execute: bool):
         find_node_env,
         handle_passthrough_help,
         has_content_for_myst,
+        is_website_initialized,
     )
 
     # Show both our options and myst's help and exit
@@ -199,6 +200,13 @@ def build(ctx: click.Context, execute: bool):
         show_underlying=True,
     )
 
+    if not is_website_initialized():
+        click.echo(
+            "Website has not been initialized. Skipping website build.\n"
+            "Run 'ap update website' to initialize the website."
+        )
+        return
+
     paths = ctx.obj["paths"]
     prebuild()
 

afterpython/cli/commands/dev.py

@@ -94,7 +94,7 @@ def dev(
     with custom Vite options in the afterpython/_website directory.
     """
 
-    from afterpython.utils import handle_passthrough_help
+    from afterpython.utils import handle_passthrough_help, is_website_initialized
 
     # Show both our options and myst's help and exit
     handle_passthrough_help(
@@ -103,6 +103,13 @@ def dev(
         show_underlying=True,
     )
 
+    if not is_website_initialized():
+        click.echo(
+            "Website has not been initialized. Skipping dev server.\n"
+            "Run 'ap update website' to initialize the website."
+        )
+        return
+
     # Track all MyST processes for cleanup
     myst_processes = []
 

afterpython/cli/commands/init.py

@@ -46,8 +46,13 @@ def init_py_typed():
     is_flag=True,
     help="Automatically answer yes to all prompts",
 )
+@click.option(
+    "--skip-website",
+    is_flag=True,
+    help="Skip website template initialization",
+)
 @click.pass_context
-def init(ctx, yes):
+def init(ctx, yes, skip_website: bool):
     """Initialize AfterPython project structure and website template"""
     from afterpython.tools._afterpython import init_afterpython
     from afterpython.tools.commitizen import init_commitizen
@@ -73,9 +78,9 @@ def init(ctx, yes):
 
     init_myst()
 
-    # TODO: init faq.yml
-
-    init_website()
+    if not skip_website:
+        # TODO: init faq.yml
+        init_website()
 
     # TODO: add type checking related stuff here
     init_py_typed()

afterpython/cli/commands/preview.py

@@ -8,7 +8,14 @@ from click.exceptions import Exit
 @click.pass_context
 def preview(ctx):
     """Preview the production build of the project website"""
-    from afterpython.utils import find_node_env
+    from afterpython.utils import find_node_env, is_website_initialized
+
+    if not is_website_initialized():
+        click.echo(
+            "Website has not been initialized. Skipping preview.\n"
+            "Run 'ap update website' to initialize the website."
+        )
+        return
 
     paths = ctx.obj["paths"]
     node_env = find_node_env()

afterpython/cli/commands/update.py

@@ -126,7 +126,7 @@ update.add_command(dependencies, name="deps")  # alias for "dependencies"
 )
 def website(ctx, no_backup: bool):
     """Update project website template to the latest version"""
-    from afterpython.utils import find_node_env
+    from afterpython.utils import ensure_website_gitignore_rules, find_node_env
 
     website_template_repo = "AfterPythonOrg/project-website-template"
 
@@ -166,6 +166,9 @@ def website(ctx, no_backup: bool):
         )
         if result.returncode != 0:
             raise Exit(result.returncode)
+
+        # Ensure gitignore rules are present
+        ensure_website_gitignore_rules()
     except Exception as e:
         click.echo(f"✗ Error updating project website template: {e}", err=True)
         if not no_backup:

afterpython/templates/ci-workflow-template.yml

@@ -33,7 +33,7 @@ jobs:
       - name: Install dependencies
         # Install the package with uv in system mode
         # This installs ruff and other tools defined in dependencies
-        run: uv pip install --system .
+        run: uv pip install --system . --group dev
 
       - name: Run ruff check
         run: ruff check --config ./afterpython/ruff.toml .
@@ -189,9 +189,18 @@ jobs:
         run: uv pip install --system dist/*.whl
 
       - name: Verify installation
-        # Confirm the CLI entry point works
-        # This ensures the package is usable after installation
-        run: ap --help
+        # Generic verification: assume project.name maps to import name
+        # by replacing '-' with '_'. If a project breaks this rule, CI fails.
+        run: |
+          PROJECT_NAME="$(python - <<'PY'
+          import tomllib
+          with open("pyproject.toml", "rb") as f:
+              data = tomllib.load(f)
+          print(data["project"]["name"])
+          PY
+          )"
+          IMPORT_NAME="${PROJECT_NAME//-/_}"
+          python -c "import ${IMPORT_NAME}"
 
   # Job 5: Type Check
   # typecheck:

afterpython/utils.py

@@ -297,3 +297,69 @@ def get_relative_static_prefix(file_path: Path, content_type_path: Path) -> str:
         return "./"  # File is directly in content_type_path
     else:
         return "../" * depth
+
+
+def is_website_initialized() -> bool:
+    """Check if the website has been initialized.
+
+    Returns:
+        True if the website is initialized (afterpython/_website exists and has package.json)
+        False otherwise
+    """
+    import afterpython as ap
+
+    website_path = ap.paths.website_path
+    package_json = website_path / "package.json"
+
+    return website_path.exists() and package_json.exists()
+
+
+def ensure_website_gitignore_rules() -> None:
+    """Ensure website-related gitignore rules are present in the project's .gitignore.
+
+    Adds the following rules if they don't exist:
+    - **/_build/ (ignore all build directories)
+    - !afterpython/_website/src/lib/ (un-ignore website source for customization)
+    - afterpython/_website.backup/ (ignore backup created by ap update website)
+    """
+    import afterpython as ap
+
+    gitignore_path = ap.paths.user_path / ".gitignore"
+
+    # Rules that should be present
+    required_rules = [
+        "**/_build/",
+        "!afterpython/_website/src/lib/",
+        "afterpython/_website.backup/",
+    ]
+
+    # Read existing gitignore or create empty list
+    if gitignore_path.exists():
+        existing_lines = gitignore_path.read_text().splitlines()
+    else:
+        existing_lines = []
+
+    # Find which rules are missing
+    missing_rules = []
+    for rule in required_rules:
+        # Check if rule exists (exact match or as part of a line)
+        if not any(rule in line for line in existing_lines):
+            missing_rules.append(rule)
+
+    # Add missing rules if any
+    if missing_rules:
+        # Ensure file ends with newline if it exists and has content
+        content = gitignore_path.read_text() if gitignore_path.exists() else ""
+        if content and not content.endswith("\n"):
+            content += "\n"
+
+        # Add a section header if we're adding rules
+        if content:
+            content += "\n"
+        content += "# AfterPython website rules\n"
+        content += "\n".join(missing_rules) + "\n"
+
+        gitignore_path.write_text(content)
+        click.echo(f"Added website-related rules to {gitignore_path}")
+    else:
+        click.echo("Website gitignore rules already present")

{afterpython-0.1.4.dist-info → afterpython-0.2.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: afterpython
-Version: 0.1.4
+Version: 0.2.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

{afterpython-0.1.4.dist-info → afterpython-0.2.1.dist-info}/RECORD

@@ -11,30 +11,31 @@ afterpython/builders/markdown.py,sha256=0ExfRqvOTWsgUkAVaGGNkiNDtNedRr7JR1yTGxpb
 afterpython/builders/metadata.py,sha256=--0zWaI0ZI1wKeezcyqSUy-h1IuLqnI33ateoAHIaBU,1337
 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=Vvyd7AkL2Tw3vEDhi4bEOWD9hdtxon7SgAzXUeh5D8w,9050
+afterpython/cli/commands/build.py,sha256=HR2x7tn12qbsrSk--0Mzbnl4UbNU_RhexG_6I2mxF04,9304
 afterpython/cli/commands/bump.py,sha256=2MZBQ1kxjr0bWhA--_xHwdwjsUlCyrXPn3pJ5NDZO4k,4088
 afterpython/cli/commands/check.py,sha256=lrPaVThAwxxnczu-VOZT7dd7aKjstnMQfX9UpZY3Lxs,1058
 afterpython/cli/commands/clean.py,sha256=havP43ZC1AKFzvscsRMF_to6TvOwruxGA5qzr6dMHvg,2529
 afterpython/cli/commands/commit.py,sha256=9QOKyt4tfTJzZEdHEPAdpUc4stYMSvG3-31uADuBxn4,1420
 afterpython/cli/commands/commitizen.py,sha256=H3jewz4VkZi5FYTWw3USVM3XosRx12kPShOQGxD3LNM,842
-afterpython/cli/commands/dev.py,sha256=YIJECfroGRQnuMWWRC4W_DMA0eJoQssufj8WBDjQVOM,6796
+afterpython/cli/commands/dev.py,sha256=LVv6WUB1RNe8w7yAQS_1TQEEn_wklbJOuduapYlg2FA,7039
 afterpython/cli/commands/format.py,sha256=VFwCG9KDTF6j4Y_Ewp4_RpS8uNBQNOAj9HU_G97my5A,710
-afterpython/cli/commands/init.py,sha256=UiE8QIhDV9NqoqU2EU_FMAlJ2Y18lFF0x2JmcyiAQxc,3044
+afterpython/cli/commands/init.py,sha256=G2zL3W1ZxbppMQEYCD7zttNIcrhAG8K2M1gZpcL4Ebo,3202
 afterpython/cli/commands/init_branch_rules.py,sha256=fzAm8D5qbW3u4bEMpqPuRgO-0akuCGG7pu09JlKhYn4,243
 afterpython/cli/commands/install.py,sha256=B8JuQmtU_4EZpHct2J5j30BGLkGmvwKvU26upbmabvQ,750
 afterpython/cli/commands/lock.py,sha256=Kppu_0tnqdbP6Gbulxf123f-cFzTGIw39si2O7rDo3Q,603
 afterpython/cli/commands/pre_commit.py,sha256=QIuzTZEfw4uPMqmQT8YmyD0yewBcwjLvcnbVjRbonQE,1978
-afterpython/cli/commands/preview.py,sha256=sBwe46H0V-U7I4d0-u-nXmPBWGmkjKhkUTbqV927zRM,593
+afterpython/cli/commands/preview.py,sha256=V3gzAYcWi95A9GUwqcQudgtSMFcKHVJPz3l4grg5vYg,833
 afterpython/cli/commands/release.py,sha256=6SDEnPtuCL0_XUqWUlvRSKxAv011QqOD0kc5pKu7378,2479
 afterpython/cli/commands/remove.py,sha256=Fl79JSI9IdHyzYflocXxcxgBkBPkNFAW98Yuijly26g,1812
 afterpython/cli/commands/start.py,sha256=q4rUkIllOO8wJQ9ABtsx-dqkW1yC0vltAtSkiHN_GH4,4002
 afterpython/cli/commands/sync.py,sha256=u9L3aq04M5VHh0FByDSpmBD7F1RYCNsIgvZFifnRZ6A,6042
-afterpython/cli/commands/update.py,sha256=4h_zKp72e4RmXUKHyeP6kfHqr4V3IugSOnxa-E1F55I,6312
+afterpython/cli/commands/update.py,sha256=YhCOBTGoKkYMnUK4qg-DX-FOmq1hPNSD53_IllpnUrU,6431
 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=8JzGBSDKwiNgk1ygEWQzc5AoLGv2RpX6G6VuZcWFZH4,5933
+afterpython/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+afterpython/templates/ci-workflow-template.yml,sha256=4wnH1_a7puUV1loqMZhTT5xlKeGJ5aeercu0_vtnbDU,6289
 afterpython/templates/cz-template.toml,sha256=2qwbQLb0nbZaA63oWXFFzvzPNBsFZHATL1C2rdNdjjs,185
 afterpython/templates/dependabot-template.yml,sha256=CBQEgh8EsXw2X7IqzGtFI7lVT9liF6PW4DvGLB0X2LY,1136
 afterpython/templates/deploy-workflow-template.yml,sha256=2W4K3lKMYjSTPrlXIsMweBzqP9IoLtZXAAcUu5FA5NA,2365
@@ -49,9 +50,9 @@ afterpython/tools/github_actions.py,sha256=zVmg9aqUg-EO0CnbRHl9i8TmFtXpt7nd0Vjzc
 afterpython/tools/myst.py,sha256=2VO-gD25PbGSD8-v1sLI1v3Q9loahRd3ednKrW4_Utc,8113
 afterpython/tools/pre_commit.py,sha256=oNsrUkPI13rSSBSyhyTTKPnQGhDxLIPYhxu6kL0fDmo,1206
 afterpython/tools/pyproject.py,sha256=kb7BDn24yH_xS2F5_L0dK-GL4KgOJS-MIIUQhHnLorI,3507
-afterpython/utils.py,sha256=s1FIJP6FvpAcK8SujB8glFbiKx-ZCltywh5ihaOhL0U,9516
+afterpython/utils.py,sha256=fVa3jIzCvhn7QA7N0M6d_pvojpPFrN-hae8trUYhPKU,11701
 afterpython/version.py,sha256=hihRV1S-gc1m46OaXD32ikkEkqzs-Gtq7AcAqOQV-wY,1603
-afterpython-0.1.4.dist-info/WHEEL,sha256=XV0cjMrO7zXhVAIyyc8aFf1VjZ33Fen4IiJk5zFlC3g,80
-afterpython-0.1.4.dist-info/entry_points.txt,sha256=roa0PDgBueM1JPbRG0G2OSxzaN394OUL_oS9iEwVLBc,80
-afterpython-0.1.4.dist-info/METADATA,sha256=5gwp33Ye7IdvmcAtZeW6Ea2unLpHcZqH-gz9Sh_zaeM,5780
-afterpython-0.1.4.dist-info/RECORD,,
+afterpython-0.2.1.dist-info/WHEEL,sha256=iHtWm8nRfs0VRdCYVXocAWFW8ppjHL-uTJkAdZJKOBM,80
+afterpython-0.2.1.dist-info/entry_points.txt,sha256=roa0PDgBueM1JPbRG0G2OSxzaN394OUL_oS9iEwVLBc,80
+afterpython-0.2.1.dist-info/METADATA,sha256=bYFDNElkzZ6Y4CHQCUJVCxF3CPzm885yD2tgkQoStyU,5780
+afterpython-0.2.1.dist-info/RECORD,,

{afterpython-0.1.4.dist-info → afterpython-0.2.1.dist-info}/WHEEL

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