Fully support OAS 3.1 - Githubissues

nfroidure / whook

Build strong and efficient REST web services.

https://slides.com/nfroidure/introducing-whook

MIT License

30 stars 7 forks source link

Fully support OAS 3.1 #79

Open nfroidure opened 4 years ago

nfroidure commented 4 years ago

OAS 3.1 brings support for a lot a new features, especially JSON Schema full support (patternProperties 🙏). https://www.openapis.org/blog/2020/06/18/openapi-3-1-0-rc0-its-here

Here is a todo list to complete in order to ship OAS 3.1 support:

[x] Update the OpenAPI type generator to support patternProperties https://github.com/horiuchi/dtsgenerator/issues/435
[ ] webhooks
[ ] runtime expressions : https://spec.openapis.org/oas/v3.1.0#runtime-expressions
[ ] reusable examples
[x] upgrade or substitute @apidevtools/swagger-parser (see https://github.com/APIDevTools/swagger-parser/issues/169 )
[x] upgrade swagger-ui ( see https://github.com/swagger-api/swagger-ui/issues/5891 )
[x] use OAS3.1 types (import OpenAPIV3_1 instead of OpenAPIV3 from https://github.com/kogosoftwarellc/open-api/tree/master/packages/openapi-types )
[x] update schema validator ( https://github.com/kogosoftwarellc/open-api/issues/837 )

nfroidure commented 3 years ago

Finally created https://github.com/nfroidure/schema2dts. Till have to check 3.1 features and implement it.

nfroidure commented 3 months ago

The schema validator may be changed for https://github.com/IBM/openapi-validator/issues/545 to move forward on this long running issue.