1作者: zachacious200010 个月前
嗨 HN, 我开发了 go-respec 来解决 Go 中 OpenAPI 工具长期存在的一个烦恼——过度依赖魔术注释和样板代码。如果你使用过 swaggo、oapi-codegen 或类似的工具,你可能也深有体会。 go-respec 采用了不同的方法: - 无注解 - 无代码生成 - 无包装器 它静态分析你的 Go 源代码,推断出完整的 OpenAPI v3 规范——路由、请求/响应体、参数、中间件,甚至安全性——并在需要时提供清晰的覆盖选项。它与框架无关(适用于 chi、gin、echo 等),并且不关心你使用什么架构。 你可以在几秒钟内获得一个可用的规范: ``` go install github.com/Zachacious/go-respec/cmd/respec@latest respec . -o openapi.yaml ``` 在对现有生态系统感到沮丧之后,我为自己的项目构建了这个工具,但它已经被证明不仅仅适用于我的用例。 欢迎提出你的想法、批评或功能请求。 仓库:[https://github.com/Zachacious/go-respec](https://github.com/Zachacious/go-respec) 文档:[https://github.com/Zachacious/go-respec#readme](https://github.com/Zachacious/go-respec#readme)