BeeRust

简体中文 · English · 한국어 · Русский · Deutsch · Français · Español · Português · हिन्दी · العربية · বাংলা · Bahasa Indonesia · 日本語

A production-grade web framework for Rust, with a design philosophy borrowed from Go's Beego and re-expressed through Rust's traits, macros and type system.

MVC controllers · namespaced routing · filter chains · ORM · unified trait abstractions over storage engines

Install

cargo add bee_rust

Or add it to Cargo.toml:

[dependencies]
bee_rust = "1.2.1"
tokio = { version = "1", features = ["full"] }
axum = "0.8"

The default full feature enables router + orm + kv + config + logs + cache + session + security + template.

Quick start

async fn health() -> &'static str {
    "OK"
}

#[tokio::main]
async fn main() -> bee_rust::Result<()> {
    let _log_handle = bee_rust::init()?;

    let router = bee_rust::bee_router::Router::new()
        .ns("/api/v1", |ns| ns.get("/health", health));

    let listener = tokio::net::TcpListener::bind("0.0.0.0:8080").await?;
    axum::serve(listener, router.build()).await?;
    Ok(())
}

cargo run
curl http://localhost:8080/api/v1/health    # OK

A complete runnable project lives in examples/hello (covered by end-to-end tests).

Feature flags

search, graph and tsdb are not part of the default full set — enable them explicitly.

Minimal core (no ORM, no database drivers):

bee_rust = { version = "1.2.1", default-features = false, features = ["router", "logs", "config"] }

Sub-crates

The framework is a set of independently usable crates; bee_rust is the single entry point that re-exports them on demand.

They can also be depended on directly — for example, just an Elasticsearch client:

bee_search = { version = "1.2.1", features = ["elasticsearch"] }

Supported databases

Requirements

• Rust 1.80+ (MSRV)
• edition 2024

Links

• API docs: docs.rs/bee_rust
• Repository: github.com/erikwang2013/bee-rust
• Full API reference (13 languages): docs/

BeeRust（中文）

Rust 生产级 Web 框架，设计哲学源自 Go 的 Beego，用 Rust 惯用的 trait / macro / 类型系统重新表达。

MVC 控制器 · 命名空间路由 · 过滤器链 · ORM · 多存储引擎统一 trait 抽象

安装

cargo add bee_rust

或写入 Cargo.toml：

[dependencies]
bee_rust = "1.2.1"
tokio = { version = "1", features = ["full"] }
axum = "0.8"

默认启用 full feature（router + orm + kv + config + logs + cache + session + security + template）。

快速开始

async fn health() -> &'static str {
    "OK"
}

#[tokio::main]
async fn main() -> bee_rust::Result<()> {
    let _log_handle = bee_rust::init()?;

    let router = bee_rust::bee_router::Router::new()
        .ns("/api/v1", |ns| ns.get("/health", health));

    let listener = tokio::net::TcpListener::bind("0.0.0.0:8080").await?;
    axum::serve(listener, router.build()).await?;
    Ok(())
}

cargo run
curl http://localhost:8080/api/v1/health    # OK

完整可运行项目见 examples/hello（含端到端测试）。

Feature 开关

search、graph、tsdb 不在默认的 full 里，需要单独开启。

只想要最小核心（不拖 ORM、数据库驱动）：

bee_rust = { version = "1.2.1", default-features = false, features = ["router", "logs", "config"] }

子 Crate

本框架由多个可独立使用的 crate 组成，bee_rust 是统一入口，按需 re-export。

这些 crate 也可以单独依赖，例如只用一个 ES 客户端：

bee_search = { version = "1.2.1", features = ["elasticsearch"] }

支持的数据库

环境要求

• Rust 1.80+（MSRV）
• edition 2024

链接

• API 文档：docs.rs/bee_rust
• 仓库：github.com/erikwang2013/bee-rust
• 完整 API 参考（13 语言）：docs/

许可证 / License

Apache-2.0