llm-config-core

Core configuration management library for LLM Config Manager with multi-environment support, versioning, and secret management.

Features

Multi-Environment Support: Manage configurations across dev, staging, production, and custom environments
Secret Management: Encrypted storage of sensitive configuration values
Version Control: Track changes and rollback to previous configurations
Namespace Isolation: Organize configurations by application or service
Environment Overrides: Cascade configuration values with environment-specific overrides
Type Safety: Strong typing for configuration values with validation
Async/Await: Full async support with Tokio runtime

Usage

Add this to your Cargo.toml:

[dependencies]
llm-config-core = "0.5.0"
tokio = { version = "1", features = ["full"] }

Quick Start

use llm_config_core::{ConfigManager, Environment};

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    // Initialize configuration manager
    let config = ConfigManager::new("./config-data").await?;

    // Set a configuration value
    config.set(
        "app.database.url",
        "postgres://localhost/mydb",
        Environment::Development
    ).await?;

    // Get a configuration value
    let db_url = config.get("app.database.url", Environment::Development).await?;
    println!("Database URL: {}", db_url);

    Ok(())
}

Secret Management

// Store an encrypted secret
config.set_secret(
    "app.api.key",
    "my-secret-api-key",
    Environment::Production
).await?;

// Retrieve and decrypt the secret
let api_key = config.get_secret("app.api.key", Environment::Production).await?;

Version Control

// Get configuration history
let history = config.get_history("app.database.url").await?;
for version in history {
    println!("Version {}: {}", version.version, version.value);
}

// Rollback to previous version
config.rollback("app.database.url", 5).await?;

Environment Overrides

// Set base configuration
config.set("app.max_connections", "100", Environment::Base).await?;

// Override for production
config.set("app.max_connections", "500", Environment::Production).await?;

// Get with cascade (returns 500 for production, 100 for others)
let max_conns = config.get_with_overrides("app.max_connections", Environment::Production).await?;

Architecture

The core library is built on:

llm-config-storage: Persistent storage backend
llm-config-crypto: Encryption for secrets
Sled: Embedded database for fast access
Tokio: Async runtime for concurrent operations

Performance

Benchmarks on modern hardware:

Configuration retrieval: ~50 µs
Configuration updates: ~100 µs
With encryption: ~120 µs
Batch operations: ~10,000 ops/sec

Minimum Supported Rust Version

This crate requires Rust 1.75 or later.

License

Licensed under the Apache License, Version 2.0. See LICENSE for details.

Contributing

See CONTRIBUTING.md for contribution guidelines.

llm-config-core 0.5.0