confers 0.2.2

A modern, type-safe configuration management library with validation, diff, and hot-reload support
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132

// Copyright (c) 2025 Kirky.X
//
// Licensed under the MIT License
// See LICENSE file in the project root for full license information.

/// Security-related constants
pub mod security {
    /// Maximum length for environment variable names (256 characters)
    pub const MAX_ENV_NAME_LENGTH: usize = 256;

    /// Maximum length for environment variable values (4096 characters)
    pub const MAX_ENV_VALUE_LENGTH: usize = 4096;

    /// Maximum length for environment variable names in strict mode (512 characters)
    pub const MAX_ENV_NAME_LENGTH_STRICT: usize = 512;

    /// Maximum length for environment variable values in strict mode (8192 characters)
    pub const MAX_ENV_VALUE_LENGTH_STRICT: usize = 8192;

    /// Maximum length for environment variable values in very strict mode (1024 characters)
    pub const MAX_ENV_VALUE_LENGTH_VERY_STRICT: usize = 1024;
}

/// Encryption-related constants
pub mod encryption {
    /// AES key size in bytes (256 bits)
    pub const AES_KEY_SIZE: usize = 32;

    /// AES key size in bits
    pub const AES_KEY_SIZE_BITS: usize = 256;
}

/// Network-related constants
pub mod network {
    /// Minimum allowed port number (well-known ports)
    pub const MIN_PORT: u16 = 1024;

    /// Maximum allowed port number
    pub const MAX_PORT: u16 = 65535;

    /// Default HTTP request timeout in seconds
    pub const HTTP_TIMEOUT_SECS: u64 = 30;

    /// HTTP connection pool idle timeout in seconds
    pub const HTTP_POOL_IDLE_TIMEOUT_SECS: u64 = 90;

    /// Default provider priority
    pub const DEFAULT_PROVIDER_PRIORITY: u8 = 30;

    /// Default remote config poll interval in seconds
    pub const DEFAULT_POLL_INTERVAL_SECS: u64 = 60;
}

/// Key management constants
pub mod keys {
    /// Key rotation interval in days
    pub const KEY_ROTATION_INTERVAL_DAYS: u64 = 90;

    /// Days before key expiry to notify
    pub const KEY_EXPIRY_NOTIFY_DAYS: u64 = 30;

    /// Number of keys to rotate
    pub const KEY_ROTATION_COUNT: usize = 5;
}

/// Time-related constants
pub mod time {
    /// Seconds in a day
    pub const SECONDS_PER_DAY: u64 = 86400;

    /// Milliseconds in a second
    pub const MILLISECONDS_PER_SECOND: u64 = 1000;

    /// Memory cache duration in milliseconds (1 second)
    /// This balances performance and accuracy for memory monitoring
    pub const MEMORY_CACHE_DURATION_MS: u64 = 1000;

    /// Default wait time for retry operations in milliseconds
    pub const DEFAULT_RETRY_WAIT_MS: u64 = 100;
}

/// Memory-related constants
pub mod memory {
    /// Bytes in a kilobyte
    pub const BYTES_PER_KB: f64 = 1024.0;

    /// Kilobytes in a megabyte
    pub const KB_PER_MB: f64 = 1024.0;

    /// Default memory limit in MB for configuration loading
    pub const DEFAULT_MEMORY_LIMIT_MB: usize = 512;
}

/// Configuration-related constants
pub mod config {
    /// Maximum configuration file size in megabytes
    /// This limit prevents DoS attacks and memory exhaustion
    pub const MAX_CONFIG_SIZE_MB: usize = 10;

    /// Minimum recommended memory limit in MB
    pub const MIN_MEMORY_LIMIT_MB: usize = 100;

    /// Maximum string length for configuration values
    pub const MAX_STRING_LENGTH: usize = 1024;

    /// Maximum array length for configuration values
    pub const MAX_ARRAY_LENGTH: usize = 100;
}

/// UI-related constants
pub mod ui {
    /// Width for separator lines in CLI output
    pub const SEPARATOR_WIDTH: usize = 60;
}

/// Audit-related constants
pub mod audit {
    /// Default maximum audit log file size in megabytes
    pub const DEFAULT_MAX_AUDIT_SIZE_MB: usize = 100;

    /// Default maximum number of archived audit log files
    pub const DEFAULT_MAX_AUDIT_FILES: usize = 10;

    /// Default audit log retention period in days
    pub const DEFAULT_AUDIT_RETENTION_DAYS: usize = 30;

    /// Maximum visible characters for sensitive data masking
    pub const MAX_VISIBLE_LENGTH: usize = 100;

    /// Number of visible characters for sensitive data masking
    pub const VISIBLE_CHARS: usize = 4;
}