elijah 0.1.0__tar.gz

elijah-0.1.0/.codecov.yml

@@ -0,0 +1,41 @@
+# Codecov Configuration for Elijah
+# See https://docs.codecov.com/docs/codecov-yaml for full configuration
+
+coverage:
+  status:
+    project:
+      default:
+        target: 85%                    # Project-wide coverage target
+        threshold: 2%                  # Allow 2% drop before failing
+        if_ci_failed: error            # Fail if CI fails
+    patch:
+      default:
+        target: 80%                    # New code should have 80%+ coverage
+        threshold: 5%
+        if_ci_failed: error
+
+  precision: 2                         # Show 2 decimal places
+  round: down                          # Round coverage down
+  range: "70...95"                     # Coverage range (red to green)
+
+comment:
+  layout: "header, diff, flags, components, footer"
+  behavior: default                    # Comment on every PR
+  require_changes: false               # Always comment, even if no changes
+
+flags:
+  unittests:
+    paths:
+      - src/
+    carryforward: true                 # Use previous coverage if job fails
+  full-coverage:
+    paths:
+      - src/
+    carryforward: true
+
+ignore:
+  - "tests/**"
+  - "docs/**"
+  - "scripts/**"
+  - "examples/**"
+  - "**/__init__.py"

elijah-0.1.0/.editorconfig

