Struct RuntimeLoadOptions 

#[non_exhaustive]
pub struct RuntimeLoadOptions {
    pub include_env: bool,
    pub include_config_file: bool,
    pub bootstrap_mode: RuntimeBootstrapMode,
}

Source-loading policy for runtime config bootstrap.

This is the caller-facing switchboard for how much ambient process state the normal runtime bootstrap path may consult before config resolution runs.

Use RuntimeLoadOptions::new for the normal host path, then selectively disable environment or config-file inputs for test or embedding scenarios. Use RuntimeLoadOptions::defaults_only when the goal is a sealed config bootstrap that ignores environment-derived defaults and path discovery.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

include_env: bool

Whether environment-derived layers should be loaded.

include_config_file: bool

Whether the ordinary config file should be loaded.

This does not disable the secrets layer; secrets files and secret environment overrides still participate through the secrets pipeline.

bootstrap_mode: RuntimeBootstrapMode

Controls whether bootstrap may consult ambient environment and platform-derived paths before the loader pipeline runs.

Implementations

impl RuntimeLoadOptions

pub fn new() -> Self

Creates runtime-load options with the default source set enabled.

pub fn defaults_only() -> Self

Creates a sealed bootstrap policy that uses only built-in defaults plus explicit in-memory layers.

pub fn with_env(self, include_env: bool) -> Self

Sets whether environment-derived layers should be loaded.

The default is true.

pub fn with_config_file(self, include_config_file: bool) -> Self

Sets whether the ordinary config file should be loaded.

The default is true. This does not disable the secrets layer.

pub fn with_bootstrap_mode(self, bootstrap_mode: RuntimeBootstrapMode) -> Self

Sets whether bootstrap may consult ambient environment and platform-derived paths before the loader pipeline runs.

Switching to RuntimeBootstrapMode::DefaultsOnly also disables the env and config-file loader layers.

pub fn is_defaults_only(self) -> bool

Returns whether the load options seal bootstrap against ambient process and home-directory state.

Trait Implementations

impl Clone for RuntimeLoadOptions

fn clone(&self) -> RuntimeLoadOptions

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RuntimeLoadOptions

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

Formats the value using the given formatter.

impl Default for RuntimeLoadOptions

fn default() -> Self

Returns the “default value” for a type.

impl PartialEq for RuntimeLoadOptions

fn eq(&self, other: &RuntimeLoadOptions) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for RuntimeLoadOptions

impl Eq for RuntimeLoadOptions

impl StructuralPartialEq for RuntimeLoadOptions