afterpython 0.1.4__tar.gz → 0.2.0__tar.gz

{afterpython-0.1.4 → afterpython-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: afterpython
-Version: 0.1.4
+Version: 0.2.0
 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 → afterpython-0.2.0}/pyproject.toml

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

{afterpython-0.1.4 → afterpython-0.2.0}/src/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-0.1.4 → afterpython-0.2.0}/src/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-0.1.4 → afterpython-0.2.0}/src/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-0.1.4 → afterpython-0.2.0}/src/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-0.1.4 → afterpython-0.2.0}/src/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-0.1.4 → afterpython-0.2.0}/src/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")