Files

ruv 7092f83b34 chore: add workspace metadata and crate READMEs for publishing

Add license, authors, repository, documentation, keywords, categories,
and readme fields to all crate Cargo.toml files. Add crate-level README
files for documentation.

Co-Authored-By: claude-flow <ruv@ruv.net>

2026-03-01 01:39:36 -05:00

2.8 KiB

Raw Blame History

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

Crate	Role
`wifi-densepose-core`	Shared types and traits
`wifi-densepose-api`	REST API (consumer)
`wifi-densepose-db`	Database layer (consumer)
`wifi-densepose-cli`	CLI (consumer)
`wifi-densepose-sensing-server`	Sensing server (consumer)

License

MIT OR Apache-2.0

2.8 KiB Raw Blame History