ESDL

Event-sourcing Schema Definition Language

用于定义聚合、命令、事件和自定义类型的模式定义语言。

深受GraphQL语法的启发，您可以描述可以用于不同语言代码生成的聚合。

安装

由于wit-bindgen项目尚未发布其crates（见https://github.com/bytecodealliance/wit-bindgen/issues/180），esdl在crates.io上不是最新的，建议现在使用git url作为依赖。

esdl = { git = "https://github.com/thalo-rs/esdl", features = ["codegen-rust"] }

可能的功能包括codegen-rust、codegen-rust-wasm和codegen-typescript。

代码生成

ESDL模式可以用于代码生成。

当前的Rust crate支持以下语言的代码生成：

• Rust (codegen-rust)
• Rust WASM (codegen-rust-wasm)
• TypeScript (codegen-typescript)

未来可能还会添加其他语言。欢迎贡献！

示例

version = "0.1.0"

aggregate BankAccount {
  open_account(initial_balance: Float) -> OpenedAccount
  deposit_funds(amount: Float) -> ReceivedFunds
  withdraw_funds(amount: Float) -> SentFunds
  send_funds(amount: Float, user: User) -> (SentFunds? | ReceivedFunds?)
}

event OpenedAccount {
  initial_balance: Float
}

event SentFunds {
  amount: Float
  user: User?
}

event ReceivedFunds {
  amount: Float
  user: User?
}

type User {
  id: String
  name: String?
}

标量类型

可选和必需

类型可以通过添加?后缀来标记为可选。

重复类型

类型可以通过将它们包裹在[]中来重复。

记住，我们可以在数组中标记类型为可选。

与Thalo集成以生成Rust代码。