该项目为与斯瓦格的融合和互动提供了各种工具. 这个项目尚处于初期阶段,但 应充分测试和重新使用储存库内的东西。 请访问 问题跟踪器 改为 看看我们意识到什么问题,以及我们正在研究什么特征/加强。 要不然,请随意审查一下 发布注释 以了解什么是新的和改进.
项目徽章
支持的 Swagger 版本
特征
- 简单 CLI
- 验证 Swagger 文档
- 将 Swagger 1.2 文档转换为 Swagger 2.0
- Schema验证:对于Swagger规格支持的文件,确保它们通过结构验证 基于 杰森·斯克马 与该规格版本有关 (浏览器和节点)
- 语义验证: 在文件结构之上及之外验证 Swagger 文件 (浏览器和节点)
- 连接中间软件,将相关的 Swagger 信息添加到您的请求中 (仅节点)
- 根据 Swagger 文档连接安全处理器的中端软件 (仅节点)
- 根据 Swagger 文档连接线程请求处理器的中间软件 (仅节点)
- 连接服务您 Swagger 文档的中间软件 Swagger 用户界面 (仅节点)
- 连接用于使用 Swagger 资源文档进行预路由验证的中间软件 (仅节点)
- 根据操作的
consumes/produces数值 - 验证请求参数类型
- 验证请求参数值
- 验证响应值
- 根据操作的
安装
Swagger Tools同时可供Node.js和浏览器使用. 每种环境的安装说明如下.
浏览器
浏览器应用程序的安装可以通过 鲍尔 或下载独立的二进制.
使用鲍尔
bower install swagger-tools --save
独立的二进制
独立二进制有两种口味:
- 摇摆-工具-独立.js数字 : 2 280克b (中文(简体) ),完整来源 (包括所有依附关系) 和源地图
- 斯瓦格-工具-独立-min.js数字 : 316kb (韩语), 修改后, 压缩 没有源图
节点.js
节点Js应用程序的安装可以通过 国家预防机制。 。 。 .
npm install swagger-tools --save
如果你想用这个 swagger-tools 用于验证 Swagger 文档的可执行文件, 您可以安装 swagger 工具
全球使用:
npm install -g swagger-tools
文档
{\fn黑体\fs22\bord1\shad0\3ahbe\4ah00\fscx67\fscy66\2chffffff\3ch808080}那就直接去项目吧 文档 或者直接跳转到 页:1 快速启动。 。 。 .
捐款
这个项目使用 古尔普 用来建造这样的 npm install -g gulp 一旦你复制了这个项目。 运行 gulp 输入
project root 将进行源代码检查并运行单位测试.