openapi-python-client icon indicating copy to clipboard operation
openapi-python-client copied to clipboard

update to OpenAPI 3.1.x

Open deanurce opened this issue 3 years ago • 2 comments

Im trying to upgrade to openapi 3.1.0 to be able to use type: mutualTLS in the security scheme definition, and it throws an error that the version is not recognised. Since the 3.1.0 upgrade has been around for quite some time, will it be supported anytime soon?

Screenshot of error below. image

deanurce avatar Feb 07 '22 11:02 deanurce

Actually supporting the features of 3.1.0 is probably a long way off since there are still 3.0 features incomplete 😬.

Reading the spec and just handling any breaking changes for the 3.0 features we do support is probably relatively easy, just a time investment.

I'm unlikely to have the time to do that anytime soon, but would welcome a PR from someone who does.

dbanty avatar Feb 07 '22 15:02 dbanty

The changes are not too major, just moving in line with JSON Schema for the schema objects and a few simplifications to examples. https://www.openapis.org/blog/2021/02/16/migrating-from-openapi-3-0-to-3-1-0

philsturgeon avatar Apr 08 '22 12:04 philsturgeon