openapi-parser

To generate Drift tests from OpenAPI specs, parse the file to translate polymorphic oneOf, anyOf, allOf, and discriminator patterns into deterministic Drift test blocks. It resolves $ref references and enumerates viable response variants with appropriate datasets.

OpenAPI schema drift tests are automated test blocks generated from complex API schemas to validate contract adherence. You need them when your API uses polymorphic patterns like oneOf or anyOf, requiring deterministic variant enumeration to validate responses against the defined schema.

Handle OpenAPI discriminator and allOf patterns by parsing the spec to map schemas to Drift operations with explicit discriminator handling. The parser enumerates viable test variants across responses and outputs Drift operations YAML alongside optional dataset definitions.

Yes, the openapi-parser resolves $ref references when generating test cases. It traverses extensive $ref chains within the OpenAPI 3.x spec to accurately interpret polymorphic patterns and enumerate deterministic test variants for the Drift operations YAML output.

A limitation of generating Drift tests from OpenAPI 3.x specs is that certain viable variants may be intentionally omitted. The parser outputs notes identifying these gaps where specific polymorphic variants are excluded from the generated Drift operations YAML and datasets.