Swagger2TS-Rust_Cli

这是一个根据远程swagger文档来生成 Typescript interface 的命令行工具。 使用 Rust 编写，速度够快。

参数

Simple program to generate the typescript interface by swagger json
Options:
  -C, --config <config file path> path for config file
  -h, --help                 Print help
  -V, --version              Print version

安装

npm i swagger2ts-rust-cli -D

yarn add swagger2ts-rust-cli -D

使用

{
	"scripts": {
		"trans-swagger": "swagger2ts --C <config file path>"
	}
}

yarn trans-swagger
// or
npm run trans-swagger

Config 配置

默认会在项目的根目录下查询swagger2ts.json文件,可手动传入配置文件

配置项	子配置	描述	默认值	类型
filename	-	存储 interface 的文件名	无	string
url	-	swagger json 文件的请求地址	无	string
outdir	-	输出的目录	无	string
request	-	是否同时生成 api 请求函数	无	boolean
request_config		生成 api 函数的配置	无
-	function_template	api 函数模板，示例模板请看下方	无	string
-	ignore_path	需要忽略的 url 前缀	无	string
-	prefix	需要在 api 函数文件头部添加的字符串，可以在此处传入需要导入的东西	无	string
-	split	是否要根据模块拆分成不同的文件(待实现)	无	boolean

function_template

{
	"function_template": "//{description}\nexport function {name} (params?:{parameter})  {\n return http.{method}<{response}>({url},params);\n}\n"
}

在程序运行的时候会将{xxx}替换成对应的数据

参数	解读
description	接口描述
name	接口名称
parameter	接口参数类型
method	请求方式
response	接口返回值类型
url	接口请求地址

默认会在运行的目录下的api文件中生成一个index.d.ts文件，里面包含了 swagger 的 definitions 或 openapi 的 components/schemas 里定义的数据结构，只转化名称为全英文的 definitions/schemas

目前除了 interface 是指定存放目录以外，api 函数统一输出在 config.outdir 下面的api.ts文件中。

非合法的 interface 名称会转换成Interface_{名称hash后后6位}