wifi-densepose-config

Configuration management for the WiFi-DensePose pose estimation system.

Overview

wifi-densepose-config provides a unified configuration layer that merges values from environment variables, TOML/YAML files, and CLI overrides into strongly-typed Rust structs. Built on the config, dotenvy, and envy ecosystem from the workspace.

Status: This crate is currently a stub. The intended API surface is documented below.

Planned Features

• Multi-source loading -- Merge configuration from .env, TOML files, YAML files, and environment variables with well-defined precedence.
• Typed configuration -- Strongly-typed structs for server, signal processing, neural network, hardware, and database settings.
• Validation -- Schema validation with human-readable error messages on startup.
• Hot reload -- Watch configuration files for changes and notify dependent services.
• Profile support -- Named profiles (development, production, testing) with per-profile overrides.
• Secret filtering -- Redact sensitive values (API keys, database passwords) in logs and debug output.

Quick Start

// Intended usage (not yet implemented)
use wifi_densepose_config::AppConfig;

fn main() -> anyhow::Result<()> {
    // Loads from env, config.toml, and CLI overrides
    let config = AppConfig::load()?;

    println!("Server bind: {}", config.server.bind_address);
    println!("CSI sample rate: {} Hz", config.signal.sample_rate);
    println!("Model path: {}", config.nn.model_path.display());

    Ok(())
}

Planned Configuration Structure

# config.toml

[server]
bind_address = "0.0.0.0:3000"
websocket_path = "/ws/poses"

[signal]
sample_rate = 100
subcarrier_count = 56
hampel_window = 5

[nn]
model_path = "./models/densepose.rvf"
backend = "ort"        # ort | candle | tch
batch_size = 8

[hardware]
esp32_udp_port = 5005
serial_baud = 921600

[database]
url = "sqlite://data/wifi-densepose.db"
max_connections = 5

Related Crates

License

MIT OR Apache-2.0