kicad-sch-api 0.1.7__py3-none-any.whl → 0.2.1__py3-none-any.whl

kicad_sch_api/__init__.py

@@ -42,11 +42,12 @@ Advanced Usage:
         print(f"Found {len(issues)} validation issues")
 """
 
-__version__ = "0.0.2"
+__version__ = "0.3.0"
 __author__ = "Circuit-Synth"
 __email__ = "info@circuit-synth.com"
 
 from .core.components import Component, ComponentCollection
+from .core.config import KiCADConfig, config
 
 # Core imports for public API
 from .core.schematic import Schematic
@@ -54,7 +55,7 @@ from .library.cache import SymbolLibraryCache, get_symbol_cache
 from .utils.validation import ValidationError, ValidationIssue
 
 # Version info
-VERSION_INFO = (0, 0, 2)
+VERSION_INFO = (0, 3, 0)
 
 # Public API
 __all__ = [
@@ -64,6 +65,9 @@ __all__ = [
     "ComponentCollection",
     "SymbolLibraryCache",
     "get_symbol_cache",
+    # Configuration
+    "KiCADConfig",
+    "config",
     # Exceptions
     "ValidationError",
     "ValidationIssue",

kicad_sch_api/cli.py

@@ -2,216 +2,119 @@
 """
 KiCAD Schematic API - Command Line Interface
 
