search

spec-first / connexion

Connexion is a modern Python web framework that makes spec-first and api-first development easy.
https://connexion.readthedocs.io/en/latest/
Apache License 2.0
4.48k stars 761 forks source link

OpenAPI Specification 3.1 #1396

Open danielbraun89 opened 3 years ago

danielbraun89 commented 3 years ago

Description

Now that OpenApi version 3.1 has been officially released (along with the lucrative JsonSchema integration) is there any plan to support it in the near future?

hjacobs commented 3 years ago

I haven't checked it out, but this would be something which can be discussed as part of the Connexion 3.0 roadmap (#1395).

M-Reimer commented 3 years ago

I would say this one is blocked by https://github.com/swagger-api/swagger-ui/issues/5891 At least if the resulting API is meant to be documented using Swagger UI.

Ruwann commented 3 years ago

It might also depend on https://github.com/Julian/jsonschema/issues/782 / https://github.com/Julian/jsonschema/pull/817, given the full alignment of OpenAPI 3.1.0 with JSON Schema draft 2020-12.

tomghyselinck commented 3 years ago

There may also be required changes in https://github.com/p1c2u/openapi-spec-validator. For example https://github.com/p1c2u/openapi-spec-validator/pull/111 (which is based on a draft of OpenAPI spec 3.1).

pjungermann commented 10 months ago

it seems like both mentioned dependencies were completed

saper commented 10 months ago

Yes, maybe also the bundled SwaggerUI needs to be updated to 5.x supporting OpenAPI 3.1.0

chbndrhnns commented 7 months ago

Is it possible for the maintainers to explain their vision for support of OpenAPI 3.1?

el2857 commented 6 months ago

Do the maintainers know what changes would be necessary to support OpenAPI 3.1 and/or would be open to collaborating on making those changes?

RobbeSneyders commented 6 months ago

I do not have a good view of what would be needed to support OpenAPI 3.1.

We have a Specification class which has an implementation for Swagger 2 and OpenAPI 3. A good starting point would be to provide an implementation for OpenAPI 3.1 and check if additional changes are needed.

This would be welcomed as a contribution.