justfile

# Karma MCP Server - Modern task runner with Just
# https://github.com/casey/just

# Variables
python := "python3"
uv := "uv"
docker_image := "driosalido/karma-mcp"
docker_tag := "latest"
karma_url := env_var_or_default("KARMA_URL", "http://localhost:8080")

# Default command - show available recipes
default:
    @just --list

# === Installation ===

# Install dependencies
install:
    {{uv}} sync --all-extras
    @echo "✅ Dependencies installed"

# Install development dependencies
install-dev:
    {{uv}} sync --all-extras --dev
    @echo "✅ Development dependencies installed"

# === Testing ===

# Run all tests
test:
    {{uv}} run pytest tests/ -v

# Run only unit tests
test-unit:
    {{uv}} run pytest tests/unit/ -v

# Run only integration tests (requires KARMA_URL)
test-integration:
    KARMA_URL={{karma_url}} {{uv}} run pytest tests/integration/ -v

# Run tests with coverage
test-coverage:
    {{uv}} run pytest --cov=src/karma_mcp --cov-report=html --cov-report=term-missing tests/
    @echo "📊 Coverage report generated in htmlcov/"

# Test specific MCP tools
test-mcp-tools:
    {{uv}} run pytest tests/unit/test_mcp_tools.py -v

# === Code Quality ===

# Run linting checks
lint:
    {{uv}} run ruff check src/ tests/

# Format code
format:
    {{uv}} run ruff format src/ tests/
    @echo "✅ Code formatted"

# Run type checking
type-check:
    {{uv}} run mypy src/

# Run all quality checks
check: lint type-check test-unit
    @echo "✅ All checks passed"

# === Development ===

# Run MCP server locally for testing
serve-mcp:
    KARMA_URL={{karma_url}} {{uv}} run python -m karma_mcp.server

# Debug Karma API responses
debug-karma:
    KARMA_URL={{karma_url}} {{uv}} run python -c 'import asyncio; from karma_mcp.server import check_karma; asyncio.run(check_karma())'

# === Docker ===

# Build Docker image for multiple platforms
docker-build:
    docker buildx build --platform linux/amd64,linux/arm64 -t {{docker_image}}:{{docker_tag}} -f docker/Dockerfile . --push

# Build Docker image locally
docker-build-local:
    docker buildx build -t {{docker_image}}:{{docker_tag}} -f docker/Dockerfile . --load

# Run Docker image locally
docker-run:
    docker run --rm -p 8080:8080 -e KARMA_URL={{karma_url}} {{docker_image}}:{{docker_tag}}

# Test Docker image
docker-test:
    docker run --rm {{docker_image}}:{{docker_tag}} python -m pytest tests/unit/ -v

# === Kubernetes/Helm ===

# Install Helm chart (requires kubectl context)
helm-install:
    helm install karma-mcp ./helm/karma-mcp -n monitoring --create-namespace

# Upgrade Helm chart
helm-upgrade:
    helm upgrade karma-mcp ./helm/karma-mcp -n monitoring

# Uninstall Helm chart
helm-uninstall:
    helm uninstall karma-mcp -n monitoring

# === Cleanup ===

# Clean up generated files
clean:
    rm -rf htmlcov/
    rm -rf .coverage
    rm -rf .pytest_cache/
    find . -type d -name __pycache__ -exec rm -rf {} + 2>/dev/null || true
    find . -type f -name "*.pyc" -delete
    @echo "🧹 Cleaned up generated files"

# Clean up Docker images
clean-docker:
    docker image prune -f
    @echo "🐳 Docker images cleaned"

# === Utilities ===

# Show current version
version:
    @echo "Karma MCP Server"
    @grep -E '^version = ' pyproject.toml | head -1
    @echo "Docker image: {{docker_image}}:{{docker_tag}}"

# Validate configuration files
validate:
    @echo "Validating pyproject.toml..."
    @{{python}} -c "import tomllib; tomllib.load(open('pyproject.toml', 'rb'))" && echo "✅ pyproject.toml is valid"

# Set up development environment
dev-setup: install-dev
    @echo "🚀 Development environment ready!"
    @echo ""
    @echo "Next steps:"
    @echo "  just test-unit     # Run unit tests"
    @echo "  just serve-mcp     # Start MCP server"
    @echo "  just check         # Run all checks"

# === CI/CD ===

# Run tests in CI environment
ci-test:
    {{uv}} run pytest --cov=src/karma_mcp --cov-report=xml --cov-report=term-missing -v

# Run quality checks for CI
ci-quality: lint type-check
    @echo "✅ Quality checks completed"

# === Karma Integration ===

# Quick test with real Karma server (requires port-forward)
test-with-karma:
    @echo "Testing with Karma at {{karma_url}}"
    KARMA_URL={{karma_url}} {{uv}} run python scripts/test_karma.py