Behold the magic of the next-gen of the OSS Swagger tooling, now with OpenAPI V3 support! Learn how we improved developer experience, making the tools even easier to use. With our enhanced infrastructure, you can make it your own - configure, customize and extend to suit your needs. This talk will cover what changed in our ecosystem and provide a glimpse of the roadmap ahead. Come and get a demo of what the future of Swagger and OpenAPIV3 looks like!
5. - Code-first approach
- Java JAX-RS
- Basis for other projects (annotations, models)
- OAS3 (swagger-core 2.0):
- Rewrite of annotations and models
- Cleanup of set up process
- Built to co-exist with 1.5
- Support utility for deserializingOpenAPIdocuments
- Depends on Swagger-core’s models.
- OAS3 (swagger-parser 2.0):
- Convert previous versions to 3.0
- Provides 3.0 validation
- More customizable with options
Swagger-core Swagger-parser
6. - Design-first approach
- Java JAX-RS (Jersey)
- Depends on Swagger-parser
- OAS3 (swagger-inflector 2.0):
- Modified for OAS3 support (*)
- Plans to co-exist with OAS2 support
- Improved mocking capabilities
- Client/Server generation
- Depends on Swagger-parser
- Available as a library, CLI and a service
- WIP Changes (swagger-codegen3.0):
- Support for 3.0 versions and older (through
conversion)
- Moving to handlebars
- Improved CLI
- Breaking out the templates
- And more…
Swagger-inflector Swagger-codegen
7. - Definition validation
- Runs as a service
- Depends on Swagger-parser
- OAS3 (validator-badge 2.0):
- Modified for OAS3 support (*)
- Plans to co-exist with OAS2 support
- New and improved API
- OAS2àOAS3 conversion
- Runs as a service
- Depends on Swagger-parser
- WIP (swagger-converter 1.0):
- Pushing out the first version
Validator-badge Swagger-converter
8. - Parser, resolver, client
- Was recently written from scratch (prior to OAS3)
- OAS3 (swagger-client 3.X):
- Parse and resolve OAS3 documents
- Client functionality partially implemented,
still WIP.
- Visualization
- Depends on Swagger-js
- Uses the Validator-badge
- Swagger-UI 3.X:
- Was recently written from scratch
- Provides easier customization
- Improved performance and visuals
- OAS3:
- Support for rendering OAS3 documents (*)
- Exciting plans for links
- Sandbox functionality is still WIP
Swagger-js Swagger-UI
9. - OAS IDE
- Depends on Swagger-UI
- Uses Swagger-codegen
- Swagger-Editor 3.X:
- Was recently written from scratch
- Provides easier customization
- Improved auto-suggest
- Improved validation
- OAS3:
- Supports OAS3 completion
- OAS3 structural validation
- Semantic validation is WIP
- Design-first approach
- Plans:
- Provide support for OAS3 based on
swagger-js
- Break the dependency on Editor/UI
- Implement similar features to Swagger-
Inflector
Swagger-Editor Swagger-node