从 JSDoc 生成 Swagger YAML？

Question

我有一个用 JSDoc 完整记录的大型 JS API，并且我正在构建一个基于 REST 服务以使该 API 在网络上可用。

我手动构建了 YAML swagger 规范的初始版本，但问题是它很快与 JS API 不同步，因为它仍在不断发展，特别是在所涉及对象的属性方面。

我想做的是直接从 JSDoc cmets 自动生成 swagger YAML，至少是其中的数据定义部分。有什么工具可以帮我实现自动化吗？

Answer 1

swagger-jsdoc 可能满足您的要求。