inecs
f8d3cbdd59
Add the FastAPI app, PostgreSQL migrations, Docker/Helm packaging, API contracts, docs, client examples, and the unit/integration/compatibility test suite for local client and tooling labs without a real vCenter.
102 lines
3.3 KiB
Python
102 lines
3.3 KiB
Python
"""Contract-driven route registry tests."""
|
|
|
|
from datetime import UTC, datetime
|
|
from pathlib import Path
|
|
from typing import Any
|
|
|
|
import pytest
|
|
from fastapi import Request
|
|
from httpx import ASGITransport, AsyncClient
|
|
from pydantic import ValidationError
|
|
|
|
from app.api.registry import HandlerRegistry, RouteCollisionError
|
|
from app.config import Settings
|
|
from app.contracts.model import Method, PathContract, Schema, Snapshot
|
|
from app.main import create_app
|
|
from tests.unit.test_health import FakeDatabase
|
|
|
|
pytestmark = pytest.mark.pve_stub
|
|
|
|
|
|
def contract_snapshot(*methods: Method) -> Snapshot:
|
|
paths = (PathContract(path="/version", methods=methods),)
|
|
return Snapshot(
|
|
source_version="test",
|
|
retrieved_at=datetime(2026, 1, 1, tzinfo=UTC),
|
|
raw_sha256="0" * 64,
|
|
paths=paths,
|
|
path_count=1,
|
|
method_count=len(methods),
|
|
)
|
|
|
|
|
|
def get_method() -> Method:
|
|
return Method(
|
|
verb="GET",
|
|
name="version",
|
|
returns=Schema(type="object", properties={"version": Schema(type="string")}),
|
|
checksum="1" * 64,
|
|
)
|
|
|
|
|
|
async def request_app(
|
|
tmp_path: Path, fallback: str, handlers: HandlerRegistry | None = None
|
|
) -> tuple[dict[str, Any], dict[str, Any]]:
|
|
snapshot_path = tmp_path / "snapshot.json"
|
|
snapshot_path.write_bytes(contract_snapshot(get_method()).canonical_bytes())
|
|
settings = Settings(
|
|
contract_snapshot=snapshot_path,
|
|
contract_fallback=fallback,
|
|
compatibility_evidence=None,
|
|
)
|
|
database = FakeDatabase(True)
|
|
app = create_app(
|
|
settings,
|
|
lambda _settings: database,
|
|
handlers if handlers is not None else HandlerRegistry(),
|
|
worker_factories=(),
|
|
)
|
|
async with app.router.lifespan_context(app):
|
|
async with AsyncClient(transport=ASGITransport(app=app), base_url="http://test") as client:
|
|
json_response = await client.get("/api2/json/version")
|
|
extjs_response = await client.get("/api2/extjs/version")
|
|
return json_response.json(), extjs_response.json()
|
|
|
|
|
|
async def test_registered_handler_serves_both_renderers(tmp_path: Path) -> None:
|
|
handlers = HandlerRegistry()
|
|
|
|
async def version(_request: Request, _inputs: dict[str, Any]) -> dict[str, str]:
|
|
return {"version": "9.2.3"}
|
|
|
|
handlers.register("/version", "GET", version)
|
|
|
|
json_body, extjs_body = await request_app(tmp_path, "error", handlers)
|
|
|
|
assert json_body == {"data": {"version": "9.2.3"}}
|
|
assert extjs_body == {"data": {"version": "9.2.3"}, "success": True}
|
|
|
|
|
|
async def test_explicit_fallback_modes(tmp_path: Path) -> None:
|
|
error_body, _ = await request_app(tmp_path, "error")
|
|
default_body, _ = await request_app(tmp_path, "schema-default")
|
|
|
|
assert error_body["errors"] == "handler pending for this contract method"
|
|
assert default_body["data"]["version"] in {None, "example"}
|
|
|
|
|
|
def test_duplicate_snapshot_routes_are_rejected() -> None:
|
|
with pytest.raises(ValidationError, match="duplicate"):
|
|
contract_snapshot(get_method(), get_method())
|
|
|
|
|
|
def test_duplicate_semantic_handlers_are_rejected() -> None:
|
|
handlers = HandlerRegistry()
|
|
|
|
async def handler(_request: Request, _inputs: dict[str, Any]) -> None:
|
|
return None
|
|
|
|
handlers.register("/version", "GET", handler)
|
|
with pytest.raises(RouteCollisionError, match="duplicate"):
|
|
handlers.register("/version", "GET", handler)
|