@@ -0,0 +1,53 @@
+# EditorConfig helps maintain consistent coding styles across different editors and IDEs
+# https://editorconfig.org
+
+root = true
+
+# Default settings for all files
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+# Python files
+[*.py]
+indent_style = space
+indent_size = 4
+max_line_length = 100
+
+# YAML files
+[*.{yml,yaml}]
+indent_style = space
+indent_size = 2
+
+# TOML files
+[*.toml]
+indent_style = space
+indent_size = 2
+
+# Markdown files
+[*.md]
+indent_style = space
+indent_size = 2
+trim_trailing_whitespace = false  # Preserve trailing spaces for line breaks
+
+# JSON files
+[*.json]
+indent_style = space
+indent_size = 2
+
+# Shell scripts
+[*.sh]
+indent_style = space
+indent_size = 2
+end_of_line = lf
+
+# Makefiles require tabs
+[Makefile]
+indent_style = tab
+
+# GitHub Actions workflows
+[.github/workflows/*.{yml,yaml}]
+indent_style = space
+indent_size = 2

elijah-0.1.0/.github/workflows/changelog-check.yml

@@ -0,0 +1,136 @@
+name: CHANGELOG Check
+
+on:
+  pull_request:
+    branches: [main]
+    types: [opened, synchronize, reopened, labeled, unlabeled]
+
+jobs:
+  check-changelog:
+    name: Verify CHANGELOG Updated
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v6
+        with:
+          fetch-depth: 0  # Need full history to check diff
+
+      - name: Check for CHANGELOG label
+        id: check_label
+        run: |
+          # Check if PR has skip-changelog label
+          SKIP_LABEL=$(gh pr view ${{ github.event.pull_request.number }} --json labels --jq '.labels[].name' | grep -c "skip-changelog" || echo "0")
+          echo "skip_label=$SKIP_LABEL" >> $GITHUB_OUTPUT
+
+          # Check if PR has release:none label (docs/CI only changes)
+          RELEASE_NONE=$(gh pr view ${{ github.event.pull_request.number }} --json labels --jq '.labels[].name' | grep -c "release:none" || echo "0")
+          echo "release_none=$RELEASE_NONE" >> $GITHUB_OUTPUT
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Check CHANGELOG.md changes
+        id: check_changelog
+        run: |
+          # Get the base branch
+          BASE_SHA=${{ github.event.pull_request.base.sha }}
+
+          # Check if CHANGELOG.md was modified
+          CHANGELOG_MODIFIED=$(git diff --name-only $BASE_SHA..HEAD | grep -c "CHANGELOG.md" || echo "0")
+          echo "changelog_modified=$CHANGELOG_MODIFIED" >> $GITHUB_OUTPUT
+
+          # Check if [Unreleased] section was modified
+          if [ "$CHANGELOG_MODIFIED" = "1" ]; then
+            # Check if the diff includes changes to [Unreleased] section
+            UNRELEASED_MODIFIED=$(git diff $BASE_SHA..HEAD -- CHANGELOG.md | grep -c "^+.*- " || echo "0")
+            echo "unreleased_modified=$UNRELEASED_MODIFIED" >> $GITHUB_OUTPUT
+          else
+            echo "unreleased_modified=0" >> $GITHUB_OUTPUT
+          fi
+
+      - name: Determine if check should pass
+        id: determine_result
+        run: |
+          SKIP_LABEL=${{ steps.check_label.outputs.skip_label }}
+          RELEASE_NONE=${{ steps.check_label.outputs.release_none }}
+          CHANGELOG_MODIFIED=${{ steps.check_changelog.outputs.changelog_modified }}
+          UNRELEASED_MODIFIED=${{ steps.check_changelog.outputs.unreleased_modified }}
+
+          # Pass if:
+          # 1. Has skip-changelog label, OR
+          # 2. Has release:none label (docs/CI only), OR
+          # 3. CHANGELOG was modified AND [Unreleased] section has new entries
+          if [ "$SKIP_LABEL" = "1" ] || [ "$RELEASE_NONE" = "1" ]; then
+            echo "result=pass" >> $GITHUB_OUTPUT
+            echo "reason=PR is labeled to skip CHANGELOG check" >> $GITHUB_OUTPUT
+          elif [ "$CHANGELOG_MODIFIED" = "1" ] && [ "$UNRELEASED_MODIFIED" -gt "0" ]; then
+            echo "result=pass" >> $GITHUB_OUTPUT
+            echo "reason=CHANGELOG [Unreleased] section was updated" >> $GITHUB_OUTPUT
+          else
+            echo "result=fail" >> $GITHUB_OUTPUT
+            if [ "$CHANGELOG_MODIFIED" = "0" ]; then
+              echo "reason=CHANGELOG.md was not modified" >> $GITHUB_OUTPUT
+            else
+              echo "reason=CHANGELOG.md was modified but [Unreleased] section appears unchanged" >> $GITHUB_OUTPUT
+            fi
+          fi
+
+      - name: Post comment if check fails
+        if: steps.determine_result.outputs.result == 'fail'
+        run: |
+          REASON="${{ steps.determine_result.outputs.reason }}"
+
+          gh pr comment ${{ github.event.pull_request.number }} --body "## ⚠️ CHANGELOG Check Failed
+
+**Reason:** $REASON
+
+### How to fix:
+
+1. **Update CHANGELOG.md** - Add your changes to the \`[Unreleased]\` section:
+   \`\`\`markdown
+   ## [Unreleased]
+
+   ### Added
+   - Your new feature
+
+   ### Fixed
+   - Your bug fix
+
+   ### Changed
+   - Your modification
+   \`\`\`
+
+2. **OR add a label** if CHANGELOG update is not needed:
+   - Add \`skip-changelog\` label for exceptional cases
+   - Add \`release:none\` label for docs/CI-only changes
+
+### Guidelines:
+
+- **DO update CHANGELOG for:**
+  - New features
+  - Bug fixes
+  - Breaking changes
+  - Deprecations
+
+- **DON'T update CHANGELOG for:**
+  - Documentation-only changes (use \`release:none\` label)
+  - CI/CD configuration (use \`release:none\` label)
+  - Test-only changes (use \`release:none\` label)
+
+See [CONTRIBUTING.md](https://github.com/${{ github.repository }}/blob/main/CONTRIBUTING.md) for more details.
+"
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Fail if check didn't pass
+        if: steps.determine_result.outputs.result == 'fail'
+        run: |
+          echo "❌ ${{ steps.determine_result.outputs.reason }}"
+          echo ""
+          echo "Please update CHANGELOG.md [Unreleased] section or add skip-changelog/release:none label."
+          exit 1
+
+      - name: Success
+        if: steps.determine_result.outputs.result == 'pass'
+        run: |
+          echo "✅ ${{ steps.determine_result.outputs.reason }}"

elijah-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,16 @@
+name: Publish
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/checkout@v6
+      - uses: astral-sh/setup-uv@v7
+      - run: uv build
+      - run: uv publish

elijah-0.1.0/.github/workflows/test.yml

@@ -0,0 +1,177 @@
+name: Test Suite
+
+on:
+  push:
+    branches: ["main"]
+  pull_request:
+    branches: ["main"]
+
+jobs:
+  test:
+    name: Test Python ${{ matrix.python-version }} on ${{ matrix.os }}
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+        python-version: ["3.13"]
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v6
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          enable-cache: true
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v6
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: uv sync --all-extras
+
+      - name: Run unit tests
+        run: uv run pytest tests/ --cov=src --cov-branch --cov-report=xml --cov-report=term --junitxml=test-results-unit.xml
+
+      - name: Upload coverage to Codecov
+        uses: codecov/codecov-action@v5
+        if: matrix.os == 'ubuntu-latest' && matrix.python-version == '3.13'
+        with:
+          token: ${{ secrets.CODECOV_TOKEN }}
+          file: ./coverage.xml
+          flags: unittests
+          name: codecov-umbrella
+          fail_ci_if_error: false
+
+      - name: Upload test results to Codecov
+        uses: codecov/codecov-action@v5
+        if: always()
+        with:
+          token: ${{ secrets.CODECOV_TOKEN }}
+          files: test-results-unit.xml
+          flags: ${{ matrix.os }}-py${{ matrix.python-version }}
+          report_type: test_results
+          fail_ci_if_error: false
+
+  lint:
+    name: Lint and Format Check
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v6
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: "3.13"
+
+      - name: Install dependencies
+        run: uv sync --all-extras
+
+      - name: Check code formatting
+        run: uv run ruff format --check .
+
+      - name: Lint code
+        run: uv run ruff check .
+
+  type-check:
+    name: Type Checking (mypy)
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v6
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: "3.13"
+
+      - name: Install dependencies
+        run: uv sync --all-extras
+
+      - name: Run mypy type checker
+        run: uv run mypy src/elijah --strict-optional --show-error-codes
+
+  security:
+    name: Security Scanning
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v6
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: "3.13"
+
+      - name: Install dependencies
+        run: uv sync --all-extras
+
+      - name: Run bandit security scanner
+        run: uv run bandit -c pyproject.toml -r src/
+
+  coverage:
+    name: Coverage Report
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v6
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: "3.13"
+
+      - name: Install dependencies
+        run: uv sync --all-extras
+
+      - name: Run tests with coverage
+        run: uv run pytest tests/ --cov=src --cov-branch --cov-report=term --cov-report=html --cov-report=xml --junitxml=test-results-full.xml
+
+      - name: Check coverage threshold
+        run: |
+          uv run coverage report --fail-under=85 || echo "Coverage below 85% - expected during initial development"
+
+      - name: Upload coverage to Codecov
+        uses: codecov/codecov-action@v5
+        with:
+          token: ${{ secrets.CODECOV_TOKEN }}
+          file: ./coverage.xml
+          flags: full-coverage
+          name: codecov-full
+          fail_ci_if_error: false
+
+      - name: Upload test results to Codecov
+        uses: codecov/codecov-action@v5
+        if: always()
+        with:
+          token: ${{ secrets.CODECOV_TOKEN }}
+          files: test-results-full.xml
+          flags: full-suite
+          report_type: test_results
+          fail_ci_if_error: false
+
+      - name: Upload coverage artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: coverage-report
+          path: htmlcov/

elijah-0.1.0/.gitignore

@@ -0,0 +1,46 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv
+venv/
+env/
+
+# Testing
+.pytest_cache/
+.coverage
+coverage.xml
+htmlcov/
+test-results*.xml
+*.cover
+.hypothesis/
+
+# Type checking
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Ruff
+.ruff_cache/
+
+# IDEs
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+.DS_Store
+
+# Documentation
+site/
+docs/_build/
+
+# Other
+*.log
+.env
+.env.local

elijah-0.1.0/.pre-commit-config.yaml

@@ -0,0 +1,92 @@
+# Pre-commit hooks for Elijah
+# Install: pip install pre-commit && pre-commit install
+# Run manually: pre-commit run --all-files
+# Update hooks: pre-commit autoupdate
+
+repos:
+  # Ruff - Fast Python linter and formatter
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.8.4
+    hooks:
+      # Run the linter
+      - id: ruff
+        args: [--fix, --exit-non-zero-on-fix]
+        types_or: [python, pyi]
+      # Run the formatter
+      - id: ruff-format
+        types_or: [python, pyi]
+
+  # Type checking with mypy
+  - repo: https://github.com/pre-commit/mirrors-mypy
+    rev: v1.13.0
+    hooks:
+      - id: mypy
+        args: [--ignore-missing-imports, --no-strict-optional]
+        exclude: ^(tests/|docs/)
+
+  # Built-in pre-commit hooks
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v5.0.0
+    hooks:
+      # General file checks
+      - id: trailing-whitespace
+        args: [--markdown-linebreak-ext=md]
+      - id: end-of-file-fixer
+      - id: check-yaml
+        exclude: ^\.github/workflows/
+      - id: check-toml
+      - id: check-json
+      - id: check-added-large-files
+        args: [--maxkb=1000]
+      - id: check-merge-conflict
+      - id: check-case-conflict
+      - id: mixed-line-ending
+        args: [--fix=lf]
+
+      # Python-specific checks
+      - id: check-docstring-first
+      - id: check-ast
+      - id: debug-statements
+      - id: name-tests-test
+        args: [--pytest-test-first]
+        exclude: ^tests/(conftest\.py|fixtures/|helpers/)
+
+      # Security checks
+      - id: detect-private-key
+
+  # Security vulnerability scanning
+  - repo: https://github.com/PyCQA/bandit
+    rev: 1.8.0
+    hooks:
+      - id: bandit
+        args: [-c, pyproject.toml, -r, src/]
+        additional_dependencies: ["bandit[toml]"]
+
+  # Markdown linting
+  - repo: https://github.com/igorshubovych/markdownlint-cli
+    rev: v0.43.0
+    hooks:
+      - id: markdownlint
+        args: [--fix]
+        exclude: ^(docs/session-.*\.md|CHANGELOG\.md)
+
+  # YAML formatting
+  - repo: https://github.com/macisamuele/language-formatters-pre-commit-hooks
+    rev: v2.14.0
+    hooks:
+      - id: pretty-format-yaml
+        args: [--autofix, --indent, '2']
+        exclude: ^\.github/workflows/
+
+# Configuration for specific hooks
+ci:
+  autofix_commit_msg: |
+    [pre-commit.ci] auto fixes from pre-commit.com hooks
+
+    for more information, see https://pre-commit.ci
+  autofix_prs: true
+  autoupdate_branch: ''
+  autoupdate_commit_msg: '[pre-commit.ci] pre-commit autoupdate'
+  autoupdate_schedule: weekly
+  skip: [mypy]  # Skip mypy in pre-commit.ci (too slow)
+  submodules: false

elijah-0.1.0/.python-version

@@ -0,0 +1 @@
+3.13

elijah-0.1.0/CHANGELOG.md

@@ -0,0 +1,30 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+### Added
+
+- Initial project structure with Python 3.13 support
+- Comprehensive CI/CD pipeline with GitHub Actions
+- Test suite with pytest and coverage reporting
+- Code quality tools (ruff, mypy, bandit)
+- Pre-commit hooks for code quality
+- Documentation infrastructure with MkDocs
+- PyPI publishing workflow with uv
+- Makefile for common development tasks
+
+## [0.1.0] - 2026-02-07
+
+### Added
+
+- Initial release
+- Basic project structure
+- CLI entry point
+
+[Unreleased]: https://github.com/DecisionNerd/elijah/compare/v0.1.0...HEAD
+[0.1.0]: https://github.com/DecisionNerd/elijah/releases/tag/v0.1.0