#openapi #codegen #api #contract-first #api-first

已删除 codegenr-lib

基于handlebars模板的快速json/yaml/openapi代码生成器

0.0.1 2021年12月14日

#223 in #openapi

GPL-3.0-or-later

145KB
3K SLoC

CodeGenR -- 进行中 在Gitpod中打开

RustC# CodegenUP 的重写。

codegenr graphical explanation

路线图

  • 加载yaml或json到serde::json

  • 解析 $ref 标签

  • 将所有生成的文档传递给handlebar模板

  • 实现一些默认助手(并编写一些关于它们的文档测试)

  • 插件系统

  • 将C#自定义助手迁移到这个新的插件系统

  • 到目前为止,我们只需通过调用一些命令,就可以使用 codegenr 代替 CodegenUP

  • 更好的错误(类型化的错误)

  • 详细/跟踪模式?

  • Smol字符串优化?

  • 解析Json缓存优化

  • 更好的示例

  • 所有测试在Windows上也通过

  • codegenr-cli 重命名为 codegenr & 将 codegenr 重命名为 codegenr-lib

  • crates.io 上发布

  • 能够在工作区根目录有一个 codegenr.toml 来描述工作区中要执行的模板,并监视文件更改

  • 制作一个关于所有这些的VSCode扩展,使其对每个人都是实时和超级用户友好的

  • 允许合并多个swagger2文档

  • 允许合并多个swagger3文档

  • 将json转换为 OpenApi Generator 模型,并能够使用所有 OpenApi Generator 模板?

一些命令行

  • cargo doc --open 编译并打开文档
  • cargo install --path codegenr 从源代码安装codegenr命令行

依赖关系

~13–26MB
~425K SLoC