doclever-to-axios v1.1.0
doclever-to-axios
根据 doclever 导出的 json 文件生成相应的 axios 接口
介绍
基于 DOClever接口管理网站所导出的*.json
类型的接口文件,快速生成使用axios作为请求函数的批量接口处理工具.该工具还提供查看接口更新的功能.
特性
- 自定义
json
文件获取目录 - 自动读取所需
json
文件的最新版本 - 完整的函数注释
- 对比新老接口文件,获取接口更新内容
环境要求
Node >=8
安装
# yarn
yarn global add doclever-to-axios
# npm
npm i -g doclever-to-axios
使用
docLever-to-axios
会根据全局配置与该项目的docLever.js
配置文件进行相关操作. 通过dta --help || dta -h
查看该工具的简单操作
配置 api 文件下载地址
由于接口都需要下载到本地,然后才能执行一系列操作.通过dta setDir
添加读取接口文件所在的目录,如果dta init
生成的dtaConfig.json
所添加的downPath
与此不同,将以downPath
为准.
注意: 设置地址下载地址需要使用绝对地址,像~/downloads
这样的地址是没有办法进行地址拼接的,请使用C:\\users\\{用户名}\\Downloads
的方式设置地址.
生成配置文件
在项目的根目录下使用dta init
,该命令会在根目录生成配置文件docLever.js
,如果配置文件已经存在,在init
完成后将被覆盖.
初始化配置文件需要注意的点:
- 建议将生成的配置文件添加到
.gitigonre
中,因为不同人项目的存放位置不同,绝对路径也不同,就会造成寻址失败. - 在填写 name 的时候尽量填写完整,提高正则的匹配率.使用
dta config paths
,其中meetApiFiles
为匹配的文件名称. - 执行的第三步强制要求需要选择一个自定义后的
axios
配置文件,如果不需要自定义,还是建议新建一个配置文件,然后使用export default axios
导出配置. - 生成的配置文件也可以在项目目录下面自定义,修改后,建议使用
dta config files
与dta config paths
查看配置是否正确,各种地址与文件是否为你想到的.
查看文件变更
查看文件变更需要先dta ben
,选择其中一个文件作为参考文件,该参考文件会与最新下载的接口文件做对比,然后执行dta view
,会在原有配置的outPath
路径下生成一个change.md
的文档.
建议: 查看该 md 文档建议使用Typora
编辑器查看,因为其有目录方便寻找.
文件清除
使用命令dta clear
可以在完成当前版本之后,清除除最新的文件之前的所有文件,并将最新文件设置为参考文件供下一版本对比使用.
生成函数的使用
脚本生成的函数会存放在dtaConfig.json
中outPath
所指定的位置.所生成的函数有以下特点需要注意:
- 函数的名称构成为: 请求方式+驼峰化(url-忽略的前缀)的结构.
- 所有函数都放在对象
apiFetch
之中,所有调用接口函数的方式为:apiFetch.接口名称(params)
. - 接口的
get
,post
,put
都统一处理了,使用方式都同上一点.这里需要注意params
为对象. - 现在版本中暂时还支持修改
responseType
,后续会加上 axios
的配置建议使用全局配置,现在暂时不支持为每个接口函数配置.
许可
MIT (c) TianFu Xie