Expand description
OpenAPI spec generation from a ServiceManifest.
This module is used by both the platform (server-side) and the CLI (local generation without deployment).
Structs§
- Open
ApiError - A manifest whose docs cannot form a spec.
Enums§
- Path
Style - Where a spec’s paths are rooted.
Functions§
- default_
style - Server-relative once the service documents itself (
openapioptions or any routedoc), absolute otherwise. - generate_
openapi - The service’s OpenAPI 3.1 document.
- service_
spec - The spec a deployed or local service is served with: in its
default_style. - validate
- Check a documented manifest: operation ids unique across its published
custom and CRUD operations, no two published routes documenting the same
method and path,
path = Tnaming exactly the route’s path parameters, query and path parameters that are scalars or arrays, security schemes the document defines, and no DTO sharing a table schema’s name. An undocumented manifest passes: its spec is today’s.