mcp-kicad-sch-api: Command for Claude Code

Test Runner Command - MCP KiCAD Schematic API

Usage

/run-tests [options]

Description

Orchestrates comprehensive testing for the MCP KiCAD Schematic API server, covering all MCP tools and KiCAD integration with professional test reporting.

Options

• --suite=standard - Test suite: quick, standard, integration, coverage (default: standard)
• --skip-install - Skip dependency reinstallation (faster for development)
• --keep-outputs - Don't delete generated test files
• --verbose - Show detailed output
• --fail-fast=false - Stop on first failure (default: false)

Test Suites

🚀 Quick Suite (~5 seconds)

Fast development testing:

pytest tests/test_server.py -q

📋 Standard Suite - Default (~15 seconds)

Comprehensive MCP server functionality:

# Run all tests
pytest tests/ -v --tb=short

🔬 Integration Suite (~30 seconds)

Complete validation with real KiCAD files:

# Integration tests with kicad-sch-api
pytest tests/test_mcp_server_integration.py -v

# Test MCP tool workflows
pytest tests/ -v -k "integration"

📊 Coverage Suite (~20 seconds)

Detailed coverage analysis:

pytest tests/ --cov=mcp_kicad_sch_api --cov-report=term-missing --cov-report=html --cov-fail-under=80

Implementation

#!/bin/bash

# Parse arguments
SUITE="standard"
SKIP_INSTALL=false
KEEP_OUTPUTS=false
VERBOSE=false
FAIL_FAST=false

while [[ $# -gt 0 ]]; do
    case $1 in
        --suite=*)
            SUITE="${1#*=}"
            shift
            ;;
        --skip-install)
            SKIP_INSTALL=true
            shift
            ;;
        --verbose)
            VERBOSE=true
            shift
            ;;
        --fail-fast)
            FAIL_FAST=true
            shift
            ;;
        *)
            echo "Unknown option: $1"
            exit 1
            ;;
    esac
done

# Ensure we're in project root
if [[ ! -f "pyproject.toml" ]]; then
    echo "❌ Must run from mcp-kicad-sch-api root"
    exit 1
fi

# Install dependencies if needed
if [[ "$SKIP_INSTALL" == "false" ]]; then
    echo "📦 Installing dependencies..."
    pip install -e . --quiet
    pip install -e submodules/kicad-sch-api --quiet
    pip install pytest pytest-cov --quiet
fi

# Build pytest arguments
PYTEST_ARGS=""
[[ "$VERBOSE" == "true" ]] && PYTEST_ARGS="$PYTEST_ARGS -v"
[[ "$FAIL_FAST" == "true" ]] && PYTEST_ARGS="$PYTEST_ARGS -x"

# Execute test suite
case $SUITE in
    quick)
        echo "🚀 Running quick test suite..."
        pytest tests/test_server.py -q $PYTEST_ARGS
        ;;
        
    standard)
        echo "📋 Running standard test suite..."
        pytest tests/ --tb=short $PYTEST_ARGS
        ;;
        
    integration)
        echo "🔬 Running integration test suite..."
        
        # MCP server integration tests
        pytest tests/test_mcp_server_integration.py -v $PYTEST_ARGS || exit 1
        
        # All integration workflows
        pytest tests/ -v -k "integration" $PYTEST_ARGS
        ;;
        
    coverage)
        echo "📊 Running coverage analysis..."
        pytest tests/ --cov=mcp_kicad_sch_api --cov-report=term-missing --cov-report=html --cov-fail-under=70 $PYTEST_ARGS
        echo "📊 Coverage report: htmlcov/index.html"
        ;;
        
    *)
        echo "❌ Unknown suite: $SUITE"
        echo "Available suites: quick, standard, integration, coverage"
        exit 1
        ;;
esac

# Cleanup if requested
if [[ "$KEEP_OUTPUTS" == "false" ]]; then
    echo "🧹 Cleaning up test outputs..."
    rm -rf .pytest_cache/ .coverage htmlcov/ test_*.kicad_sch 2>/dev/null || true
fi

echo "✅ Test suite completed"