Skip to content
This repository was archived by the owner on May 30, 2022. It is now read-only.

Commit 28d1cfc

Browse files
authored
Merge branch 'OpenAPI.next' into patch-2
2 parents 49f9985 + 1b9a5c1 commit 28d1cfc

File tree

3 files changed

+259
-127
lines changed

3 files changed

+259
-127
lines changed

IMPLEMENTATIONS.md

Lines changed: 39 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,39 @@
1+
### Implementations
2+
3+
Below is a list of known tooling implementing the 3.0.0 specification. Because
4+
the 3.0.0 specification has not yet been released, please consult the details of
5+
any projects listed below for notes about stability and roadmap. The process
6+
to create the best possible 3.0.0 specification includes feedback from end-users
7+
and tooling creators alike, and it is strongly encouraged that draft tooling be
8+
made available for early users of the OAS.
9+
10+
These tools are not necessarily endorsed by the OAI.
11+
12+
#### Low-Level tooling
13+
14+
| Title | Project Link | Language |Description |
15+
|----------------|--------------|----------|---------------------|
16+
| swagger-parser | [GitHub/swagger-api](https://github.com/swagger-api/swagger-parser/tree/feature/3.0.0-rc0) | Java | Swagger 1.0, 1.1, 1.2, 2.0 to Open API Specification converter |
17+
| swagger-models | [GitHub/swagger-api](https://github.com/swagger-api/swagger-core/tree/feature/3.0.0-rc0/modules/swagger-models) | Java | Open API 3.0 Java Pojos |
18+
| KaiZen OpenAPI Parser | [GitHub/RepreZen/KaiZen-OpenAPI-Parser](https://github.com/RepreZen/KaiZen-OpenAPI-Parser) | Java | High-performance Parser, Validator, and Java Object Model for OpenAPI 3.x |
19+
| openapi3-ts | [GitHub/metadevpro/openapi3-ts](https://github.com/metadevpro/openapi3-ts) | TypeScript | TS Model & utils for OpenAPI 3.0.x contracts |
20+
| swagger2openapi | [GitHub/mermade/swagger2openapi](https://github.com/mermade/swagger2openapi) | Node.js | An OpenAPI / Swagger 2.0 to OpenAPI 3.0.x converter and validator |
21+
| Tavis.OpenApi | [GitHub/tavis-sofware/Tavis.OpenApi](https://github.com/tavis-software/Tavis.OpenApi/) | dotnet | C# based parser with definition validation and migration support from V2 |
22+
23+
24+
#### User Interfaces
25+
26+
| Title | Project Link | Language |Description |
27+
|----------------|--------------|----------|---------------------|
28+
| openapi-viewer | [GitHub/koumoul/openapi-viewer](https://github.com/koumoul-dev/openapi-viewer) | Vue.js | Browse and test a REST API described with the OpenAPI 3.0 Specification |
29+
30+
31+
#### Server Implementations
32+
33+
34+
#### Code Generators
35+
36+
| Title | Project Link | Language |Description |
37+
|----------------|--------------|----------|---------------------|
38+
| baucis-openapi3 | [Github/metadevpro/baucis-openapi3](https://github.com/metadevpro/baucis-openapi3) | Node.js | [Baucis.js](https://github.com/wprl/baucis) plugin for generating OpenAPI 3.0 compliant API contracts |
39+
| Google Gnostic | [GitHub/googleapis/gnostic](https://github.com/googleapis/gnostic) | Go | Compile OpenAPI descriptions into equivalent Protocol Buffer representations |

README.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,9 @@
11
# The OpenAPI Specification
22

3+
### Draft implementations of tooling supporting the 3.0.0 specification can be found here!
4+
5+
[3.0.0 Implementations](https://github.com/OAI/OpenAPI-Specification/blob/OpenAPI.next/IMPLEMENTATIONS.md)
6+
37
This is the working branch for the next version of the OpenAPI Specification. You can read more about the Open API Initiative (OAI) at [https://openapis.org](https://openapis.org).
48

59
The current, released version of the OpenAPI Specification is 2.0, through donation of the Swagger Specification to the OAI by SmartBear Software. If you are interested in the release specification, please see the [master branch](https://github.com/OAI/OpenAPI-Specification/blob/master/README.md) of this project.

0 commit comments

Comments
 (0)