-Provides helpful commands for setup, testing, and usage of the MCP server.
+Provides helpful commands for testing and usage of the library.
 """
 
-import sys
-import json
-import os
-import subprocess
 import argparse
+import subprocess
+import sys
 from pathlib import Path
-from typing import Dict, Any
-
-def get_claude_config_path() -> Path:
-    """Get the Claude Code configuration file path for current platform."""
-    if sys.platform == "darwin":
-        return Path.home() / "Library/Application Support/Claude/claude_desktop_config.json"
-    elif sys.platform == "win32":
-        return Path(os.environ["APPDATA"]) / "Claude/claude_desktop_config.json"
-    else:  # Linux and others
-        return Path.home() / ".config/Claude/claude_desktop_config.json"
-
-def setup_claude_code() -> bool:
-    """Automatically configure Claude Code MCP settings."""
-    print("🔧 Setting up Claude Code MCP configuration...")
-    
-    config_path = get_claude_config_path()
-    
-    # Create directory if it doesn't exist
-    config_path.parent.mkdir(parents=True, exist_ok=True)
-    
-    # Backup existing config
-    if config_path.exists():
-        backup_path = config_path.with_suffix(f".backup.{config_path.stat().st_mtime:.0f}.json")
-        backup_path.write_text(config_path.read_text())
-        print(f"📁 Backed up existing config to: {backup_path}")
-    
-    # Read existing config or create new one
-    if config_path.exists():
-        with open(config_path) as f:
-            config = json.load(f)
-    else:
-        config = {}
-    
-    # Ensure mcpServers section exists
-    if "mcpServers" not in config:
-        config["mcpServers"] = {}
-    
-    # Use direct Python command - this is more reliable than trying to find binary paths
-    config["mcpServers"]["kicad-sch-api"] = {
-        "command": sys.executable,
-        "args": ["-m", "kicad_sch_api.mcp.server"],
-        "env": {}
-    }
-    
-    # Write configuration
-    with open(config_path, 'w') as f:
-        json.dump(config, f, indent=2)
-    
-    print(f"✅ Configuration written to: {config_path}")
-    print("🔄 Please restart Claude Code to apply changes")
-    return True
+
 
 def test_installation() -> bool:
-    """Test that the MCP server is working correctly."""
-    print("🧪 Testing KiCAD Schematic MCP Server...")
-    
+    """Test that the library is working correctly."""
+    print("🧪 Testing KiCAD Schematic API Library...")
+
     try:
-        # Test import
-        from kicad_sch_api.mcp.server import main as mcp_main
-        print("✅ MCP server module imports successfully")
-        
-        # Test component discovery
-        from kicad_sch_api.discovery.search_index import get_search_index
-        print("✅ Component discovery system available")
-        
-        # Test KiCAD library access
+        # Test basic import
+        import kicad_sch_api
+
+        version = getattr(kicad_sch_api, "__version__", "unknown")
+        print(f"✅ Library imports successfully: v{version}")
+
+        # Test core functionality
+        import kicad_sch_api as ksa
+
+        sch = ksa.create_schematic("test")
+        print("✅ Can create schematic")
+
+        # Test component addition
+        sch.components.add(lib_id="Device:R", reference="R1", value="10k", position=(100, 100))
+        print("✅ Can add components")
+
+        # Test library access
         from kicad_sch_api.library.cache import get_symbol_cache
+
         cache = get_symbol_cache()
         stats = cache.get_performance_stats()
-        print(f"✅ Symbol cache initialized: {stats['total_symbols_cached']} symbols")
-        
+        print(f"✅ Symbol cache available: {stats['total_symbols_cached']} symbols")
+
         print("🎉 All tests passed!")
         return True
-        
+
     except Exception as e:
         print(f"❌ Test failed: {e}")
         return False
 
+
 def show_status() -> bool:
-    """Show current installation and configuration status."""
-    print("📊 KiCAD Schematic MCP Server Status")
+    """Show current installation status."""
+    print("📊 KiCAD Schematic API Library Status")
     print("=" * 40)
-    
+
     # Check installation
     try:
         import kicad_sch_api
-        version = getattr(kicad_sch_api, '__version__', 'unknown')
-        print(f"✅ Package installed: v{version}")
+
+        version = getattr(kicad_sch_api, "__version__", "unknown")
+        print(f"✅ Library installed: v{version}")
     except ImportError:
-        print("❌ Package not installed")
+        print("❌ Library not installed")
         return False
-    
-    # Check MCP command
-    mcp_cmd_path = None
-    try:
-        result = subprocess.run(['kicad-sch-mcp', '--help'], 
-                              capture_output=True, timeout=5)
-        if result.returncode == 0:
-            print("✅ MCP command available")
-            mcp_cmd_path = "kicad-sch-mcp"
-        else:
-            print("⚠️  MCP command found but returns error")
-    except (subprocess.TimeoutExpired, FileNotFoundError):
-        # Try to find the command in common locations
-        import sys
-        python_version = f"{sys.version_info.major}.{sys.version_info.minor}"
-        possible_paths = [
-            f"/Library/Frameworks/Python.framework/Versions/{python_version}/bin/kicad-sch-mcp",
-            os.path.expanduser(f"~/Library/Python/{python_version}/bin/kicad-sch-mcp"),
-            os.path.expanduser("~/.local/bin/kicad-sch-mcp"),
-            "/usr/local/bin/kicad-sch-mcp"
-        ]
-        
-        for path_to_try in possible_paths:
-            if os.path.exists(path_to_try) and os.access(path_to_try, os.X_OK):
-                print(f"✅ MCP command found at: {path_to_try}")
-                print("⚠️  Note: Command not in PATH, but found at above location")
-                mcp_cmd_path = path_to_try
-                break
-        
-        if not mcp_cmd_path:
-            print("❌ MCP command not found in PATH")
-            print("   You may need to add Python scripts directory to your PATH")
-            print(f"   Try: export PATH=\"/Library/Frameworks/Python.framework/Versions/{python_version}/bin:$PATH\"")
-    
-    # Store found path for potential use in configuration
-    if mcp_cmd_path:
-        os.environ['FOUND_MCP_PATH'] = mcp_cmd_path
-    
-    # Check Claude Code configuration
-    config_path = get_claude_config_path()
-    if config_path.exists():
-        try:
-            with open(config_path) as f:
-                config = json.load(f)
-            if "kicad-sch-api" in config.get("mcpServers", {}):
-                print("✅ Claude Code MCP configuration found")
-            else:
-                print("⚠️  Claude Code config exists but kicad-sch-api not configured")
-        except json.JSONDecodeError:
-            print("❌ Claude Code config file is invalid JSON")
-    else:
-        print("❌ Claude Code configuration not found")
-    
+
     # Check KiCAD libraries
     try:
         from kicad_sch_api.library.cache import get_symbol_cache
+
         cache = get_symbol_cache()
         stats = cache.get_performance_stats()
-        print(f"✅ KiCAD libraries: {len(cache._lib_stats)} libraries, {stats['total_symbols_cached']} symbols")
+        print(
+            f"✅ KiCAD libraries: {len(cache._lib_stats)} libraries, {stats['total_symbols_cached']} symbols"
+        )
     except Exception as e:
         print(f"⚠️  KiCAD library access: {e}")
-    
+
     return True
 
+
 def create_demo() -> bool:
     """Create a demo schematic to test functionality."""
     print("🎨 Creating demo schematic...")
-    
+
     try:
         import kicad_sch_api as ksa
-        
+
         # Create demo schematic
         sch = ksa.create_schematic("Demo_Circuit")
-        
+
         # Add components
-        resistor = sch.components.add('Device:R', reference='R1', value='10k', position=(100, 100))
-        capacitor = sch.components.add('Device:C', reference='C1', value='100nF', position=(150, 100))
-        led = sch.components.add('Device:LED', reference='D1', value='LED', position=(200, 100))
-        
-        # Add a hierarchical sheet
-        sheet_uuid = sch.add_sheet(
-            name="Subcircuit",
-            filename="subcircuit_demo.kicad_sch",
-            position=(100, 150),
-            size=(60, 40)
+        resistor = sch.components.add("Device:R", reference="R1", value="10k", position=(100, 100))
+        capacitor = sch.components.add(
+            "Device:C", reference="C1", value="100nF", position=(150, 100)
         )
-        
-        # Add sheet pins
-        sch.add_sheet_pin(sheet_uuid, "VCC", "input", (0, 10))
-        sch.add_sheet_pin(sheet_uuid, "GND", "input", (0, 30))
-        
+        led = sch.components.add("Device:LED", reference="D1", value="LED", position=(200, 100))
+
         # Save schematic
         sch.save("demo_circuit.kicad_sch")
-        
+
         print("✅ Demo schematic created: demo_circuit.kicad_sch")
-        print("📁 Contains: resistor, capacitor, LED, and hierarchical sheet")
+        print("📁 Contains: resistor, capacitor, and LED")
         print("🔗 Try opening in KiCAD: kicad demo_circuit.kicad_sch")
-        
+
         return True
-        
+
     except Exception as e:
         print(f"❌ Demo creation failed: {e}")
         return False
 
+
 def init_cache() -> bool:
     """Initialize the component discovery cache."""
     print("🔄 Initializing component discovery cache...")
-    
+
     try:
         from kicad_sch_api.discovery.search_index import ensure_index_built
+
         component_count = ensure_index_built()
         print(f"✅ Component cache initialized: {component_count} components indexed")
         return True
@@ -219,14 +122,14 @@ def init_cache() -> bool:
         print(f"❌ Cache initialization failed: {e}")
         return False
 
+
 def check_kicad() -> bool:
     """Check KiCAD installation and library access."""
     print("🔍 Checking KiCAD installation...")
-    
+
     try:
         # Check if KiCAD command is available
-        result = subprocess.run(['kicad', '--version'], 
-                              capture_output=True, timeout=10)
+        result = subprocess.run(["kicad", "--version"], capture_output=True, timeout=10)
         if result.returncode == 0:
             version_output = result.stdout.decode().strip()
             print(f"✅ KiCAD found: {version_output}")
@@ -235,89 +138,37 @@ def check_kicad() -> bool:
     except (subprocess.TimeoutExpired, FileNotFoundError):
         print("❌ KiCAD command not found in PATH")
         print("   Please ensure KiCAD is installed and accessible")
-    
+
     # Check library directories
     try:
         from kicad_sch_api.library.cache import get_symbol_cache
+
         cache = get_symbol_cache()
-        
+
         print("📚 KiCAD Library Status:")
         for lib_name, lib_stats in cache._lib_stats.items():
             print(f"   • {lib_name}: {lib_stats.symbol_count} symbols")
-        
+
         return True
     except Exception as e:
         print(f"❌ Library access failed: {e}")
         return False
 
-def show_logs():
-    """Show recent MCP server logs."""
-    print("📜 Recent MCP Server Logs")
+
+def show_mcp_info() -> None:
+    """Show information about MCP server integration."""
+    print("🤖 MCP Server Integration")
     print("=" * 25)
-    
-    # For now, just run the server with debug output
-    print("To view live logs, run:")
-    print("  kicad-sch-mcp --debug")
     print()
-    print("Or check Claude Code logs in:")
-    if sys.platform == "darwin":
-        print("  ~/Library/Logs/Claude/mcp-server-kicad-sch-api.log")
-    elif sys.platform == "win32":
-        print("  %USERPROFILE%\\AppData\\Local\\Claude\\Logs\\mcp-server-kicad-sch-api.log")
-    else:
-        print("  ~/.local/share/Claude/logs/mcp-server-kicad-sch-api.log")
-
-def setup_everything() -> bool:
-    """One-command setup that does everything automatically."""
-    print("🚀 KiCAD Schematic API - Complete Setup")
-    print("=" * 40)
+    print("This library serves as a foundation for MCP servers.")
+    print("For AI agent integration, install the dedicated MCP server:")
     print()
-    
-    success = True
-    
-    # 1. Test installation
-    print("Step 1/4: Testing installation...")
-    if not test_installation():
-        print("❌ Installation test failed. Please reinstall the package.")
-        return False
-    print()
-    
-    # 2. Initialize cache
-    print("Step 2/4: Initializing component cache...")
-    if not init_cache():
-        print("⚠️  Cache initialization failed, but continuing...")
-    print()
-    
-    # 3. Setup Claude Code (using direct Python command)
-    print("Step 3/4: Configuring Claude Code...")
-    if not setup_claude_code():
-        print("⚠️  Claude Code setup failed, but continuing...")
-    print()
-    
-    # 4. Create demo
-    print("Step 4/4: Creating demo schematic...")
-    if not create_demo():
-        print("⚠️  Demo creation failed, but setup is complete")
-    print()
-    
-    # Final status
-    print("🎉 Setup Complete!")
+    print("  pip install mcp-kicad-sch-api")
+    print("  code mcp install mcp-kicad-sch-api")
     print()
-    print("✅ What was configured:")
-    print("  • MCP server ready for Claude Code")
-    print("  • Component discovery cache initialized")
-    print("  • Demo schematic created")
-    print()
-    print("🚀 Next steps:")
-    print("1. Restart Claude Code")
-    print("2. Try: 'Create a voltage divider with two 10kΩ resistors'")
-    print("3. Open demo_circuit.kicad_sch in KiCAD to see the example")
-    print()
-    print("🔍 To test manually:")
-    print("  python -m kicad_sch_api.mcp.server --test")
-    print()
-    
-    return True
+    print("Related projects:")
+    print("  • mcp-kicad-sch-api: https://github.com/circuit-synth/mcp-kicad-sch-api")
+    print("  • Claude Code: https://claude.ai/code")
 
 
 def main():
@@ -327,74 +178,70 @@ def main():
         formatter_class=argparse.RawDescriptionHelpFormatter,
         epilog="""
 Examples:
