afterpython 0.1.0__py3-none-any.whl → 0.1.0.dev4__py3-none-any.whl

afterpython/builders/markdown.py

@@ -1,271 +0,0 @@
-from pathlib import Path
-
-import click
-
-import afterpython as ap
-from afterpython.const import CONTENT_TYPES
-
-
-def _read_markdown(markdown_path: Path, content_path: Path) -> str | None:
-    """Read and validate a markdown file.
-
-    Args:
-        markdown_path: Absolute path to the markdown file
-        content_path: Path relative to afterpython/ for logging
-
-    Returns:
-        Markdown content as a string if valid, None if invalid or error occurred
-    """
-    try:
-        with open(markdown_path, encoding="utf-8") as f:
-            content = f.read()
-        return content
-    except FileNotFoundError:
-        click.echo(f"✗ Skipping {content_path} - file not found")
-        return None
-    except Exception as e:
-        click.echo(f"✗ Error reading {content_path}: {e}")
-        return None
-
-
-def _write_markdown(content: str, markdown_path: Path):
-    """Write markdown content to file.
-
-    Args:
-        content: The markdown content to write
-        markdown_path: Absolute path to the markdown file
-    """
-    with open(markdown_path, "w", encoding="utf-8") as f:
-        f.write(content)
-
-
-def _has_frontmatter(content: str) -> bool:
-    """Check if markdown content has frontmatter.
-
-    Args:
-        content: The markdown file content as a string
-
-    Returns:
-        True if the content starts with ---, False otherwise
-    """
-    return content.strip().startswith("---")
-
-
-def _read_frontmatter(content: str) -> str | None:
-    """Read frontmatter content from markdown.
-
-    Args:
-        content: The markdown file content as a string
-
-    Returns:
-        Frontmatter content as a string (including --- delimiters) if it exists, None otherwise
-    """
-    if not _has_frontmatter(content):
-        return None
-
-    lines = content.split("\n")
-
-    # Find the closing --- of frontmatter
-    closing_index = -1
-    for i in range(1, len(lines)):
-        if lines[i].strip() == "---":
-            closing_index = i
-            break
-
-    if closing_index == -1:
-        return None
-
-    # Return frontmatter including both --- delimiters
-    return "\n".join(lines[: closing_index + 1])
-
-
-def _write_frontmatter(content: str, frontmatter: str) -> str:
-    """Write frontmatter content to markdown.
-
-    Low-level function that handles frontmatter replacement.
-    If frontmatter exists in content, replaces it. If not, prepends it.
-
-    Args:
-        content: The markdown file content as a string
-        frontmatter: The complete frontmatter content as a string (should include --- delimiters)
-
-    Returns:
-        The updated markdown content with the new frontmatter
-    """
-    if _has_frontmatter(content):
-        # Replace existing frontmatter
-        lines = content.split("\n")
-
-        # Find the closing --- of existing frontmatter
-        closing_index = -1
-        for i in range(1, len(lines)):
-            if lines[i].strip() == "---":
-                closing_index = i
-                break
-
-        if closing_index > -1:
-            # Remove old frontmatter and prepend new one
-            body = "\n".join(lines[closing_index + 1 :])
-            return frontmatter + "\n" + body
-        else:
-            # Malformed frontmatter, just prepend new frontmatter
-            return frontmatter + "\n" + content
-    else:
-        # No frontmatter exists, prepend it
-        return frontmatter + "\n" + content
-
-
-def _ensure_blank_line_after_frontmatter(content: str) -> str:
-    """Ensure there's a blank line between frontmatter and content.
-
-    Args:
-        content: The markdown content
-
-    Returns:
-        Content with blank line after frontmatter if frontmatter exists
-    """
-    if not _has_frontmatter(content):
-        return content
-
-    lines = content.split("\n")
-
-    # Find the closing --- of frontmatter
-    closing_index = -1
-    for i in range(1, len(lines)):
-        if lines[i].strip() == "---":
-            closing_index = i
-            break
-
-    if closing_index == -1:
-        return content
-
-    # Check if there's already a blank line after the closing ---, and if the next line is not empty, insert a blank line
-    if closing_index + 1 < len(lines) and lines[closing_index + 1].strip() != "":
-        lines.insert(closing_index + 1, "")
-
-    return "\n".join(lines)
-
-
-def _add_fields_to_frontmatter(content: str, fields: dict[str, str]) -> str:
-    """Add or update fields in frontmatter.
-
-    High-level function that handles frontmatter field manipulation.
-    If frontmatter exists, adds new fields to it. If not, creates new frontmatter with those fields.
-
-    Args:
-        content: The markdown file content as a string
-        fields: A dict of fields to add/update (e.g., {"thumbnail": "null"})
-
-    Returns:
-        The updated markdown content with the new fields in frontmatter
-    """
-    existing_frontmatter = _read_frontmatter(content)
-
-    if existing_frontmatter:
-        # Parse existing frontmatter and add new fields
-        lines = existing_frontmatter.split("\n")
-
-        # Find the closing --- of frontmatter
-        closing_index = -1
-        for i in range(1, len(lines)):
-            if lines[i].strip() == "---":
-                closing_index = i
-                break
-
-        if closing_index > 0:
-            # Insert new fields before the closing ---
-            for key, value in fields.items():
-                # Check if field already exists
-                if not any(line.strip().startswith(f"{key}:") for line in lines):
-                    lines.insert(closing_index, f"{key}: {value}")
-                    closing_index += 1  # Adjust index for next insertion
-
-            new_frontmatter = "\n".join(lines)
-            return _write_frontmatter(content, new_frontmatter)
-    else:
-        # Create new frontmatter with the provided fields
-        field_lines = [f"{key}: {value}" for key, value in fields.items()]
-        new_frontmatter = "---\n" + "\n".join(field_lines) + "\n---"
-        return _write_frontmatter(content, new_frontmatter)
-
-    return content
-
-
-def _add_thumbnail_to_markdown(
-    content: str, thumbnail: str, content_path: Path
-) -> tuple[str, bool]:
-    """Add thumbnail field to a markdown file's frontmatter.
-
-    Args:
-        content: The markdown content
-        thumbnail: The thumbnail value to add
-        content_path: Path for logging purposes
-
-    Returns:
-        Tuple of (modified_content, was_modified)
-    """
-    # Check if thumbnail is already set in frontmatter
-    frontmatter_content = _read_frontmatter(content)
-    if frontmatter_content and "thumbnail:" in frontmatter_content:
-        return content, False
-
-    # Add thumbnail using the fields parameter
-    modified_content = _add_fields_to_frontmatter(
-        content, fields={"thumbnail": thumbnail}
-    )
-
-    if frontmatter_content:
-        click.echo(
-            f"  ↳ Added 'thumbnail: {thumbnail}' to frontmatter in: {content_path}"
-        )
-    else:
-        click.echo(
-            f"  ↳ Created frontmatter with 'thumbnail: {thumbnail}' in: {content_path}"
-        )
-
-    return modified_content, True
-
-
-def build_markdown():
-    """Build markdown files for all content types"""
-    from afterpython.tools._afterpython import get_default_thumbnail
-
-    for content_type in CONTENT_TYPES:
-        # Skip doc content type - docs don't need default thumbnails
-        if content_type == "doc":
-            continue
-
-        click.echo(f"Building markdown files for {content_type}/...")
-
-        path = ap.paths.afterpython_path / content_type.lower()
-
-        # Iterate over all .md files
-        for markdown_path in path.rglob("*.md"):
-            # Skip files in _build directory
-            if "_build" in markdown_path.parts:
-                continue
-
-            # Get path relative to afterpython/
-            content_path = markdown_path.relative_to(ap.paths.afterpython_path)
-
-            # Get default thumbnail for this content type
-            default_thumbnail = get_default_thumbnail(content_type, markdown_path)
-
-            # Read the markdown file
-            content = _read_markdown(markdown_path, content_path)
-            if content is None:
-                continue
-
-            # Ensure blank line after frontmatter (fixes existing files)
-            original_content = content
-            content = _ensure_blank_line_after_frontmatter(content)
-            blank_line_added = content != original_content
-
-            # Add thumbnail to frontmatter
-            modified_content, was_modified = _add_thumbnail_to_markdown(
-                content, default_thumbnail, content_path
-            )
-
-            # Write back if modified (either blank line or thumbnail)
-            if was_modified or blank_line_added:
-                _write_markdown(modified_content, markdown_path)

