Skip to main content

hyprstream_metrics/
config.rs

1//! Configuration management for hyprstream-metrics library.
2//!
3//! This module provides configuration structures for storage backends,
4//! caching, and aggregation settings.
5
6use serde::{Deserialize, Serialize};
7use std::collections::HashMap;
8
9/// Storage backend configuration
10#[derive(Debug, Clone, Deserialize, Serialize, Default)]
11pub struct StorageConfig {
12    /// Storage engine type: "duckdb", "adbc", or "cached"
13    #[serde(default = "default_engine")]
14    pub engine: String,
15    /// Connection string for the storage backend
16    #[serde(default)]
17    pub connection_string: String,
18    /// Additional engine-specific options
19    #[serde(default)]
20    pub options: HashMap<String, String>,
21}
22
23fn default_engine() -> String {
24    "duckdb".to_owned()
25}
26
27/// Cache configuration for cached storage backends
28#[derive(Debug, Clone, Deserialize, Serialize)]
29pub struct CacheConfig {
30    /// Maximum duration in seconds for cached data
31    #[serde(default = "default_max_duration")]
32    pub max_duration_secs: u64,
33    /// Store engine type for persistent storage
34    #[serde(default = "default_engine")]
35    pub store_engine: String,
36}
37
38fn default_max_duration() -> u64 {
39    3600
40}
41
42impl Default for CacheConfig {
43    fn default() -> Self {
44        Self {
45            max_duration_secs: default_max_duration(),
46            store_engine: default_engine(),
47        }
48    }
49}
50
51/// Aggregation configuration
52#[derive(Debug, Clone, Deserialize, Serialize, Default)]
53pub struct AggregationConfig {
54    /// Default time window size in seconds
55    #[serde(default = "default_window_size")]
56    pub default_window_size_secs: u64,
57    /// Maximum number of concurrent aggregations
58    #[serde(default = "default_max_aggregations")]
59    pub max_concurrent_aggregations: usize,
60}
61
62fn default_window_size() -> u64 {
63    60
64}
65
66fn default_max_aggregations() -> usize {
67    100
68}
69
70/// Complete library configuration
71#[derive(Debug, Clone, Deserialize, Serialize, Default)]
72pub struct MetricsConfig {
73    /// Storage backend configuration
74    #[serde(default)]
75    pub storage: StorageConfig,
76    /// Cache configuration
77    #[serde(default)]
78    pub cache: CacheConfig,
79    /// Aggregation configuration
80    #[serde(default)]
81    pub aggregation: AggregationConfig,
82}