Struct ConfigOptions 

pub struct ConfigOptions {
    pub env_prefix: String,
    pub app_env: Option<String>,
    pub app_name: Option<String>,
    pub config_paths: Vec<PathBuf>,
    pub load_dotenv: bool,
    pub load_home_dotenv: bool,
}

Configuration options.

Fields

env_prefix: String

Environment variable prefix (e.g., “MYAPP” for MYAPP_DATABASE_HOST).

app_env: Option<String>

Override the detected app environment (dev, staging, prod).

app_name: Option<String>

Application name for user-scoped config discovery.

When set, enables searching ~/.config/{app_name}/ for config files. Falls back to APP_NAME or HYPERI_LIB_APP_NAME environment variables if not explicitly provided.

Default: None (user config directory not searched)

config_paths: Vec<PathBuf>

Additional paths to search for config files.

load_dotenv: bool

Whether to load .env files.

When enabled, loads .env files in this order (lowest to highest priority):

1. ~/.env (home directory - global defaults)
2. Project .env (current directory - project overrides)

Later files override earlier ones. Real environment variables always take precedence over .env values.

load_home_dotenv: bool

Whether to load home directory .env file (~/.env).

Only applies when load_dotenv is true. Default: false (opt-in, matching hyperi-pylib)

Trait Implementations

impl Clone for ConfigOptions

fn clone(&self) -> ConfigOptions

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ConfigOptions

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

Formats the value using the given formatter.

impl Default for ConfigOptions

fn default() -> Self

Returns the “default value” for a type.