Skip to content

Commit efbfba5

Browse files
authored
Merge pull request ferdikoomen#17 from nicolas-chaulet/docs/readme
docs(readme): explain the fork
2 parents 8b7e5f6 + 494460c commit efbfba5

File tree

1 file changed

+20
-9
lines changed

1 file changed

+20
-9
lines changed

README.md

Lines changed: 20 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,27 +1,38 @@
1-
# OpenAPI Typescript Codegen
1+
# Why The Fork?
22

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:
44

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)
69

10+
# OpenAPI Typescript Codegen
11+
12+
> Node.js library that generates Typescript clients based on the OpenAPI specification.
713
814
## 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
1016
- Quick, lightweight, robust and framework-agnostic 🚀
1117
- Supports generation of TypeScript clients
1218
- 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)
1520
- 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
1722
- Supports tsc and @babel/plugin-transform-typescript
1823
- Supports aborting of requests (cancelable promise pattern)
1924
- Supports external references using [json-schema-ref-parser](https://github.com/APIDevTools/json-schema-ref-parser/)
2025

2126
## Install
2227

2328
```
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
2536
```
2637

2738
## Usage
@@ -57,5 +68,5 @@ $ openapi --help
5768
Documentation
5869
===
5970

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)
6172

0 commit comments

Comments
 (0)