只为点滴幸福 发表于 2023-8-6 00:56:34

OpenApi(Swagger)快速转换成 TypeScript 代码 - STC


在现代的 Web 开发中,使用 OpenAPI(以前称为 Swagger)规范来描述和定义 API 已经成为一种常见的做法。OpenAPI 规范提供了一种统一的方式来描述API的结构、请求和响应,使得开发人员能够更好地理解和使用 API。
然而,手动编写与 OpenAPI 规范匹配的客户端代码或服务端框架可能是一项繁琐且耗时的任务。这就是为什么使用 STC(Swagger Transform Code)工具可以大大简化这个过程,并快速生成与 OpenAPI 规范一致的 TypeScript 代码的原因。
什么是STC(Swagger Transform Code)?

STC 是一个用于将 OpenAPI 规范的 Swagger/Apifox 文档转换为可执行代码文件的工具。它提供了一种自动化的方式来读取 OpenAPI 规范的 Swagger/Apifox 文档,并根据规范生成与之匹配的 TypeScript 代码。
特性:

[*]支持 Swagger 2, 3 和 Apifox。
[*]支持 Axios、Wechat 请求库。
[*]支持插件开发。
下载 STC


[*]Windows
[*]Mac Intel
[*]Mac M
[*]Linux
软件没有签名,在打开时会被系统安全提示,允许即可。
如何使用?

下载好后,在终端(cmd)中进入到 STC 文件所在目录。输入如下命令:
stc --url=https://petstore3.swagger.io/api/v3/openapi.json --outDir=out需要注意的是 STC 不会识别 ~ 为用户主目录,这是由于 Deno 自身不支持。


选项

参数名类型默认值说明urlstringSwagger 文档地址,或者本地路径outDirstringstc_out输出目录platformstringaxios平台,可选值:axios、wechatlangstringts语言,用于输出文件的后缀名tagnumber从接口 url 指定标签,默认读取 tags 的第一个用于文件名filterstring[]过滤接口,符合过滤条件的接口会被生成。eg: --filter "/pet/*",生成 /pet 的接口,同时支持多个 --filter最后

目前工具还在完善中,后续会内置支持更多语言的插件。
如果你觉得不错,可以 star 表示支持一下 https://github.com/long-woo/stc。

来源:https://www.cnblogs.com/JasonLong/p/17606115.html
免责声明:由于采集信息均来自互联网,如果侵犯了您的权益,请联系我们【E-Mail:cb@itdo.tech】 我们会及时删除侵权内容,谢谢合作!
页: [1]
查看完整版本: OpenApi(Swagger)快速转换成 TypeScript 代码 - STC