从JSDoc生成Swagger YAML？

Question

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

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

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

Answer 1

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