Struct AppConfig 

pub struct AppConfig {
    pub server: ServerConfig,
    pub cache: CacheConfig,
    pub auth: AuthConfig,
    pub oauth: OAuthConfig,
    pub logging: LoggingConfig,
    pub performance: PerformanceConfig,
}

Application configuration

Contains server, cache, authentication, logging, and performance configuration.

Fields

• server: Server configuration
• cache: Cache configuration
• auth: Authentication configuration (OAuth and API Key)
• logging: Logging configuration
• performance: Performance configuration

Hot Reload Support

The following configuration items support hot reload (runtime update without restart):

• logging section: All fields
• auth section: All fields (including API Key and OAuth)
• cache section: TTL-related fields (default_ttl, crate_docs_ttl_secs, item_docs_ttl_secs, search_results_ttl_secs)
• performance section: rate_limit_per_second, concurrent_request_limit, enable_metrics, enable_response_compression

The following configuration items do not support hot reload (require server restart):

• server section: All fields (host, port, transport_mode, max_connections, etc.)
• cache section: cache_type, memory_size, redis_url (cache initialization parameters)
• performance section: http_client_*, cache_max_size, cache_default_ttl_secs, metrics_port

Fields

server: ServerConfig

Server configuration

cache: CacheConfig

Cache configuration

auth: AuthConfig

Authentication configuration (OAuth and API Key)

oauth: OAuthConfig

OAuth configuration (backwards compatible, prefer using auth.oauth)

logging: LoggingConfig

Logging configuration

performance: PerformanceConfig

Performance configuration

Implementations

impl AppConfig

pub fn from_file<P: AsRef<Path>>(path: P) -> Result<Self, Error>

Load configuration from file

Errors

Returns an error if file does not exist, cannot be read, or format is invalid

pub fn save_to_file<P: AsRef<Path>>(&self, path: P) -> Result<(), Error>

Save configuration to file

Errors

Returns an error if configuration cannot be serialized, directory cannot be created, or file cannot be written

pub fn validate(&self) -> Result<(), Error>

Validate configuration

Errors

Returns an error if configuration is invalid (e.g., empty hostname, invalid port, etc.)

pub fn from_env() -> Result<EnvAppConfig, Error>

Load configuration from environment variables

Returns an EnvAppConfig where all fields are Option<T>, allowing the caller to distinguish between “not set” and “explicitly set”.

Errors

Returns an error if environment variable format is invalid (e.g., non-numeric port)

pub fn merge( file_config: Option<Self>, env_config: Option<EnvAppConfig>, ) -> Self

Merge configuration (environment variables take precedence over file configuration)

Uses Option<T> semantics from EnvAppConfig to determine which values were explicitly set via environment variables. This eliminates fragile hardcoded default comparisons.

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 Debug for AppConfig

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

Formats the value using the given formatter.

impl Default for AppConfig

fn default() -> AppConfig

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.