justfile

# Default recipe - show help
default: help

# Show available recipes
help:
    @echo "Available recipes:"
    @echo "  install          Install dependencies"
    @echo "  run              Run the development server"
    @echo "  docker-up        Start docker-compose services"
    @echo "  docker-down      Stop docker-compose services"
    @echo ""
    @echo "Testing:"
    @echo "  test             Run all tests"
    @echo "  test-unit        Run unit tests only"
    @echo "  test-integration Run integration tests only"
    @echo "  test-file FILE   Run a specific test file"
    @echo "  test-cov         Run tests with coverage report"
    @echo "  perf-test        Run performance tests"
    @echo "  build-images     Build Docker images"
    @echo "  test-runner      Run Go runner tests (unit + integration)"
    @echo "  test-images      Test Docker images directly"
    @echo ""
    @echo "Code Quality:"
    @echo "  lint             Run ruff linter"
    @echo "  format           Format code with ruff"
    @echo "  format-check     Check code formatting without changes"
    @echo "  typecheck        Run ty type checking"
    @echo "  security-scan    Run bandit security scan"
    @echo ""
    @echo "Maintenance:"
    @echo "  clean            Remove build artifacts and cache"

# Install dependencies
install:
    uv sync

# Run all tests (parallel execution)
test:
    uv run pytest tests/ -v -n auto

# Run unit tests only (parallel execution)
test-unit:
    uv run pytest tests/unit/ -v -n auto

# Run integration tests only (parallel execution)
test-integration:
    uv run pytest tests/integration/ -v -n auto

# Run tests with coverage (sequential for accurate coverage)
test-cov:
    uv run pytest --cov=src --cov-report=html --cov-report=term tests/ -n auto
    @echo "Coverage report generated in htmlcov/"

# Run a single test file (usage: just test-file tests/unit/test_session_service.py)
test-file FILE:
    uv run pytest {{FILE}} -v

# Run Go runner tests (unit + integration)
test-runner:
    cd docker/runner && go test ./... -v

# Run performance tests
perf-test:
    uv run python scripts/perf_test.py

# Build Docker images
build-images *ARGS:
    ./scripts/build-images.sh {{ARGS}}

# Test code exec in Docker images
test-images *ARGS:
    ./scripts/test-images.sh {{ARGS}}

# Test execution in real Kubernetes (requires local K8s cluster + Helm deployment)
test-k8s *ARGS:
    ./scripts/test-k8s.sh {{ARGS}}

# Lint with ruff
lint:
    uv run ruff check src/ tests/

# Format with ruff
format:
    uv run ruff format src/ tests/

# Check formatting without changes
format-check:
    uv run ruff format --check src/ tests/

# Type checking with ty
typecheck:
    uv run ty check src/

# Security scan with bandit
security-scan:
    uv run bandit -r src/ -s B104,B108 --severity-level high

# Clean build artifacts
clean:
    find . -type d -name "__pycache__" -exec rm -rf {} + 2>/dev/null || true
    find . -type d -name ".pytest_cache" -exec rm -rf {} + 2>/dev/null || true
    find . -type d -name ".ty_cache" -exec rm -rf {} + 2>/dev/null || true
    find . -type d -name "htmlcov" -exec rm -rf {} + 2>/dev/null || true
    find . -type f -name "*.pyc" -delete 2>/dev/null || true
    find . -type f -name ".coverage" -delete 2>/dev/null || true

# Run development server
run:
    uv run uvicorn src.main:app --reload --host 0.0.0.0 --port 8000

# Docker compose up
docker-up:
    docker-compose up -d

# Docker compose down
docker-down:
    docker-compose down