Rust功能开关库configcat-openfeature-provider的使用：实现OpenFeature标准与ConfigCat的无缝集成

安装

在项目目录中运行以下Cargo命令：

cargo add configcat-openfeature-provider

或者在您的Cargo.toml中添加以下内容：

[dependencies]
configcat-openfeature-provider = "0.1"

使用方式

ConfigCatProvider需要一个预先配置好的ConfigCat Rust SDK客户端：

use std::time::Duration;
use configcat::{Client, PollingMode};
use open_feature::OpenFeature;
use configcat_openfeature_provider::ConfigCatProvider;

#[tokio::main]
async fn main() {
    // 获取OpenFeature API实例
    let mut api = OpenFeature::singleton_mut().await;

    // 配置ConfigCat SDK
    let configcat_client = Client::builder("<YOUR-CONFIGCAT-SDK-KEY>")
        .polling_mode(PollingMode::AutoPoll(Duration::from_secs(60)))
        .build()
        .unwrap();

    // 配置provider
    api.set_provider(ConfigCatProvider::new(configcat_client)).await;

    // 创建客户端
    let client = api.create_client();

    // 评估功能开关
    let is_awesome_feature_enabled = client
        .get_bool_value("isAwesomeFeatureEnabled", None, None)
        .await
        .unwrap_or(false);
}

完整示例

以下是一个更完整的示例，展示了如何在实际应用中使用configcat-openfeature-provider：

use std::time::Duration;
use configcat::{Client, PollingMode};
use open_feature::OpenFeature;
use configcat_openfeature_provider::ConfigCatProvider;

#[tokio::main]
async fn main() {
    // 初始化OpenFeature API
    let mut api = OpenFeature::singleton_mut().await;

    // 配置ConfigCat客户端 - 使用自动轮询模式，每60秒更新一次配置
    let configcat_client = Client::builder("YOUR_SDK_KEY")
        .polling_mode(PollingMode::AutoPoll(Duration::from_secs(60)))
        .build()
        .expect("Failed to create ConfigCat client");

    // 设置OpenFeature provider
    api.set_provider(ConfigCatProvider::new(configcat_client))
        .await;

    // 创建功能开关客户端
    let client = api.create_client();

    // 评估布尔型功能开关
    match client.get_bool_value("new_user_interface", None, None).await {
        Ok(true) => println!("新用户界面已启用"),
        Ok(false) => println!("新用户界面未启用"),
        Err(e) => eprintln!("评估功能开关时出错: {:?}", e),
    }

    // 评估字符串型功能开关
    match client.get_string_value("welcome_message", None, None).await {
        Ok(msg) => println!("欢迎消息: {}", msg),
        Err(e) => eprintln!("获取欢迎消息时出错: {:?}", e),
    }

    // 评估数值型功能开关
    match client.get_int_value("max_items_per_page", None, None).await {
        Ok(count) => println!("每页最大项目数: {}", count),
        Err(e) => eprintln!("获取最大项目数时出错: {:?}", e),
    }
}

示例应用

这个仓库包含一个简单的示例应用，您可以使用以下命令运行：

cargo run --example print_eval

关于ConfigCat

ConfigCat是一个功能开关和配置管理服务，允许您将发布与部署分离。您可以在部署后使用ConfigCat仪表板开启/关闭功能。ConfigCat允许您根据地区、电子邮件或任何其他自定义用户属性定位特定用户组。

ConfigCat是一个托管的功能开关服务。管理前端、后端、移动和桌面应用程序中的功能开关。

完整示例代码

以下是一个更完整的示例，展示了如何在实际应用中使用configcat-openfeature-provider：

use std::time::Duration;
use configcat::{Client, PollingMode};
use open_feature::OpenFeature;
use configcat_openfeature_provider::ConfigCatProvider;

#[tokio::main]
async fn main() {
    // 1. 初始化OpenFeature API
    println!("初始化OpenFeature API...");
    let mut api = OpenFeature::singleton_mut().await;

    // 2. 配置ConfigCat客户端
    println!("配置ConfigCat客户端...");
    let configcat_client = Client::builder("YOUR_SDK_KEY")
        .polling_mode(PollingMode::AutoPoll(Duration::from_secs(60))) // 自动轮询模式，60秒更新一次
        .build()
        .expect("创建ConfigCat客户端失败");

    // 3. 设置OpenFeature provider
    println!("设置OpenFeature provider...");
    api.set_provider(ConfigCatProvider::new(configcat_client))
        .await;

    // 4. 创建功能开关客户端
    println!("创建功能开关客户端...");
    let client = api.create_client();

    // 5. 评估各种类型的开关
    println!("开始评估功能开关...");
    
    // 5.1 布尔型开关
    println!("\n评估布尔型开关:");
    evaluate_bool(&client, "new_user_interface").await;
    evaluate_bool(&client, "dark_mode_enabled").await;
    
    // 5.2 字符串型开关
    println!("\n评估字符串型开关:");
    evaluate_string(&client, "welcome_message").await;
    evaluate_string(&client, "special_offer_text").await;
    
    // 5.3 数值型开关
    println!("\n评估数值型开关:");
    evaluate_int(&client, "max_items_per_page").await;
    evaluate_int(&client, "discount_percentage").await;
    
    // 5.4 带默认值的评估
    println!("\n带默认值的评估:");
    let unknown_value = client.get_string_value("unknown_feature", Some("默认值"), None)
        .await
        .unwrap_or("回退值".to_string());
    println!("未知功能开关值: {}", unknown_value);
}

async fn evaluate_bool(client: &open_feature::Client, key: &str) {
    match client.get_bool_value(key, None, None).await {
        Ok(true) => println!("{}: 已启用", key),
        Ok(false) => println!("{}: 未启用", key),
        Err(e) => eprintln!("评估{}时出错: {:?}", key, e),
    }
}

async fn evaluate_string(client: &open_feature::Client, key: &str) {
    match client.get_string_value(key, None, None).await {
        Ok(value) => println!("{}: {}", key, value),
        Err(e) => eprintln!("获取{}时出错: {:?}", key, e),
    }
}

async fn evaluate_int(client: &open_feature::Client, key: &str) {
    match client.get_int_value(key, None, None).await {
        Ok(value) => println!("{}: {}", key, value),
        Err(e) => eprintln!("获取{}时出错: {:?}", key, e),
    }
}

这个完整示例展示了：

1. 初始化OpenFeature API
2. 配置ConfigCat客户端
3. 设置OpenFeature provider
4. 创建功能开关客户端
5. 评估各种类型的开关（布尔型、字符串型、数值型）
6. 带默认值的评估
7. 将评估逻辑封装为可重用函数

您可以根据实际需求修改和扩展这个示例。