我想自动记录我的REST-API。我知道,有很多工具,但我想从单元测试中生成文档。
这样做的原因是,我希望文档能够镜像,测试什么以及什么不是。然而,文档应该像让我们说swagger所生成的文档一样丰富。
我已经找到了两种采用这种方法的项目,doctester和testdoc4j。两者都不能满足我的需求。生成的文档不会聚合快乐路径和错误路径。
你使用什么工具,你能推荐一个好的工具吗?
干杯。
修改
记录接口中定义的API合同和记录测试方案之间存在差异。如果我的文档仅包含经过测试的端点和路径,我可以定义我的界面,并且只能分发我测试过的部分。
这意味着我可以定义一个界面,让我们说十个端点。在使用相应的测试实现基本功能后,我可以使用文档发布此部分。不包括不稳定或已实现的端点,这会阻止用户使用它们。
答案 0 :(得分:0)
答案 1 :(得分:0)
我最近对同一主题进行了一些研究,并决定使用Miredot的免费版本,因为它是唯一满足我要求的工具:
当您运行mvn test
答案 2 :(得分:0)