rezzza/jadd

Jadd : 另一个文档导出工具

dev-master 2017-02-05 17:59 UTC

This package is not auto-updated.

Last update: 2024-09-14 19:20:14 UTC


README

Jadd : 另一个文档导出工具

为什么?

  • 因为我们热爱阅读REST API的文档。
  • 我们真的不喜欢编写文档。
  • 我们真的不喜欢更新文档。
  • 注释是邪恶的

如何?

需要两个步骤

在功能测试期间收集响应

当然你有你API的测试。那么为什么不让它连接到它并记录你测试的所有用例呢?

如果你使用php-http,我们提供了一个中间件在测试期间收集数据。查看测试以确定如何使用它。

合并路由文件

然后只需要运行bin/jadd generate <myRoutingFile> <outputFile>

它将解析你的路由并将记录的响应与测试合并。

最佳位置是在CI的onSuccess钩子中。

安装

目前,我们只支持通过composer在PHP项目中安装。

composer require --dev rezzza/jadd:dev-master

支持的路由

  • Symfony YAML(不支持控制器中的YAML + @Route 注释)

支持的输出