elasticio / odata2openapi

OData to OpenAPI Converter
https://www.elastic.io
MIT License
34 stars 23 forks source link

OpenAPI v3.1 support #48

Open philsturgeon opened 2 years ago

philsturgeon commented 2 years ago

Thanks for making this excellent package. I wanted to make a quick issue to track the progress towards supporting OpenAPI v3.1, because it's been out for over a year now and it's excellent. It adds a lot of convenient functionality and lines up perfectly with JSON Schema, which could actually simplify your toolchain rather well as you can just use any of the vast amounts of JSON Schema tooling instead of the subset of tooling which understands what an OpenAPI Schema object.

Here's a guide to the differences written for end-users, but it should help make things fairly clear to tooling vendors like yourself.

https://www.openapis.org/blog/2021/02/16/migrating-from-openapi-3-0-to-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 need any help with the upgrade process.

jhorbulyk commented 2 years ago

If you say you'll be working on it ...

We aren't currently working on it at the moment.

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

If you want to contribute a PR, we can look at it.

philsturgeon commented 2 years ago

@jhorbulyk I do wish I had time to go through every single OpenAPI tool on https://openapi.tools and do all of the work of upgrading them all, but that's a bit of a tall order. This issue is not saying hurry up, it's tracking the progress. 👍🏻

when you are working on 3.1 support in the future, let me know if you get stuck or need examples, etc. There's some over here for now: https://github.com/Mermade/openapi3-examples/tree/master/3.1