swagger-diff 正在参加 2021 年度 OSC 中国开源项目评选,请投票支持!
swagger-diff 在 2021 年度 OSC 中国开源项目评选 中已获得 {{ projectVoteCount }} 票,请投票支持!
2021 年度 OSC 中国开源项目评选 正在火热进行中,快来投票支持你喜欢的开源项目!
2021 年度 OSC 中国开源项目评选 >>> 中场回顾
swagger-diff 获得 2021 年度 OSC 中国开源项目评选「最佳人气项目」 !

软件简介

自动生成 API ChangeLog 组件。

用来比较两个由Swagger生成的API文档,对参数、返回类型、路径进行深度比较,并输出差异(HTML格式、Markdown格式),适用于自动生成接口变更文档。

前提

jdk 1.6+

特性

  • Support swagger1.x and swagger2.0

  • Support HTTP请求方法比较: get post put delete...

  • Support Requestbody参数比较

  • Support API文档的鉴权Auth读取

  • EL(Expression Language)表达式

  • HTML 渲染、markdown 渲染

Maven

<dependency>
        <groupId>com.deepoove</groupId>
        <artifactId>swagger-diff</artifactId>
	<version>1.1.0</version>
</dependency>

快速入门

SwaggerDiff可以从JSON文件或者HTTP URL中读取API-DOC。

final String SWAGGER_V2_DOC1 = "petstore_v2_1.json";
final String SWAGGER_V2_DOC2 = "http://petstore.swagger.io/v2/swagger.json";

SwaggerDiff diff = SwaggerDiff.compareV2(SWAGGER_V2_DOC1, SWAGGER_V2_DOC2);

Swagger版本

v1.x版本

SwaggerDiff.compareV1(SWAGGER_V1_DOC1, SWAGGER_V1_DOC2);

v2.0版本

SwaggerDiff.compareV2(SWAGGER_V2_DOC1, SWAGGER_V2_DOC2);

工作原理

展开阅读全文

代码

的 Gitee 指数为
超过 的项目

评论 (0)

加载中
更多评论
暂无内容
发表了博客
2018/04/12 14:35

array_diff、array_diff_key、array_diff_ukey、array_diff_assoc、array_diff_uassoc 的用法

<?php // array_diff* 系列的函数都返回关联数组 // array_diff* 系列函数返回数组的差集(返回在第一个参数中, 但不在其他参数中的元素) $array1 = [ 'a' => 1, 'b' => 2, 'e' => 3, ]; $array2 = [ 'a' => 1, 'b' => 3, 'c' => 5, ]; // 只比较值 // 只返回在第一个参数中而不在其他参数中出现的值 echo "array_diff(\$array1, \$array2): \n"; var_dump(array_diff($array1, $arr...

0
0
发表了博客
2020/06/19 15:59

传统diff、react优化diff、vue优化diff

传统diff 计算两颗树形结构差异并进行转换,传统diff算法是这样做的:循环递归每一个节点 传统diff.png 比如左侧树a节点依次进行如下对比,左侧树节点b、c、d、e亦是与右侧树每个节点对比 算法复杂度能达到O(n^2),n代表节点的个数 a->e、a->d、a->b、a->c、a->a 查找完差异后还需计算最小转换方式,这其中的原理我没仔细去看,最终达到的算法复杂度是O(n^3) react优化的diff策略 传统diff算法复杂度达到O(n^3 )这意味着1000个节...

0
0
发表于大前端专区
2019/10/12 09:39

【Vue原理】Diff - 源码版 之 Diff 流程

> 写文章不容易,点个赞呗兄弟 专注 Vue 源码分享,文章分为白话版和 源码版,白话版助于理解工作原理,源码版助于了解内部详情,让我们一起学习吧 研究基于 Vue版本 **【2.5.17】** 如果你觉得排版难看,请点击 **下面链接** 或者 拉到 下面**关注公众号**也可以吧 [ 【Vue原理】Diff - 源码版 之 Diff 流程 ](https://mp.weixin.qq.com/s?__biz=MzUxNjQ1NjMwNw==&mid=2247484449&idx=1&sn=7f346b97a177218cc09fc50562ed121c&c...

0
0
发表于大前端专区
2019/08/16 11:00

【Vue原理】Diff - 源码版 之 Diff 流程

专注 Vue 源码分享,文章分为白话版和 源码版,白话版助于理解工作原理,源码版助于了解内部详情,让我们一起学习吧 研究基于 Vue版本2.5.17 今天终于要开始探索 Vue 更新DOM 的重点了,就是 Diff Diff 的内容不算多,但是如果要讲得很详细的话,就要说很多了,而且要配很多图 这是 Diff 的最后一篇文章,最重要也是最详细的一篇了 所以本篇内容很多,先提个内容概览 1、分析 Diff 源码比较步骤 2、个人思考为什么如此比较 3、写...

0
0
发表了博客
2016/12/29 09:23

Git diff命令及diff文件解释

#### diff文件的解释 ``` @@ -6,16 +6,16 @@ - + - + - + ``` -代表修改前的文件,+代表修改后的文件,第一个6,16指的是下边列出的内容是修改前的文件从第六行开始,连续16行。第二个6,16只的是下边的内容是修改后的文件从第六行开始,连续16行。

0
0
2019/05/05 10:31

git diff

用于比较两次修改的差异     1.1 比较工作区与暂存区       git diff 不加参数即默认比较工作区与暂存区     1.2 比较暂存区与最新本地版本库(本地库中最近一次commit的内容)       git diff --cached [<path>...]     1.3 比较工作区与最新本地版本库       git diff HEAD [<path>...] 如果HEAD指向的是master分支,那么HEAD还可以换成master     1.4 比较工作区与指定commit-id的差异  ...

0
0
发表了博客
2018/04/14 14:13

git diff

git diff 工作区与暂存区对比 git diff HEAD 工作区与当前工作分支对比 git diff --cached 暂存区与版本库对比 git diff <commit1> <commit2> <paths> 还可以比较不同版本间该路径下的文件差异

0
0
没有更多内容
加载失败,请刷新页面
点击加载更多
加载中
下一页
暂无内容
0 评论
4 收藏
分享
OSCHINA
登录后可查看更多优质内容
返回顶部
顶部