-  kicad-sch-api --setup                 # Complete one-command setup (RECOMMENDED)
-  kicad-sch-api --setup-claude-code     # Configure Claude Code MCP settings only
-  kicad-sch-api --test                  # Test installation
+  kicad-sch-api --test                  # Test library installation
   kicad-sch-api --demo                  # Create demo schematic
-        """
+  kicad-sch-api --status                # Show library status
+        """,
     )
-    
-    # Main setup options
-    parser.add_argument('--setup', action='store_true',
-                       help='Complete one-command setup (RECOMMENDED)')
-    
-    # Setup options
-    parser.add_argument('--setup-claude-code', action='store_true',
-                       help='Configure Claude Code MCP settings only')
-    parser.add_argument('--test', action='store_true',
-                       help='Test that the installation is working')
-    parser.add_argument('--status', action='store_true',
-                       help='Show detailed installation and configuration status')
-    parser.add_argument('--demo', action='store_true',
-                       help='Create a demo schematic')
-    parser.add_argument('--init-cache', action='store_true',
-                       help='Initialize component discovery cache')
-    parser.add_argument('--check-kicad', action='store_true',
-                       help='Check KiCAD installation and libraries')
-    parser.add_argument('--logs', action='store_true',
-                       help='Show recent MCP server logs')
-    
+
+    # Main options
+    parser.add_argument("--test", action="store_true", help="Test that the library is working")
+    parser.add_argument("--status", action="store_true", help="Show library installation status")
+    parser.add_argument("--demo", action="store_true", help="Create a demo schematic")
+    parser.add_argument(
+        "--init-cache", action="store_true", help="Initialize component discovery cache"
+    )
+    parser.add_argument(
+        "--check-kicad", action="store_true", help="Check KiCAD installation and libraries"
+    )
+    parser.add_argument(
+        "--mcp-info", action="store_true", help="Show MCP server integration information"
+    )
+
     args = parser.parse_args()
