从 OpenAPI 规范生成 JSDoc
Generating JSDoc from OpenAPI Spec
我有一个来自我使用的 API 服务的 OpenAPI 规范(以 swagger.json
文件的形式)。我想加快生成我的端点的开发过程,最好用 JSDoc 记录它们以在 VS Code 中保持 运行 顺利进行。
我找到了几个 JSDoc-to-Swagger/OpenAPI 解析器和 OpenAPI 渲染器,例如:
- https://www.npmjs.com/package/jsdoc-to-oas?activeTab=readme
- https://www.npmjs.com/package/openapi-comment-parser
- https://www.npmjs.com/package/express-jsdoc-swagger
但是,这些包将 JSDoc 作为输入,并呈现 Swagger / OpenAPI 规范作为输出。我想做相反的事情。 Google 没有帮助,我也没有在 Whosebug 上看到太多内容。
除了为此实施我自己的程序包之外,是否有人有任何建议?
This 包会根据你的招摇生成代码,虽然不是你想要的,但可能值得研究。
我有一个来自我使用的 API 服务的 OpenAPI 规范(以 swagger.json
文件的形式)。我想加快生成我的端点的开发过程,最好用 JSDoc 记录它们以在 VS Code 中保持 运行 顺利进行。
我找到了几个 JSDoc-to-Swagger/OpenAPI 解析器和 OpenAPI 渲染器,例如:
- https://www.npmjs.com/package/jsdoc-to-oas?activeTab=readme
- https://www.npmjs.com/package/openapi-comment-parser
- https://www.npmjs.com/package/express-jsdoc-swagger
但是,这些包将 JSDoc 作为输入,并呈现 Swagger / OpenAPI 规范作为输出。我想做相反的事情。 Google 没有帮助,我也没有在 Whosebug 上看到太多内容。
除了为此实施我自己的程序包之外,是否有人有任何建议?
This 包会根据你的招摇生成代码,虽然不是你想要的,但可能值得研究。