Validate OpenAPI file

[ahx]

Being able to (optionally) validate the structure of a given OpenAPI file would be handy.

Solution idea:

Make use of the meta schemas included in json_schemer

[jan-bw]

hi, I am wondering whether this makes sense to add this as a separate feature :)

it's fairly straightforward to validate you openapi file in the specs and I think we shouldn't validate it on runtime because that would be inefficient. an example spec in rspec I have is:

RSpec.describe "docs/openapi.yaml schema" do
  it "has correct structure" do
    schemer = JSONSchemer.openapi(
      YAML.load_file(
        Rails.root.join("docs/openapi.yaml")
      )
    )

    expect(schemer.validate.to_a).to eq([])
  end
end

what do you think? :)

[ahx]

Hey. I totally agree. I was thinking about adding a shortcut to the json_schemer validation or something that is called in tests only.

Thanks for the feedback on this. @jan-bw
Maybe we just skip this.

[ahx]

Closing this as not planned right now.