insights-rs/examples/advanced_config.rs

/// SDK Configuration Examples
///
/// Shows different ways to configure the Insights Rust SDK for various use cases.
///
/// Run with: cargo run --example advanced_config --features async-client
use insights_rs::{ClientOptionsBuilder, EU_INGESTION_ENDPOINT};

#[cfg(feature = "async-client")]
#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    println!("=== Insights SDK Configuration Examples ===\n");

    // 1. SIMPLEST: Just an API key (uses US endpoint by default)
    println!("1. Basic client (US region):");
    let _basic = insights_rs::client("phc_test_api_key").await;
    println!("   → Created with default settings\n");

    // 2. REGIONAL: EU data residency
    println!("2. EU region client:");
    let _eu = insights_rs::client(("phc_test_api_key", EU_INGESTION_ENDPOINT)).await;
    println!("   → Data stays in EU (GDPR compliant)\n");

    // 3. SELF-HOSTED: Your own Insights instance
    println!("3. Self-hosted instance:");
    let _custom = insights_rs::client(("phc_test_api_key", "https://analytics.mycompany.com")).await;
    println!("   → Uses your private Insights deployment\n");

    // 4. PRODUCTION: Common production settings
    println!("4. Production configuration:");
    let production_config = ClientOptionsBuilder::default()
        .api_key("phc_production_key".to_string())
        .host("https://eu.insights.com") // Auto-detects and uses EU ingestion
        .request_timeout_seconds(30) // 30s timeout
        .disable_geoip(true) // Disable automatic geoip enrichment
        .build()?;

    let _prod = insights_rs::client(production_config).await;
    println!("   → Optimized for production workloads\n");

    // 5. HIGH-PERFORMANCE: Local flag evaluation
    println!("5. High-performance with local evaluation:");
    let performance_config = ClientOptionsBuilder::default()
        .api_key("phc_project_key".to_string())
        .personal_api_key("phx_personal_key") // Required for local eval
        .enable_local_evaluation(true) // Cache flags locally
        .poll_interval_seconds(30) // Update cache every 30s
        .feature_flags_request_timeout_seconds(3)
        .build()?;

    let _perf = insights_rs::client(performance_config).await;
    println!("   → Evaluates flags locally (100x faster)\n");

    println!("Configuration examples complete!");
    println!("\nTip: Check out 'feature_flags' example for flag usage");
    println!("     and 'local_evaluation' for performance optimization.");

    Ok(())
}

#[cfg(not(feature = "async-client"))]
fn main() {
    println!("This example requires the async-client feature.");
    println!("Run with: cargo run --example advanced_config --features async-client");
}