free-swagger-cli 基于 free-swagger,提供命令行交互功能,全量生成 api 并写入至项目文件
npx free-swagger-cli
npm i free-swagger-cli -g
free-swagger-cli
之后需要输入 swagger 源,可以是 url,也可以是本地的 json 文件的路径
输出 ts 文件或者编辑模版等高级功能,需要详细配置
npx free-swagger-cli --config
在运行一次后 free-swagger-cli 会记住用户上一次的配置项
free-swagger 基于内置了默认模版函数,用于生成 api 代码片段,详细参数见 free-swagger-core
除了生成 api,free-swagger-cli 还可以生成 mock 文件
npx free-swagger-cli --mock
和详细配置 free-swagger-cli 步骤相似,输入一个 swagger 源,全量生成 mock 数据(json),配合其他 mock 工具实现本地 mock
额外生成了一个 mock.js 文件用于汇总所有 json,这使得 mock 工具只需引入一个 mock.js 即可实现本地 mock
注意:free-swagger-cli 只输出 mock 文件,不提供本地 mock 服务
--config/-c
以配置项启动 free-swagger-cli
npx free-swagger-cli --config
--mock/-m
全量生成 mock 文件
npx free-swagger-cli --mock
--reset/-r
重置为默认配置
npx free-swagger-cli --reset
--show/-s
显示当前配置
npx free-swagger-cli --show
--edit/-e
编辑当前配置
npx free-swagger-cli --edit
--help/-h
output usage information
npx free-swagger-cli --help
当前 swagger 源可能需要鉴权,free-swagger 提供了 cookie 选项,填入有权限的 cookie
或者直接将 swagger 源下载到本地,输入文件路径
不规范的 swagger 文档可能会导致部分 mock 数据丢失,free-swagger 会作出警告