Add CI/CD pipeline with pytest, ruff, and pyright

[brunovcosta]

Summary

Added a comprehensive CI/CD pipeline using GitHub Actions that automatically runs tests, linting, and type checking on every pull request. This ensures code quality and prevents broken code from being merged into main.

What's Included

🔄 GitHub Actions Workflow

Created .github/workflows/ci.yml with four jobs:

1. Tests (pytest)

• ✅ Runs on Python 3.8, 3.9, 3.10, 3.11, and 3.12
• ✅ Executes all 187 tests with coverage reporting
• ✅ Uses pytest-cov for coverage analysis
• ✅ Uploads coverage to Codecov (optional, won't fail if unavailable)
• ✅ Ensures compatibility across all supported Python versions

2. Lint (ruff)

• ✅ Fast Python linter and formatter
• ✅ Checks code style (PEP 8 compliance)
• ✅ Validates import ordering
• ✅ Runs both ruff check and ruff format --check
• ✅ Enforces consistent code style across the project

3. Type Check (pyright)

• ✅ Static type analysis with pyright
• ✅ Catches type-related bugs before runtime
• ✅ Configured for basic type checking mode
• ✅ Analyzes the entire abstra_json_sql package

4. All Checks Passed

• ✅ Summary job that depends on all other jobs
• ✅ Provides clear pass/fail status for PR reviews
• ✅ Makes it easy to see if all checks succeeded

📦 Configuration Files

requirements-dev.txt

pytest>=7.4.0         # Testing framework
pytest-cov>=4.1.0     # Coverage reporting
ruff>=0.1.0           # Linter and formatter
pyright>=1.1.0        # Type checker

ruff.toml

• Target: Python 3.8+
• Line length: 88 characters
• Rules: pycodestyle (E, W), pyflakes (F), isort (I)
• Style: double quotes, space indentation

pyrightconfig.json

• Type checking mode: basic
• Target: Python 3.8+
• Includes: abstra_json_sql package
• Balanced between strictness and development flexibility

Benefits

🛡️ Quality Assurance

• Automated validation on every PR
• Catch bugs early before they reach production
• Consistent code style across all contributions
• Type safety prevents common runtime errors

🚀 Developer Experience

• Fast feedback - Results in minutes
• Multi-version testing - Confidence across Python versions
• Pre-commit validation - Know issues before pushing
• Clear error messages - Easy to understand what failed

🔒 Integration with Branch Protection

These checks are designed to work seamlessly with GitHub's branch protection rules. When the PR is merged and branch protection is updated to require status checks, future PRs will be blocked from merging until:

• ✅ All tests pass (187 tests × 5 Python versions = 935 test runs)
• ✅ Code passes linting (ruff check + ruff format)
• ✅ Code passes type checking (pyright)

📊 Status Badges (Optional)

After this PR is merged, you can add status badges to your README:

[![CI](https://github.com/abstra-app/json-sql/actions/workflows/ci.yml/badge.svg)](https://github.com/abstra-app/json-sql/actions/workflows/ci.yml)
[![codecov](https://codecov.io/gh/abstra-app/json-sql/branch/main/graph/badge.svg)](https://codecov.io/gh/abstra-app/json-sql)

Testing

All checks were tested locally before creating this PR:

# Install dev dependencies
pip install -r requirements-dev.txt

# Run tests
pytest -v  # ✅ 187 tests passed

# Run linting
ruff check .  # ✅ No issues
ruff format --check .  # ✅ Formatting correct

# Run type checking
pyright abstra_json_sql  # ✅ No type errors

Next Steps

After merging this PR, you can update branch protection rules to require these checks:

# Via GitHub CLI (already done in previous PR)
gh api repos/abstra-app/json-sql/branches/main/protection -X PUT \
  --field required_status_checks[strict]=true \
  --field required_status_checks[contexts][]=test \
  --field required_status_checks[contexts][]=lint \
  --field required_status_checks[contexts][]=typecheck

Or via GitHub UI:

1. Go to Settings → Branches → Branch protection rules
2. Edit the main branch rule
3. Check "Require status checks to pass before merging"
4. Select: test, lint, typecheck, all-checks-passed

Files Changed

• .github/workflows/ci.yml - Main CI/CD workflow
• requirements-dev.txt - Development dependencies
• ruff.toml - Ruff linter/formatter configuration
• pyrightconfig.json - Pyright type checker configuration

🤖 Generated with Claude Code