Initial commit: Vultr API v2 Python wrapper with FastAPI server

- vultr_api/: Python library wrapping Vultr API v2
  - 17 resource modules (instances, dns, firewall, vpc, etc.)
  - Pagination support, error handling

- server/: FastAPI REST server
  - All API endpoints exposed via HTTP
  - X-API-Key header authentication
  - Swagger docs at /docs

- Podman quadlet config for systemd deployment

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

server/routers/load_balancers.py

@@ -0,0 +1,108 @@
+"""Load Balancers router"""
+from fastapi import APIRouter, Depends, Query
+from typing import Optional, List
+from pydantic import BaseModel
+
+from vultr_api import VultrClient
+from deps import get_client
+
+router = APIRouter()
+
+
+class ForwardingRule(BaseModel):
+    frontend_protocol: str
+    frontend_port: int
+    backend_protocol: str
+    backend_port: int
+
+
+class HealthCheck(BaseModel):
+    protocol: str
+    port: int
+    path: Optional[str] = None
+    check_interval: Optional[int] = None
+    response_timeout: Optional[int] = None
+    unhealthy_threshold: Optional[int] = None
+    healthy_threshold: Optional[int] = None
+
+
+class CreateLoadBalancerRequest(BaseModel):
+    region: str
+    label: Optional[str] = None
+    balancing_algorithm: Optional[str] = None  # roundrobin or leastconn
+    forwarding_rules: Optional[List[ForwardingRule]] = None
+    health_check: Optional[HealthCheck] = None
+    instances: Optional[List[str]] = None
+    ssl_redirect: Optional[bool] = None
+    proxy_protocol: Optional[bool] = None
+
+
+class UpdateLoadBalancerRequest(BaseModel):
+    label: Optional[str] = None
+    balancing_algorithm: Optional[str] = None
+    ssl_redirect: Optional[bool] = None
+    proxy_protocol: Optional[bool] = None
+
+
+@router.get("")
+async def list_load_balancers(
+    per_page: int = Query(25, le=500),
+    cursor: Optional[str] = None,
+    client: VultrClient = Depends(get_client)
+):
+    """List all load balancers"""
+    return client.load_balancers.list(per_page=per_page, cursor=cursor)
+
+
+@router.get("/all")
+async def list_all_load_balancers(client: VultrClient = Depends(get_client)):
+    """List all load balancers (auto-paginated)"""
+    return {"load_balancers": client.load_balancers.list_all()}
+
+
+@router.get("/{lb_id}")
+async def get_load_balancer(lb_id: str, client: VultrClient = Depends(get_client)):
+    """Get load balancer details"""
+    return client.load_balancers.get(lb_id)
+
+
+@router.post("")
+async def create_load_balancer(req: CreateLoadBalancerRequest, client: VultrClient = Depends(get_client)):
+    """Create a load balancer"""
+    data = req.model_dump(exclude_none=True)
+    if 'forwarding_rules' in data:
+        data['forwarding_rules'] = [r for r in data['forwarding_rules']]
+    if 'health_check' in data:
+        data['health_check'] = dict(data['health_check'])
+    return client.load_balancers.create(**data)
+
+
+@router.patch("/{lb_id}")
+async def update_load_balancer(lb_id: str, req: UpdateLoadBalancerRequest, client: VultrClient = Depends(get_client)):
+    """Update a load balancer"""
+    return client.load_balancers.update(lb_id, **req.model_dump(exclude_none=True))
+
+
+@router.delete("/{lb_id}")
+async def delete_load_balancer(lb_id: str, client: VultrClient = Depends(get_client)):
+    """Delete a load balancer"""
+    return client.load_balancers.delete(lb_id)
+
+
+# Forwarding rules
+@router.get("/{lb_id}/forwarding-rules")
+async def list_forwarding_rules(lb_id: str, client: VultrClient = Depends(get_client)):
+    """List forwarding rules for a load balancer"""
+    return client.load_balancers.list_forwarding_rules(lb_id)
+
+
+@router.post("/{lb_id}/forwarding-rules")
+async def create_forwarding_rule(lb_id: str, req: ForwardingRule, client: VultrClient = Depends(get_client)):
+    """Create a forwarding rule"""
+    return client.load_balancers.create_forwarding_rule(lb_id, **req.model_dump())
+
+
+@router.delete("/{lb_id}/forwarding-rules/{rule_id}")
+async def delete_forwarding_rule(lb_id: str, rule_id: str, client: VultrClient = Depends(get_client)):
+    """Delete a forwarding rule"""
+    return client.load_balancers.delete_forwarding_rule(lb_id, rule_id)