whook icon indicating copy to clipboard operation
whook copied to clipboard

Fully support OAS 3.1

Open nfroidure opened this issue 5 years ago • 2 comments

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
  • [x] #187
  • [x] #188
  • [ ] 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 avatar Jul 26 '20 10:07 nfroidure

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

nfroidure avatar Dec 09 '20 09:12 nfroidure

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

nfroidure avatar May 12 '24 09:05 nfroidure