OpenAPI v3.1 Support

[philsturgeon]

Hello! As the maintainer of openapi.tools I'm interested in tracking progress towards supporting OpenAPI v3.1.

It's got a bunch of amazing changes in it, solving problems like the the JSON Schema <!=> OpenAPI Schema Object divergence, and fixes some other inconsistencies and duplicate ways of doing things. It's the best version and everyone should be using it, but we need tooling to catch up, and it's been over a year now. Just in case folks didn't notice, I'm here to give a friendly prod!

Here are a few articles showing off the differences between OpenAPI v3.0 and v3.1.

https://www.openapis.org/blog/2021/02/16/migrating-from-openapi-3-0-to-3-1-0
https://www.apimatic.io/blog/2021/09/migrating-to-and-from-openapi-3-1/
https://nordicapis.com/whats-new-in-openapi-3-1-0/

If you say you'll be working on it I can update openapi.tools to reflect that.

Let me know if you have any questions, or if you need any help with the upgrade process.

[galah92]

This is very much needed by me (as a user) as well.

[kobik]

Thanks for the info @philsturgeon, i'll definitely check that out.

[sdesalas]

FYI similar library express-openapi-validator is currently working on this: cdimascio/express-openapi-validator#882

[dash-xd]

@sdesalas the issue with https://github.com/cdimascio/express-openapi-validator/ is it is not actually a middleware, it requires the "app" object. i deploy modular express routers to an existing express application which i do not have control over. so i cannot wrap it with the cdimascio "middleware", i need my middleware at the router level.

cdimascio/express-openapi-validator#144

maybe they should rename that method from middleware to "topware" or "wrapware".