kommentaar:生成Go API的文档 源码

Kommentaar为Go API生成文档。 当前主要关注输出(以前称为Swagger),但它也可以直接输出到HTML,并且该设计允许轻松添加其他输出格式。 目标: 易于使用。 很好的表现。 几乎在所有情况下都不需要大量的代码重构。 不可能产生无效的OpenAPI文件; 宁愿严格而不是灵活。 非目标: 支持最后每一个OpenAPI功能。 某些功能(例如带有anyOf不同返回值)不能很好地映射到Go的工作方式,并且对其进行支持会增加很多复杂性,并且只会使少数用户受益。 使用工具 安装它: $ go get github.com/teamwork/kommentaar 解析一个包