feattle

为Rust提供功能开关（简称为"feattles"），可扩展且具有后台同步和管理UI。

功能

• 与后端存储自动同步的功能开关
• 功能开关可以是简单的 bool，也可以是列表、映射和任意类型（通过FeattleValue trait）。
• 具有文档、更改历史和验证的Web UI
• 用于读取和设置开关的JSON API
• 模块化和可扩展：根据需要使用捆绑功能中的任何部分。想使用不同的Web UI？不同的存储层？没问题。

示例

use feattle::*;
use std::sync::Arc;

/// A struct with your feature toggles: you can use primitive types (like `bool`, `i32`, etc),
/// standard collections (like `Vec`, `BTreeSet`, etc) or any arbitrary type that implements
/// the required trait.
feattles! {
    struct MyFeattles {
        /// Is this usage considered cool?
        is_cool: bool = true,
        /// Limit the number of "blings" available.
        /// This will not change the number of "blengs", though!
        max_blings: i32,
        /// List the actions that should not be available
        blocked_actions: Vec<String>,
    }
}

#[tokio::main]
async fn main() {
    // Store their values and history in AWS' S3
    use std::future::IntoFuture;
    use std::time::Duration;
    use tokio::net::TcpListener;
    let config = aws_config::load_from_env().await;
    let persistence = Arc::new(S3::new(
        &config,
        "my-bucket".to_owned(),
        "some/s3/prefix/".to_owned(),
    ));

    // Create a new instance
    let my_feattles = Arc::new(MyFeattles::new(persistence));

    // Poll the storage in the background
    BackgroundSync::new(&my_feattles).start().await;

    // Start the admin UI with `warp`
    let admin_panel = Arc::new(AdminPanel::new(my_feattles.clone(), "Project Panda - DEV".to_owned()));
    tokio::spawn(run_warp_server(admin_panel.clone(), ([127, 0, 0, 1], 3030)));

    // Or serve the admin panel with `axum`
    let router = axum_router(admin_panel);
    let listener = TcpListener::bind(("127.0.0.1", 3031)).await.unwrap();
    tokio::spawn(axum::serve(listener, router.into_make_service()).into_future());

    // Read values (note the use of `*`)
    assert_eq!(*my_feattles.is_cool(), true);
    assert_eq!(*my_feattles.max_blings(), 0);
    assert_eq!(*my_feattles.blocked_actions(), Vec::<String>::new());
}

您可以使用以下命令在本地运行完整示例：cargo run --example full --features='s3 uuid warp axum'。

使用此代码，您将获得一个Web管理UI，如下所示

您可以使用此UI编辑当前值并查看其更改历史。例如，编辑一个enum时的预期效果如下

它还支持具有JSON编辑器和有用的错误诊断的复杂类型

工作原理

宏将生成具有给定名称和可见性修饰符的结构体（默认为私有）。生成的结构体实现了Feattles，并为每个功能开关公开一个方法。

为每个属性创建的方法允许读取它们的当前值。例如，对于一个属性 is_cool: bool，将会有一个类似的方法 pub fn is_cool(&self) -> MappedRwLockReadGuard<bool>。注意使用了 parking_lot::MappedRwLockReadGuard，因为结构体的内部存储在 RwLock 后面，以控制并发访问。