22
33[ ![ code-review] ( https://github.com/FrontEndDev-org/openapi-axios/actions/workflows/code-review.yml/badge.svg )] ( https://github.com/FrontEndDev-org/openapi-axios/actions/workflows/code-review.yml )
44[ ![ dependency-review] ( https://github.com/FrontEndDev-org/openapi-axios/actions/workflows/dependency-review.yml/badge.svg )] ( https://github.com/FrontEndDev-org/openapi-axios/actions/workflows/dependency-review.yml )
5- [ ![ Codacy Badge] ( https://app.codacy.com/project/badge/Grade/e788387e5e27472ba3b5003bf19aeea7 )] ( https://app.codacy.com/gh/FrontEndDev-org/openapi-axios/dashboard?utm_source=gh&utm_medium=referral&utm_content=&utm_campaign=Badge_grade )
6- [ ![ Codacy Badge] ( https://app.codacy.com/project/badge/Coverage/e788387e5e27472ba3b5003bf19aeea7 )] ( https://app.codacy.com/gh/FrontEndDev-org/openapi-axios/dashboard?utm_source=gh&utm_medium=referral&utm_content=&utm_campaign=Badge_coverage )
5+ [ ![ Codacy Badge] ( https://app.codacy.com/project/badge/Grade/4fa1acaeb717469caddfe21a84c50bb2 )] ( https://app.codacy.com/gh/FrontEndDev-org/openapi-axios/dashboard?utm_source=gh&utm_medium=referral&utm_content=&utm_campaign=Badge_grade )
6+ [ ![ Codacy Badge] ( https://app.codacy.com/project/badge/Coverage/4fa1acaeb717469caddfe21a84c50bb2 )] ( https://app.codacy.com/gh/FrontEndDev-org/openapi-axios/dashboard?utm_source=gh&utm_medium=referral&utm_content=&utm_campaign=Badge_coverage )
77![ npm] ( https://img.shields.io/npm/v/openapi-axios )
88![ release] ( https://img.shields.io/github/v/release/FrontEndDev-org/openapi-axios )
99![ license] ( https://img.shields.io/github/license/FrontEndDev-org/openapi-axios )
1010
1111OpenAPI ➡️ Axios
1212
13- 将 OpenAPI 规范声明文件转换为类型声明和可执行函数(基于 Axios)。与其他同类工具相比,具有以下特点
13+ 将 OpenAPI 规范声明文件转换为类型声明和可执行函数(基于 Axios)。与其他同类工具相比,具有以下特点:
1414
1515- 每个 API 都是一个函数,用于在构建时轻松进行 tree shaking
1616- 轻松与本地请求客户端集成,例如在本地项目中创建的 Axios 实例
1717- 易于使用,易于学习,类型安全
1818
19- # Install
19+ # 安装
2020
2121``` shell
2222npm i -D openapi-axios
2828yarn add --dev openapi-axios
2929```
3030
31- # Usage
31+ # 使用
3232
33- ## CLI
33+ ## 命令行
3434
3535在项目根目录下创建配置文件,配置文件的搜索顺序是 ` openapi.config.cjs ` 、` openapi.config.js ` 、` openapi.json ` 。
3636
@@ -114,7 +114,7 @@ export async function findPetsByStatus(
114114``` ts
115115import { findPetsByStatus } from ' @/apis/swagger/pet' ;
116116
117- // There are type hints when calling functions and writing parameters, thanks to TypeScript.
117+ // 在调用函数和编写参数时,有类型提示,这要感谢 TypeScript
118118const pets = await findPetsByStatus ({
119119 status: [' avaliable' ],
120120});
@@ -130,16 +130,15 @@ generate({
130130});
131131```
132132
133- # Config
133+ # 配置
134134
135135| 参数名 | 类型 | 可选性 | 描述 | 默认值 |
136136| -------------------- | --------------- | ------- | --------------------------------------------------------------------------------- | ----------------------------------------------- |
137137| ` cwd ` | ` string ` | ` false ` | 当前工作路径 | ` process.cwd() ` |
138138| ` dest ` | ` string ` | ` false ` | 目标目录 | ` src/apis ` |
139139| ` axiosImport ` | ` string ` | ` false ` | axios 导入内容 | 默认从官方 Axios 导入,可以使用自己实现的客户端 |
140140| ` unwrapResponseData ` | ` boolean ` | ` false ` | 是否取消对 axios response 的包裹(即直接返回 ResponseData,而不是 AxiosResponse) | ` false ` |
141- | ` list ` | ` OpenApiSpec[] ` | ` false ` | OpenAPI 规范声明列表 | |
142- | ` [] ` | | | | |
141+ | ` list ` | ` OpenApiSpec[] ` | ` false ` | OpenAPI 规范声明列表 | ` [] ` |
143142
144143` OpenApiSpec ` 签名:
145144
@@ -151,3 +150,7 @@ generate({
151150| ` spec ` | ` Spec ` | ` false ` | 本地 OpenApi 描述文件 | ` undefined ` |
152151
153152备注:` url ` 属性和 ` spec ` 属性,至少有一个必须。
153+
154+ # 鸣谢
155+
156+ - [ swagger-typescript-api] ( https://www.npmjs.com/package/swagger-typescript-api )
0 commit comments