Sisyphus-cli NPM

sisyphus-cli(西西弗斯)

一个从swagger自动生成ts,js代码的工具

和一般的生成器对比

支持多来源
支持生成指定tag下的接口

为什么要使用这个？

减少模板代码
接口的版本控制
请求参数和返回结果的自动提示
自动生成文档和注释

如何使用

安装cli

npm install sisyphus-cli -g

如何增加新的项目

新建文件夹如xxx-api
sisyphus init xxx-api初始化
查看如何更新代码

如何更新代码

进入相应文件夹如xxx-api
查看sisyphus.js文件file路径是否执行对应swagger的地址
执行sisyphus生成ts
执行npm run build生成js

sisyphus

module.exports = {
  "file": "http://localhost:8000/v2/api-docs",
  "tags": {
    "信息相关": "message",
  },
  outDir: "./src/service",
  nameStrategy(interfaceInfo, changeCase) {
    const subs = interfaceInfo.parsedPath.dir.split('/');
    const dirSub = subs.slice(subs.length - 2);
    dirSub.push(interfaceInfo.parsedPath.name);
    dirSub.push(interfaceInfo.method.toLocaleLowerCase());
    return changeCase.camelCase(dirSub.join('_'));
  },
  dataKey: 'data',
  optionalQuery: false,
  appendOptions: true,
  onlyTags: false,
  createTags: false,
  requestPath: "@/service/request.ts",
  mock: true,
  mockOverwrite: result => {
    return Object.assign({}, result.response, {
      "resultCode": 100,
      "resultMsg": "",
      "success": true
    })
  }
  responseNullable: true,
  formatUrl: (baseUrl, url) => baseUrl + "/" + url
}

参数说明

file

必填，表示swagger地址，可以是url或者file 如果是对象比如

{
  "a": "http://localhost:8000/v2/api-docs",
  "b": "http://localhost:8000/v2/api-docs",
}

会在各自模块下生成对应的请求文件和模型 outDir + "a" 下面生成请求文件和模型 outDir + "b" 下面生成请求文件和模型

nameStrategy

可选，命名策略， interfaceInfo接口信息，changeCase表示change-case实例

dataKey

可选，字符串，响应结果解包。Result<T> { data: T, code: number, string },设置dataKey为data, Promise<Result<BaseVo>> => Promise<BaseVo>

optionalQuery

可选，默认false，将所有query属性转为option

appendOptions

可选，增加额外的options, function abc() { return request({}) } => function abc(options?: any) { return request({ ...options }) }

onlyTags

可选，根据tags生成对应的controller而不是所有, 默认false

outDir

可选，自动生成位置，默认./src/api

requestPath

可选，请求路径位置，默认如果file是string 返回./request,否则../request 现在不会生成request.ts文件可参考自己写一份

import axios from 'axios'

function bindUrl(path: string, pathParams: any) {
  if (!path.match(/^\//)) {
    path = '/' + path;
  }
  var url = path;
  url = url.replace(/\{([\w-]+)\}/g, function (fullMatch, key) {
    var value;
    if (pathParams.hasOwnProperty(key)) {
      value = pathParams[key];
    } else {
      value = fullMatch;
    }
    return encodeURIComponent(value);
  });
  return url;
}

const request = axios

export { request, bindUrl };

createTags

可选，默认false，生成tags文件方便映射

mock

可选，默认false，在src同级mock目录下生成mock文件

mockOverwrite

可选，null， mock响应覆盖

  mockOverwrite: result => {
    return Object.assign({}, result.response, {
      "resultCode": 100,
      "resultMsg": "",
      "success": true
    })
  }