Struct AppConfig 

pub struct AppConfig {
    pub server: ServerConfig,
    pub database: Option<GlobalDatabaseConfig>,
    pub logging: LoggingConfig,
    pub opentelemetry: OpenTelemetryConfig,
    pub gears_dir: Option<String>,
    pub gears: HashMap<String, Value>,
    pub vendor: VendorConfig,
}

Main application configuration with strongly-typed global sections and a flexible per-gear configuration bag.

Fields

server: ServerConfig

Core server configuration.

database: Option<GlobalDatabaseConfig>

New typed database configuration (optional).

logging: LoggingConfig

Logging configuration

opentelemetry: OpenTelemetryConfig

OpenTelemetry configuration (resource, tracing, metrics).

gears_dir: Option<String>

Directory containing per-gear YAML files (optional).

gears: HashMap<String, Value>

Per-gear configuration bag: gear_name → arbitrary JSON/YAML value.

vendor: VendorConfig

Per-vendor configuration bag: vendor_name → arbitrary JSON/YAML value. Allows vendors to add their own typed configuration sections.

Implementations

impl AppConfig

pub fn load_layered(config_path: &PathBuf) -> Result<Self>

Load configuration with layered loading: defaults → YAML file → environment variables. Also normalizes server.home_dir into an absolute path and creates the directory.

Errors

Returns an error if configuration loading or home_dir resolution fails.

pub fn load_or_default(config_path: Option<&PathBuf>) -> Result<Self>

Load configuration from file or create with default values. Also normalizes server.home_dir into an absolute path and creates the directory.

Errors

Returns an error if configuration loading or home_dir resolution fails.

pub fn to_yaml(&self) -> Result<String>

Serialize configuration to YAML.

Errors

Returns an error if serialization fails.

pub fn vendor_config<T: DeserializeOwned>( &self, vendor_name: &str, ) -> Result<T, VendorConfigError>

Deserialize a vendor configuration section into a typed struct.

Errors

Returns VendorConfigError::NotFound if the vendor is not present, or VendorConfigError::InvalidConfig if deserialization fails.

pub fn vendor_config_or_default<T: DeserializeOwned + Default>( &self, vendor_name: &str, ) -> Result<T, VendorConfigError>

Deserialize a vendor configuration section, returning T::default() if absent.

Errors

Returns VendorConfigError::InvalidConfig if the section exists but cannot be deserialized into T.

pub fn apply_cli_overrides(&mut self, verbose: u8)

Apply overrides from command line arguments.

Trait Implementations

impl Clone for AppConfig

fn clone(&self) -> AppConfig

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl ConfigProvider for AppConfig

fn get_gear_config(&self, gear_name: &str) -> Option<&Value>

Returns raw JSON section for the gear, if any.

impl Debug for AppConfig

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for AppConfig

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for AppConfig

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for AppConfig

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.