Sergey Antropoff
777926487b
initial QEMU slice, backed by imported contracts for majors 6–9. - Implement durable handlers for access/auth, cluster, LXC, storage, HA, firewall, Ceph, SDN, ACME, notifications, pools, mapping, and node ops - Serve an interactive Web UI with catalog browsing, demo seed controls, and OpenAPI/help surfaces - Bundle PVE 6.4-15, 7.4-16, and 8.4.5 contract revisions alongside 9.2.3 - Support in-memory runtime contract Apply (POST /ui/api/contract/apply) so /version and /api2 routes follow the selected major until restart - Expand seed profiles (including demo-cluster), migrations 007–008, TLS gateway config, Compose/Makefile tooling, and compatibility evidence - Tighten .gitignore for macOS, hidden directories (.*/), and local secrets
77 lines
2.3 KiB
Python
77 lines
2.3 KiB
Python
"""Generate example values from Proxmox contract schemas."""
|
|
|
|
from __future__ import annotations
|
|
|
|
from app.contracts.model import Schema
|
|
|
|
_PATH_PARAM_EXAMPLES: dict[str, object] = {
|
|
"node": "pve01",
|
|
"vmid": 100,
|
|
"storage": "local",
|
|
"pool": "testpool",
|
|
"userid": "root@pam",
|
|
"tokenid": "automation",
|
|
"realm": "pam",
|
|
"group": "admins",
|
|
"role": "Administrator",
|
|
"upid": "UPID:pve01:00000001:00000001:65000001:qmstart:100:root@pam:",
|
|
"snapname": "snap1",
|
|
"volume": "local:100/vm-100-disk-0.qcow2",
|
|
"disk": "scsi0",
|
|
"iface": "net0",
|
|
"key": "cpu",
|
|
"digest": "00000000",
|
|
"name": "example",
|
|
}
|
|
|
|
|
|
def path_param_example(name: str) -> object | None:
|
|
"""Return a realistic placeholder for a common Proxmox path parameter."""
|
|
|
|
return _PATH_PARAM_EXAMPLES.get(name)
|
|
|
|
|
|
def schema_example(schema: Schema, *, name: str | None = None) -> object:
|
|
"""Build a representative example value for a contract schema."""
|
|
|
|
if schema.default is not None:
|
|
return schema.default
|
|
if schema.enum:
|
|
return schema.enum[0]
|
|
if name is not None:
|
|
hinted = path_param_example(name)
|
|
if hinted is not None:
|
|
return hinted
|
|
if "[n]" in name:
|
|
indexed = name.replace("[n]", "0")
|
|
hinted = path_param_example(indexed.rstrip("0123456789"))
|
|
if hinted is not None:
|
|
return hinted
|
|
if schema.type == "array":
|
|
if schema.items is not None:
|
|
return [schema_example(schema.items)]
|
|
return []
|
|
if schema.type == "object":
|
|
return {
|
|
key: schema_example(definition, name=key)
|
|
for key, definition in schema.properties.items()
|
|
if not definition.optional
|
|
}
|
|
if schema.type == "boolean":
|
|
return False
|
|
if schema.type == "integer":
|
|
if schema.minimum is not None:
|
|
return int(schema.minimum)
|
|
return 1
|
|
if schema.type == "number":
|
|
if schema.minimum is not None:
|
|
return float(schema.minimum)
|
|
return 1.0
|
|
if schema.type == "string" or schema.type is None:
|
|
if schema.format == "email":
|
|
return "user@example.com"
|
|
if schema.format == "uri":
|
|
return "https://example.com"
|
|
return "example"
|
|
return None
|