#codegen

Articles tagged with #codegen

readOnly and writeOnly in OpenAPI: one schema for create, response, and password fields
The server returns id, created_at, and version but must reject them on input; the client sends password and current_password that must never come back. One schema with readOnly and writeOnly properties models both directions and codegen splits it into request and response types a
Oct 8, 20266 min read
OpenAPI additionalProperties: modeling maps, dictionaries, labels, and free-form objects without losing types
A JSON object is sometimes a fixed record, sometimes a Map<string, T> of arbitrary keys, and sometimes genuinely free-form. Use additionalProperties for dictionaries, properties plus additionalProperties:false for strict records, and an empty object for anything-goes payloa
Oct 8, 20266 min read
operationId and tags in OpenAPI: naming conventions that keep generated SDKs and docs usable
operationId becomes the method name in every generated SDK and tags become the namespace and the docs sidebar, yet most specs treat both as afterthoughts. Duplicate ids, verb-first names, and a unique tag per endpoint produce unusable clients and a wall of operations. Here is a n
Oct 8, 20267 min read
The JSON Schema constraints that actually work in OpenAPI: format, pattern, ranges, and what codegen and AI mocks do with them
Which JSON Schema keywords become types, which are enforced at runtime, and which are only annotations? Here is how format, pattern, ranges, required, and nullability flow into codegen, validators, mocks, and AI-generated test data.
Oct 7, 20267 min read

#codegen - Powerduck Blogs