什么是 awto？

Awto 将您的 Rust 项目视为微服务的真相来源，并根据您的模式和服务的生成数据库表和 protobuf。

数据库生成

• 数据库表是从您的 Rust 结构体生成的
• 您结构体的更改将被检测到，并将相应地修改表模式

Protobuf 生成

• 从您的模型生成 protobuf 模式
• 从您的应用程序服务编译 protobuf 服务器

概念

使用 awto，您为每个微服务创建一个 Cargo 工作空间。在您的工 作空间下，您创建两个库： schema 和 service

模式

模式库的目的是定义您的微服务模型，这些模型将用于生成数据库表。

// schema/src/lib.rs
use awto::prelude::*;

schema! {
    #[database_table]
    #[protobuf_message]
    pub struct Product {
        pub id: Uuid,
        pub created_at: DateTime<FixedOffset>,
        pub updated_at: DateTime<FixedOffset>,
        pub name: String,
        #[awto(max_len = 120)]
        pub description: Option<String>,
        #[awto(default = 0)]
        pub price: i64,
    }
}

请参阅 examples/ecom 中的示例模式。

服务

服务库是您编写业务逻辑的地方。此业务逻辑可以稍后用于创建 protobuf API（以及在将来创建 graphql API）。

// service/src/lib.rs

register_services!(ProductService);

pub struct ProductService {
    pub conn: DatabaseConnection,
}

#[protobuf_service]
impl ProductService {
    pub async fn find_by_id(&self, request: ProductId) -> Result<Product, Status> {
        let product = product::Entity::find_by_id(request.id)
            .one(&self.conn)
            .await
            .map_err(|err| Status::internal(err.to_string()))?
            .ok_or_else(|| Status::not_found("product not found"))?;

        Ok(product.into())
    }
}

请参阅 examples/ecom 中的示例服务。

Cargo 工作空间

您的模式和服务库应位于一个 Cargo 工作空间下。

# root Cargo.toml
[workspace]
members = ["schema", "service"]

请参阅 examples/ecom 中的示例项目。

Awto CLI

Awto 提供了一个 CLI，用于使用 awto compile <lib> 命令生成额外的库。目前可用的库有

• database - 基于 SeaORM，提供了一个用于您的服务的数据库库
• protobuf - 基于 tonic，提供了一个 protobuf 服务器库

安装

CLI 可以通过以下方式安装

cargo install awto-cli

这将提供名为 awto 的二进制文件。

使用 awto --help 检查安装情况。

编译库

要编译库，您可以运行

awto compile <output>

当前可用的输出包括

• database - 将您的数据库与模式同步并生成一个库，通过 SeaORM 执行数据库操作。
• protobuf - 生成一个 protobuf 文件和库，可以通过 tonic 作为 protobuf 服务器和客户端使用。

路线图

Awto 目前仍处于 alpha 阶段，目前主要作为一个实验。如果它得到一些关注，将会投入大量精力使其成为 Rust 社区的有用工具。

贡献

无论您想分享想法、错误、建议或其他内容，都欢迎您的贡献 🤌

许可

通过贡献，您同意您的贡献将按照此存储库的 MIT 或 Apache-2.0 许可证授权。