开源项目推荐：routing-controllers-openapi

开源项目推荐：routing-controllers-openapi

routing-controllers-openapi Runtime OpenAPI v3 schema generation for routing-controllers. 项目地址: https://gitcode.com/gh_mirrors/ro/routing-controllers-openapi

项目基础介绍和主要编程语言

routing-controllers-openapi 是一个基于 TypeScript 的开源项目，旨在为使用 routing-controllers 框架的开发者提供运行时生成 OpenAPI v3 规范的功能。该项目充分利用了 TypeScript 的类型系统和装饰器特性，使得开发者能够轻松地将现有的控制器代码转换为 OpenAPI 文档。

项目核心功能

1. 运行时生成 OpenAPI v3 规范：通过解析 routing-controllers 的元数据，自动生成符合 OpenAPI v3 规范的文档。
2. 支持多种装饰器：项目支持 @Get、@Post、@QueryParam、@HeaderParam 等多种装饰器，能够覆盖大部分的 API 需求。
3. 自定义配置：开发者可以通过配置 routingControllersToSpec 函数，自定义生成的 OpenAPI 文档，包括添加额外的属性、修改默认行为等。
4. 验证类支持：通过与 class-validator-jsonschema 集成，项目能够将验证类转换为 OpenAPI 兼容的 Schema。
5. 响应模式注解：支持使用 @ResponseSchema 装饰器为 API 响应添加 Schema 注解，方便生成详细的 API 文档。

项目最近更新的功能

1. 支持多重 @OpenAPI 装饰器：现在可以在单个处理程序上使用多个 @OpenAPI 装饰器，每个装饰器可以提供不同的 OpenAPI 属性。
2. 改进的 @ResponseSchema 支持：新增了对多个 @ResponseSchema 装饰器的支持，能够为不同的 HTTP 状态码生成不同的响应 Schema。
3. 增强的合并逻辑：通过引入 lodash/merge，改进了多个 @OpenAPI 装饰器之间的合并逻辑，确保生成的 OpenAPI 文档更加准确和完整。
4. 更好的类型推导：项目进一步优化了 TypeScript 的类型推导，使得生成的 OpenAPI 文档在类型定义上更加精确。

通过这些更新，routing-controllers-openapi 项目在功能和易用性上都有了显著的提升，为开发者提供了更加强大的工具来生成和管理 OpenAPI 文档。

routing-controllers-openapi Runtime OpenAPI v3 schema generation for routing-controllers. 项目地址: https://gitcode.com/gh_mirrors/ro/routing-controllers-openapi