|
1 |
| -# OpenAPI Typescript Codegen |
| 1 | +# Why The Fork? |
2 | 2 |
|
3 |
| -> Node.js library that generates Typescript clients based on the OpenAPI specification. |
| 3 | +Mainly, it's because the original project maintainer [doesn't have time](https://github.com/ferdikoomen/openapi-typescript-codegen/issues/1276#issuecomment-1302392146) to support the project. We wanted to keep the development going since this library became incompatible with [FastAPI v0.99.0 release](https://fastapi.tiangolo.com/release-notes/#0990) that introduced support for OpenAPI v3.1. While that was the main objective, this fork also offers other features such as: |
4 | 4 |
|
5 |
| -This Repo is a fork of the original codebase that was created to support OpenAPI spec v3.1. The original motivation was to be able to support schema generated by [FastAPI](https://fastapi.tiangolo.com/) versions 0.100 and above. |
| 5 | +- correct handling of 204 response status codes |
| 6 | +- ability to select which services to export and naming strategies for generated methods |
| 7 | +- support for non-ASCII characters |
| 8 | +- support for x-body-name header (compatible with Connexion v3.x) |
6 | 9 |
|
| 10 | +# OpenAPI Typescript Codegen |
| 11 | + |
| 12 | +> Node.js library that generates Typescript clients based on the OpenAPI specification. |
7 | 13 |
|
8 | 14 | ## Why?
|
9 |
| -- Frontend ❤️ OpenAPI, but we do not want to use JAVA codegen in our builds |
| 15 | +- Frontend ❤️ OpenAPI, but we do not want to use Java codegen in our builds |
10 | 16 | - Quick, lightweight, robust and framework-agnostic 🚀
|
11 | 17 | - Supports generation of TypeScript clients
|
12 | 18 | - Supports generations of Fetch, Node-Fetch, Axios, Angular and XHR http clients
|
13 |
| -- Supports OpenAPI specification v2.0 and v3.0 |
14 |
| -- Partial support of OpenAPI specification v3.1 |
| 19 | +- Supports OpenAPI specification v2.0 and v3.0 (v3.1 is partially supported) |
15 | 20 | - Supports JSON and YAML files for input
|
16 |
| -- Supports generation through CLI, Node.js and NPX |
| 21 | +- Supports generation through CLI, Node.js and npx |
17 | 22 | - Supports tsc and @babel/plugin-transform-typescript
|
18 | 23 | - Supports aborting of requests (cancelable promise pattern)
|
19 | 24 | - Supports external references using [json-schema-ref-parser](https://github.com/APIDevTools/json-schema-ref-parser/)
|
20 | 25 |
|
21 | 26 | ## Install
|
22 | 27 |
|
23 | 28 | ```
|
24 |
| -npm install openapi-typescript-codegen --save-dev |
| 29 | +npm install @nicolas-chaulet/openapi-typescript-codegen --save-dev |
| 30 | +``` |
| 31 | + |
| 32 | +or |
| 33 | + |
| 34 | +``` |
| 35 | +yarn add -D @nicolas-chaulet/openapi-typescript-codegen |
25 | 36 | ```
|
26 | 37 |
|
27 | 38 | ## Usage
|
@@ -57,5 +68,5 @@ $ openapi --help
|
57 | 68 | Documentation
|
58 | 69 | ===
|
59 | 70 |
|
60 |
| -The main documentation can be found in the [openapi-typescript-codegen/wiki](https://github.com/ferdikoomen/openapi-typescript-codegen/wiki) |
| 71 | +The original documentation can be found in the [openapi-typescript-codegen/wiki](https://github.com/ferdikoomen/openapi-typescript-codegen/wiki) |
61 | 72 |
|
0 commit comments