Skip to main content

Module overlay

Module overlay 

Source
Expand description

OpenAPI Overlay 1.1 preprocessing using RFC 9535 JSONPath.

Extensions retain their existing project-specific merge rules and are applied first. Overlay files and actions run in declaration order. extends is target identity metadata, never a request to load another document. Each action snapshots its target locations and copy source before mutation. Repeated selections affect a location once; overlapping locations are processed from deepest to shallowest, with descending array indices for removal. All valid 1.1.<numeric patch> versions share the Overlay 1.1 behavior.

Functionsยง

apply_overlay
Apply one JSON or YAML-decoded Overlay document in memory.
effective_spec_json
Deterministic JSON materialization of the effective document.
preprocess_spec
Build the effective document before validation, defaults, or analysis.
validate_artifact_path
Validate an artifact filename relative to the output directory.