afterpython/cli/commands/add.py

@@ -1,67 +0,0 @@
-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/cli/commands/init_branch_rules.py

@@ -1,9 +0,0 @@
-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/cli/commands/lock.py

@@ -1,23 +0,0 @@
-import subprocess
-
-import click
-from click.exceptions import Exit
-
-from afterpython.utils import has_pixi, has_uv
-
-
-@click.command()
-def lock():
-    """Lock project dependencies (manages both uv and pixi 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/cli/commands/remove.py

@@ -1,67 +0,0 @@
-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)

afterpython/templates/ci-workflow-template.yml

@@ -1,197 +0,0 @@
-name: CI
-
-# Trigger CI on pushes to main and all pull requests
-# This ensures every code change is validated before merging
-on:
-  push:
-    branches:
-      - main
-  pull_request:
-    # Run on all PRs regardless of target branch
-    branches:
-      - '**'
-
-jobs:
-  # Job 1: Lint and Format Check
-  # Runs ruff to check code quality and formatting
-  lint:
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout code
-        uses: actions/checkout@v6
-
-      - name: Set up Python
-        uses: actions/setup-python@v6
-        with:
-          python-version: '3.11'
-
-      - name: Install uv
-        uses: astral-sh/setup-uv@v7
-        with:
-          version: "latest"
-
-      - 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 .
-
-      - name: Run ruff check
-        run: ruff check --config ./afterpython/ruff.toml .
-
-      - name: Run ruff format check
-        # --check flag ensures it only validates, doesn't reformat
-        run: ruff format --check --config ./afterpython/ruff.toml .
-
-  # Job 2: Detect Test Strategy
-  # Determines whether to use pixi or uv based on pixi.toml presence
-  detect-test-strategy:
-    runs-on: ubuntu-latest
-    outputs:
-      use_pixi: ${{ steps.check.outputs.use_pixi }}
-    steps:
-      - name: Checkout code
-        uses: actions/checkout@v6
-
-      - name: Check for pixi.toml
-        id: check
-        run: |
-          if [ -f "pixi.toml" ]; then
-            echo "use_pixi=true" >> $GITHUB_OUTPUT
-          else
-            echo "use_pixi=false" >> $GITHUB_OUTPUT
-          fi
-
-  # Job 3.1: Test Suite - UV Workflow
-  # Traditional Python testing with uv for projects without pixi
-  test-uv:
-    needs: detect-test-strategy
-    if: needs.detect-test-strategy.outputs.use_pixi == 'false'
-    runs-on: ubuntu-latest
-    strategy:
-      matrix:
-      # TODO: support python 3.14
-        python-version: ['3.11', '3.12', '3.13']
-      fail-fast: false
-
-    steps:
-      - name: Checkout code
-        uses: actions/checkout@v6
-
-      - name: Set up Python ${{ matrix.python-version }}
-        uses: actions/setup-python@v6
-        with:
-          python-version: ${{ matrix.python-version }}
-
-      - name: Install uv
-        uses: astral-sh/setup-uv@v7
-        with:
-          version: "latest"
-
-      - name: Install dependencies
-        run: |
-          # Install package, main dependencies, and test dependencies
-          # If no [dependency-groups] test exists, only the package and main dependencies are installed
-          uv pip install --system . --group test || uv pip install --system .
-
-      - name: Run tests with pytest
-        # Run pytest with verbose output
-        # Exit code 5 (no tests collected) is treated as success
-        run: |
-          pytest -v || if [ $? -eq 5 ]; then exit 0; else exit $?; fi
-
-  # Job 3.2: Test Suite - Pixi Workflow
-  # Pixi-based testing for projects using pixi.toml
-  test-pixi:
-    needs: detect-test-strategy
-    if: needs.detect-test-strategy.outputs.use_pixi == 'true'
-    runs-on: ubuntu-latest
-    strategy:
-      matrix:
-      # TODO: support python 3.14
-        environment: ['py311', 'py312', 'py313']
-      fail-fast: false
-
-    steps:
-      - name: Checkout code
-        uses: actions/checkout@v6
-
-      - name: Set up pixi
-        uses: prefix-dev/setup-pixi@v0.9.3
-        with:
-          pixi-version: v0.60.0
-          cache: true
-          # Optional: Uncomment if you need prefix.dev authentication
-          # auth-host: prefix.dev
-          # auth-token: ${{ secrets.PREFIX_DEV_TOKEN }}
-
-      - name: Run tests with pixi
-        # Runs test in specific Python environment (py311, py312, py313)
-        # Assumes you have environments defined in pixi.toml with a "test" task
-        # Example pixi.toml:
-        #   [environments]
-        #   py311 = ["py311", "test"]
-        #   [feature.test.tasks]
-        #   test = "pytest -v"
-        # Note: Exit code 5 (no tests collected) is treated as success
-        run: |
-          pixi run -e ${{ matrix.environment }} test || if [ $? -eq 5 ]; then exit 0; else exit $?; fi
-
-  # Job 3.3: Test Suite - Complete
-  # Unified test status for branch protection
-  test:
-    if: always()
-    needs: [detect-test-strategy, test-uv, test-pixi]
-    runs-on: ubuntu-latest
-    steps:
-      - name: Check test results
-        run: |
-          uv_result="${{ needs.test-uv.result }}"
-          pixi_result="${{ needs.test-pixi.result }}"
-          # One should succeed, the other should be skipped
-          if [ "$uv_result" == "success" ] || [ "$uv_result" == "skipped" ]; then
-            if [ "$pixi_result" == "success" ] || [ "$pixi_result" == "skipped" ]; then
-              echo "All tests passed!"
-              exit 0
-            fi
-          fi
-          echo "Tests failed: uv=$uv_result, pixi=$pixi_result"
-          exit 1
-
-  # Job 4: Build Verification
-  # Ensures the package can be built successfully
-  build:
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout code
-        uses: actions/checkout@v6
-
-      - name: Set up Python
-        uses: actions/setup-python@v6
-        with:
-          python-version: '3.11'
-
-      - name: Install uv
-        uses: astral-sh/setup-uv@v7
-        with:
-          version: "latest"
-
-      - name: Build package
-        run: uv build
-
-      - name: List build artifacts
-        # Show what was built (wheel + sdist)
-        # Useful for debugging build issues
-        run: ls -lh dist/
-
-      - name: Install built package
-        # Test that the built wheel can be installed
-        # This catches packaging issues like missing files
-        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
-
-  # Job 5: Type Check
-  # typecheck:

afterpython/templates/cz-template.toml

@@ -1,7 +0,0 @@
-[tool.commitizen]
-name = "cz_conventional_commits"
-tag_format = "v$version"
-version_scheme = "pep440"
-version_provider = "uv"
-update_changelog_on_bump = false
-major_version_zero = true

afterpython/templates/dependabot-template.yml

@@ -1,30 +0,0 @@
-# Dependabot configuration for automatic dependency updates
-# See: https://docs.github.com/en/code-security/dependabot/dependabot-version-updates/configuration-options-for-the-dependabot.yml-file
-
-version: 2
-updates:
-  # Update GitHub Actions versions
-  # This keeps your workflow actions secure and up-to-date
-  - package-ecosystem: "github-actions"
-    directory: "/"
-    schedule:
-      # Check for updates monthly (less noisy than weekly)
-      interval: "monthly"
-    labels:
-      - "dependencies"
-      - "github-actions"
-    # Group all GitHub Actions updates into a single PR
-    # This reduces PR noise and makes reviewing easier
-    groups:
-      github-actions:
-        patterns:
-          - "*"
-    # Automatically add reviewers (optional - uncomment and customize)
-    # reviewers:
-    #   - "your-username"
-    # Limit how many Dependabot PRs can be open at once (optional)
-    # Default is 5, increase if you want more concurrent PRs
-    # open-pull-requests-limit: 10
-    #
-    # Note: Auto-merge is configured in GitHub repo settings, not here.
-    # Go to: Settings → General → Pull Requests → Allow auto-merge