asyncapi avatar

asyncapi/modelina

440 236 4
TypeScript Apache-2.0
创建于 5 年前 最后更新 3 周前

AI 综合评分

72 B 级
代码质量
66
文档质量
75
社区健康
69
项目活跃
78
创新性
63

项目简介

基于AsyncAPI、OpenAPI等规范自动生成类型化模型的多语言代码生成库。

项目摘要

【主题】

告别手动编写数据模型——Modelina从AsyncAPI、OpenAPI等规范文档一键生成类型安全的模型代码,让开发者专注于业务逻辑。

【核心分点总结】

  1. 多格式输入:支持AsyncAPI、OpenAPI 2/3、JSON Schema等主流规范,无需转换即可直接生成。

  2. 多语言输出:覆盖TypeScript、Java、C#、Go、Rust等10+种语言,统一后端与前端的数据契约。

  3. 高度可定制:通过渲染器、预处理器和自定义选项,自由调整生成代码的样式、命名和结构。

  4. 类型安全:生成的模型自带类型注解,减少运行时错误,提升IDE智能提示。

【行动指南】

  1. 如果你的项目使用AsyncAPI/OpenAPI定义API契约,且需要同步更新客户端/服务端的数据模型,立即引入Modelina自动生成。
  2. npx @asyncapi/modelina开始,传入你的规范文档路径,指定目标语言即可快速生成骨架代码。

【金句总述】

Modelina将数据模型从文档中解放出来,变成可直接运行的代码。

【故事性收尾】

曾经,每次接口变更你都要手动修改三组模型文件,深夜的咖啡杯旁堆积着错误的类型转换。现在,你只需轻点一次生成命令,代码如溪流般从规范文档中涌出,完美匹配每一处引用。Bug缩小了,眼神明亮了,你终于有时间端详窗外久违的夕阳。

相关项目推荐