rswag

rswag 是一个为 Ruby on Rails API 提供 OpenAPI 3.0 文档自动化能力的测试驱动工具。它扩展 RSpec 请求规范，通过简洁 DSL 描述接口路径、参数、响应及安全策略，并在测试通过后自动生成标准 YAML/JSON 格式的 OpenAPI 文件；同时内置 Swagger UI，提供可交互的文档与在线测试界面。支持 oneOf/anyOf/allOf 等复杂 Schema、多版本 API、请求/响应示例及安全配置。适用于需要将 API 测试与文档同步维护的 Rails 后端开发场景，尤其适合强调契约先行、CI 集成与开发者体验的团队。