Initial release of the oVirt/RHV Engine API simulator.

Stateful FastAPI lab with contract packs, Compose/Helm, Docker Hub release targets, and Pulumi coverage across all Engine series (GET/POST/PUT/DELETE/HEAD).
2026-07-18 04:49:28 +03:00
commit cbd0adca91
218 changed files with 246804 additions and 0 deletions
@@ -0,0 +1,39 @@
+**Language / Язык:** [English](README.md) | [Русский](README.ru.md)
+
+# oVirt Pulumi contract-coverage lab
+
+Pulumi Automation API suite that exercises **every operation** declared in
+`contracts/ovirt/<series>/api.json` across **all Engine series packs**, plus a
+**synthetic HEAD** request for each GET path (contracts omit HEAD; the Engine
+accepts it).
+
+| Series | Ops (approx.) |
+|--------|--------------:|
+| 3.0–3.6, 4.3–4.5, master | ~9 150 total executions (contract ops + HEAD) |
+
+```bash
+make test-pulumi-smoke   # 3.6 + 4.5 sample (fast)
+make pulumi-tests        # full matrix (alias: make test-pulumi)
+```
+
+Reports (written under `reports/`):
+
+- `pulumi-contract-coverage.html` — human-readable summary (includes methods histogram)
+- `pulumi-contract-coverage.json` — machine-readable results
+
+Optional filters:
+
+```bash
+OVIRT_SERIES_FILTER=4.5,3.6 make pulumi-tests
+OVIRT_METHODS_FILTER=GET make pulumi-tests
+SMOKE_ONLY=1 make test-pulumi-smoke
+```
+
+All suites run **only in Docker**. Pass criteria:
+
+- The Engine route is reachable and returns a handled status (`200`/`201`/`202`/`204`,
+  `400`/`403`/`404`/`405`/`409`/`415`/`422`/`501`) — **not** `401` (the suite
+  re-authenticates after each series unload) and not a transport/`5xx` failure.
+- For `200`/`201`/`202` the response body must be non-empty (HEAD exempt).
+- Full runs must exercise **GET, POST, PUT, DELETE, and HEAD**; any failures or
+  missing methods fail the suite.