Merge pull request #10 from livenson/claude/add-octavia-emulation-014nusUMpLNJZv5jWaUjCaE3

Add Octavia emulation support

Author: livenson

CLAUDE.md

@@ -222,9 +222,9 @@ pytest tests/test_<service>.py -v
 
 ## Pre-commit Requirements
 
-**IMPORTANT: You MUST run the black linter and ensure it passes before committing any code.**
+**IMPORTANT: You MUST run all linters and ensure they pass before committing any code.**
 
-### Black Linter
+### Black Formatter
 
 All Python code must be formatted with black before committing. This is a strict requirement - commits with unformatted code are not acceptable.
 
@@ -239,17 +239,43 @@ black .
 black emulator/ tests/
 ```
 
+### Ruff Linter
+
+All Python code must pass ruff linting checks. Ruff catches common errors and enforces code quality standards.
+
+```bash
+# Check for linting errors
+ruff check emulator tests
+
+# Auto-fix some issues (where possible)
+ruff check --fix emulator tests
+```
+
+Common ruff issues to avoid:
+- **E741**: Ambiguous variable names (e.g., use `listener` instead of `l`)
+- **F841**: Unused variables (remove or use them)
+
+### Mypy Type Checker
+
+All Python code must pass mypy type checking.
+
+```bash
+# Run mypy type checker
+mypy emulator --ignore-missing-imports
+```
+
 ### Pre-commit Checklist
 
-Before every commit, you MUST:
+Before every commit, you MUST run these commands in order:
 
-1. **Run black formatter**: `black .`
-2. **Verify formatting passes**: `black --check .`
-3. **Run tests**: `pytest`
+1. **Run black formatter**: `black emulator tests`
+2. **Run ruff linter**: `ruff check emulator tests`
+3. **Run mypy type checker**: `mypy emulator --ignore-missing-imports`
+4. **Run tests**: `pytest`
 
-If `black --check .` reports any formatting issues, run `black .` to fix them before committing.
+All four checks must pass before committing. Fix any errors before proceeding.
 
-**DO NOT commit code that fails black formatting checks. This is mandatory.**
+**DO NOT commit code that fails any of these checks. This is mandatory.**
 
 ## Patterns and Best Practices
 

emulator/__init__.py

@@ -18,6 +18,7 @@
     "cinder": 8776,
     "glance": 9292,
     "neutron": 9696,
+    "octavia": 9876,
     "status": 10000,
 }
 
@@ -27,6 +28,7 @@
     "cinder": "emulator.api.app_cinder:app",
     "glance": "emulator.api.app_glance:app",
     "neutron": "emulator.api.app_neutron:app",
+    "octavia": "emulator.api.app_octavia:app",
     "status": "emulator.api.app_status:app",
 }
 
@@ -61,6 +63,7 @@ def run_all_services(host: str, port_offset: int = 0) -> None:
     print(f"  - Cinder (Block Storage):  http://{host}:{ports['cinder']}")
     print(f"  - Glance (Image):          http://{host}:{ports['glance']}")
     print(f"  - Neutron (Network):       http://{host}:{ports['neutron']}")
+    print(f"  - Octavia (Load Balancer): http://{host}:{ports['octavia']}")
     print(f"  - Status (Web UI):         http://{host}:{ports['status']}")
     print("\nPress Ctrl+C to stop all services.\n")
 
@@ -100,10 +103,10 @@ def main() -> None:
     )
     parser.add_argument(
         "--service",
-        choices=["keystone", "nova", "cinder", "glance", "neutron", "status", "all"],
+        choices=["keystone", "nova", "cinder", "glance", "neutron", "octavia", "status", "all"],
         default="all",
         help="Service to run: keystone (5000), nova (8774), cinder (8776), "
-        "glance (9292), neutron (9696), status (10000), or all (default: all)",
+        "glance (9292), neutron (9696), octavia (9876), status (10000), or all (default: all)",
     )
     parser.add_argument(
         "--port-offset",

emulator/api/app_octavia.py

@@ -0,0 +1,53 @@
+"""Octavia Load Balancer API application for OpenStack emulator.
+
+Runs on port 9876 (standard OpenStack Octavia port).
+"""
+
+from fastapi import FastAPI, Request
+from fastapi.middleware.cors import CORSMiddleware
+from fastapi.responses import JSONResponse
+
+from emulator.api.octavia import router as octavia_router
+
+app = FastAPI(
+    title="OpenStack Octavia Emulator",
+    description="A lightweight OpenStack Octavia (Load Balancer) API emulator",
+    version="0.1.0",
+    docs_url="/docs",
+    redoc_url="/redoc",
+)
+
+# Add CORS middleware for development
+app.add_middleware(
+    CORSMiddleware,
+    allow_origins=["*"],
+    allow_credentials=True,
+    allow_methods=["*"],
+    allow_headers=["*"],
+)
+
+
+# Custom exception handler for OpenStack-style errors
+@app.exception_handler(Exception)
+async def openstack_exception_handler(request: Request, exc: Exception) -> JSONResponse:
+    """Handle exceptions in OpenStack error format."""
+    return JSONResponse(
+        status_code=500,
+        content={
+            "error": {
+                "message": str(exc),
+                "code": 500,
+            }
+        },
+    )
+
+
+# Include Octavia router
+app.include_router(octavia_router)
+
+
+# Health check endpoint
+@app.get("/health")
+async def health_check() -> dict[str, str]:
+    """Health check endpoint."""
+    return {"status": "healthy", "service": "octavia"}