rswag

rswag 是一个为基于 Rails 的 API 无缝添加 Swagger 文档的工具。它通过扩展 rspec-rails 的“请求规格”功能，使用一种简洁直观的 DSL 来描述和测试 API 操作，并能自动生成 OpenAPI 文件（支持 OpenAPI 3.0），这些文件可以以 YAML 或 JSON 格式提供。此外，rswag 还集成了 swagger-ui，使得开发者可以直接从集成测试生成美观且交互式的 API 文档。此项目非常适合需要快速生成并维护 API 文档、同时希望保持测试覆盖率的 Ruby on Rails 开发者使用。