-    
-    # If no arguments provided, suggest setup
+
+    # If no arguments provided, show help
     if not any(vars(args).values()):
         print("🚀 KiCAD Schematic API - Command Line Interface")
         print()
-        print("🌟 RECOMMENDED: Complete setup:")
-        print("  kicad-sch-api --setup")
+        print("This is a pure Python library for KiCAD schematic manipulation.")
+        print()
+        print("🧪 Test the installation:")
+        print("  kicad-sch-api --test")
+        print()
+        print("🎨 Create a demo schematic:")
+        print("  kicad-sch-api --demo")
+        print()
+        print("🤖 For AI agent integration:")
+        print("  kicad-sch-api --mcp-info")
         print()
-        print("🆘 For help with all options:")
+        print("🆘 For all options:")
         print("  kicad-sch-api --help")
         return
-    
+
     # Execute requested actions
     success = True
-    
-    if args.setup:
-        success &= setup_everything()
-    
-    if args.setup_claude_code:
-        success &= setup_claude_code()
-    
+
     if args.test:
         success &= test_installation()
-    
+
     if args.status:
         success &= show_status()
-    
+
     if args.demo:
         success &= create_demo()
-    
+
     if args.init_cache:
         success &= init_cache()
-    
+
     if args.check_kicad:
         success &= check_kicad()
-    
-    if args.logs:
-        show_logs()
-    
+
+    if args.mcp_info:
+        show_mcp_info()
+
     sys.exit(0 if success else 1)
 
+
 if __name__ == "__main__":
-    main()
+    main()