如何更新 NestJS Swagger 模块但使用 OpenAPI 2.0(Swagger)?
How to update NestJS Swagger module but use OpenAPI 2.0(Swagger)?
我们正在使用 NestJS 框架在 Node.js/Typescript 中制作 API。我们使用 @nestjs/swagger
包使其符合 OpenAPI(以前称为 Swagger)。它旨在与 Azure/autorest
一起使用以生成客户端代码。
Autorest 支持 OpenAPI 2.0 而不是 3.0。 @nestjs/swagger 3.*.*
实施了 OpenAPI 2.0。当我们将 @nestjs/swagger
更新为 4.*.*
时,它会变成 OpenAPI 3.0。这不符合我们的需要,因为我们不能再使用 Autorest。另一方面,不更新包意味着我们可能会错过安全更新,甚至无法更新整个 NestJS 框架。
有什么方法可以更新 @nestjs/swagger
并继续使用 OpenAPI 2.0?
很遗憾没有。在内部,@nestjs/swagger
v4 专门生成 OpenAPI 3.0 specification
。在等待 autorest 3
正式发布时,现在有两个选择。
- 继续使用
@nestjs/swagger
v3。至于update the entire NestJS
framework
,你不用担心,因为
@nestjs/swagger
几乎是一个 独立 包。安全
关于依赖关系的问题,我可以看到你的担忧在那里是有效的。
- 试试
autorest 3.beta
看看它是否足够稳定
使用。
我们正在使用 NestJS 框架在 Node.js/Typescript 中制作 API。我们使用 @nestjs/swagger
包使其符合 OpenAPI(以前称为 Swagger)。它旨在与 Azure/autorest
一起使用以生成客户端代码。
Autorest 支持 OpenAPI 2.0 而不是 3.0。 @nestjs/swagger 3.*.*
实施了 OpenAPI 2.0。当我们将 @nestjs/swagger
更新为 4.*.*
时,它会变成 OpenAPI 3.0。这不符合我们的需要,因为我们不能再使用 Autorest。另一方面,不更新包意味着我们可能会错过安全更新,甚至无法更新整个 NestJS 框架。
有什么方法可以更新 @nestjs/swagger
并继续使用 OpenAPI 2.0?
很遗憾没有。在内部,@nestjs/swagger
v4 专门生成 OpenAPI 3.0 specification
。在等待 autorest 3
正式发布时,现在有两个选择。
- 继续使用
@nestjs/swagger
v3。至于update the entire NestJS framework
,你不用担心,因为@nestjs/swagger
几乎是一个 独立 包。安全 关于依赖关系的问题,我可以看到你的担忧在那里是有效的。 - 试试
autorest 3.beta
看看它是否足够稳定 使用。