kcl-lang / kcl-openapi / 33054453119

64%

Build Type

push

github

Committed by web-flow

Commit Message

feat: support OpenAPI 3.0/3.1 specs (closes #35) (#162)

Add detection + lowering pipeline for OpenAPI 3.x without ripping
out the existing go-openapi/loads path:

- detectOpenAPI3 peeks at the file header and reports whether the
  spec declares itself as 3.x. Detection accepts both YAML
  ("openapi: 3.x") and JSON ("openapi":"3.x"), and runs against
  both the raw header (catches JSON-form where the version is
  inside a quoted string) and a stripped version (avoids false
  positives from "# openapi: 3.x" comments in YAML).
- loadOpenAPI3 parses the 3.x doc with kin-openapi, lowers it to
  Swagger 2.0 via openapi2conv.FromV3, and writes the lowered
  doc to a temp JSON file that loads.Spec can pick up. We can't
  bypass loads.Spec because it's what sets specFilePath used
  later for $ref resolution.
- ensurePathsField re-injects "paths": {} after marshaling the
  lowered doc. Swagger 2.0 requires the paths field even when
  empty, but kin-openapi's openapi2.Swagger tags it omitempty.
- spec.go loadSpec() routes 3.x through loadOpenAPI3 and falls
  through to loads.Spec for 2.0 (unchanged behavior).

Tested via the existing TestGenerate_OAI2KCL runner (added an
openapi3_basic integration fixture) plus unit tests for the
detection helpers.

Signed-off-by: Claude <timi@noreply.anthropic.com>
Co-authored-by: Claude <timi@noreply.anthropic.com>

Coverage Stats

130 of 154 new or added lines in 2 files covered. (84.42%)

132 existing lines in 1 file now uncovered.

2591 of 3836 relevant lines covered (67.54%)

1.48 hits per line