从JSDoc生成Swagger YAML？

Question

我有一个用JSDoc完整记录的大型JS API,我正在构建一个基于swagger的REST服务,以使API在网络上可用.

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

我想要做的是直接从JSDoc注释自动生成swagger YAML,至少是它的数据定义部分.有没有可以帮助我实现自动化的工具？

Answer 1

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