什么是awto？

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

数据库生成

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

Protobuf生成

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

概念

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

Schema

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

// 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中的示例模式。

Service

Service库是您编写业务逻辑的地方。这种业务逻辑可以后来用于创建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工作空间

您的schema和service库应位于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 许可证授权。