npm

Share private packages across your team with npm Orgs, now with simplified billing via the aws marketplace!Learn more »

vswagger-cli

1.1.9 • Public • Published

vswagger npm package

vswagger是一个基于 swagger 快速生成 API 调用文件的命令行工具, 主要功能将接口同步到本地文件

  • ### Installation

Prerequisites: Node.js (>=6.x, 8.x preferred), npm version 3+ and Git.

$ npm install -g vswagger-cli
  • ### Usage
$ vswagger init

Example:

$ vswagger init
  • ### 使用方法(步骤):
  1. 全局安装vswagger
npm install -g vswagger-cli
  1. 添加根目录配置文件 .vswagger.js
/**
 * .vswagger 配置文件
 */
 
module.exports = {
    template: '', // 可为空使用默认接口生成模板
    generateType: 'souche', // 默认不要写
    safe: true, // 是否生成保护数据
    output: "src/api", // 输出到api目录
    projectDir: "src", // 代码存放目录(可不配置默认为src路径)
    suffix: [".js",".vue"], // 指定查询的文件(可不配置,默认.js,.vue文件)
    projects: [{
        token: '', // swagger令牌
        modelName: "demo1", // 模块化名称
        docUrl: ['api-docs', 'api-docs', 'api-docs', 'api-docs']  // swagger base-url
    }, {
        token: '', // swagger令牌
        modelName: 'demo2',
        docUrl: ['api-docs'] // 多个
    }] // 项目配置
};
  1. 生成接口
vswagger init
  1. 只更新/生成某个模块的接口
vswagger init 项目目录(.vswagger.js目录) 模块名称(a模块,b模块,c模块)
vswagger init ./ a
  1. 项目结束后开始清理无用的接口
vswagger clean
  1. 增加接口保护功能
通过safe开启
  1. 新增接口检测功能
vswagger check

直接上图看效果

生成的目录

index.js 文件是接口存放文件 instance.js 文件是配置 开发/预发/线上 接口访问的域名 util.js 文件是工具方法

 模块化结构

生成接口结构

 接口结构

配置接口访问的域名

接口域名配置

使用接口

调用接口

打包时会检查接口是否有遗漏(如果有遗漏会给出提示)

 清理接口接口遗漏

install

npm i vswagger-cli

Downloadsweekly downloads

22

version

1.1.9

license

ISC

homepage

github.com

repository

Gitgithub

last publish

collaborators

  • avatar
Report a vulnerability