Struct ConfigurationManager 

pub struct ConfigurationManager {
    ConfigPath: Option<PathBuf>,
    BackupDir: Option<PathBuf>,
    EnableBackup: bool,
    EnvPrefix: String,
}

Configuration manager with comprehensive validation, backup, and hot-reload support

Fields

ConfigPath: Option<PathBuf>

Path to configuration file

BackupDir: Option<PathBuf>

Backup configuration directory

EnableBackup: bool

Enable configuration backup

EnvPrefix: String

Environment variable prefix for overrides

Implementations

impl ConfigurationManager

pub fn New(ConfigPath: Option<String>) -> Result<Self>

Create a new configuration manager

Arguments

• ConfigPath - Optional path to configuration file. If None, uses default location

Returns

Returns a new ConfigurationManager instance

pub fn NewWithSettings( ConfigPath: Option<String>, EnableBackup: bool, EnvPrefix: String, ) -> Result<Self>

Create a new configuration manager with custom settings

Arguments

• ConfigPath - Optional path to configuration file
• EnableBackup - Whether to enable automatic backups
• EnvPrefix - Prefix for environment variable overrides

pub async fn LoadConfiguration(&self) -> Result<AirConfiguration>

Load configuration from file, environment, or create default

This method implements the configuration priority chain:

1. Defaults from code
2. Configuration file
3. Environment variables (with prefix)

Returns

Validated and loaded configuration

async fn LoadFromFile(&self, path: &Path) -> Result<AirConfiguration>

Load configuration from a specific file

Arguments

• path - Path to the configuration file

Returns

Parsed and validated configuration

pub async fn SaveConfiguration(&self, config: &AirConfiguration) -> Result<()>

Save configuration to file with backup and atomic write

Arguments

• config - Configuration to save

Implementation Details

• Validates configuration before saving
• Creates backup if enabled
• Uses atomic write (write to temp file, then rename)
• Creates parent directories if needed

fn ValidateConfiguration(&self, config: &AirConfiguration) -> Result<()>

Validate configuration with comprehensive checks

Performs:

• Schema validation
• Type checking with detailed errors
• Range validation for numeric values
• Path validation for security
• URL validation for network resources

fn ValidateSchemaVersion(&self, version: &str) -> Result<()>

Validate schema version format

fn ValidateProfile(&self, profile: &str) -> Result<()>

Validate profile name

fn ValidategRPCConfig(&self, grpc: &gRPCConfig) -> Result<()>

Validate gRPC configuration with range checking

fn ValidateAuthConfig(&self, auth: &AuthConfig) -> Result<()>

Validate authentication configuration

fn ValidateUpdateConfig(&self, updates: &UpdateConfig) -> Result<()>

Validate update configuration

fn ValidateDownloadConfig(&self, downloader: &DownloadConfig) -> Result<()>

Validate download configuration

fn ValidateIndexingConfig(&self, indexing: &IndexingConfig) -> Result<()>

Validate indexing configuration

fn ValidateLoggingConfig(&self, logging: &LoggingConfig) -> Result<()>

Validate logging configuration

fn ValidatePerformanceConfig( &self, performance: &PerformanceConfig, ) -> Result<()>

Validate performance configuration

fn ValidatePath(&self, path: &str) -> Result<()>

Validate path for security (prevent directory traversal)

fn IsValidAddress(addr: &str) -> bool

Validate address format (IP:port or hostname:port)

fn IsValidUrl(url: &str) -> bool

Validate URL format

fn SchemaValidate(&self, config: &AirConfiguration) -> Result<()>

Perform schema-based validation

fn ApplyEnvironmentOverrides(&self, config: &mut AirConfiguration) -> Result<()>

Apply environment variable overrides to configuration

Environment variables are read with the configured prefix. For example, with prefix “AIR_”, the variable “AIR_GRPC_BIND_ADDRESS” would override grpc.bind_address.

Variable naming convention: {PREFIX}{SECTION}{FIELD} (uppercase, underscores)

async fn BackupConfiguration(&self, config_path: &Path) -> Result<()>

Backup current configuration file

Creates a timestamped backup of the current configuration file in the configured backup directory.

pub async fn RollbackConfiguration(&self) -> Result<PathBuf>

Rollback configuration from the most recent backup

Returns

Returns the path to the backup file that was restored

fn GetConfigPath(&self) -> Result<PathBuf>

Get the configuration file path

Returns the configured path or the default path

fn GetDefaultConfigPath() -> Result<PathBuf>

Get default configuration file path

Returns the default configuration file path in the user’s config directory

pub fn GetProfileDefaults(profile: &str) -> AirConfiguration

Get profile-specific default configuration

Arguments

• profile - Profile name (dev, staging, prod, custom)

Returns

Configuration with profile-appropriate defaults

pub fn ExpandPath(path: &str) -> Result<PathBuf>

Expand path with home directory (~) expansion

Arguments

• path - Path string to expand

Returns

Expanded PathBuf

pub fn ComputeHash(config: &AirConfiguration) -> Result<String>

Generate configuration hash for change detection

Arguments

• config - Configuration to hash

Returns

SHA256 hash of the configuration

pub fn ExportToJson(config: &AirConfiguration) -> Result<String>

Export configuration to JSON (for VSCode compatibility)

Arguments

• config - Configuration to export

Returns

JSON string representation of configuration

pub fn ImportFromJson(json_str: &str) -> Result<AirConfiguration>

Import configuration from JSON (for VSCode compatibility)

Arguments

• json_str - JSON string to import

Returns

Parsed and validated configuration

pub fn GetEnvironmentMappings(&self) -> HashMap<String, String>

Get environment variable mappings

Returns a mapping of configuration paths to environment variable names