Struct Loader 

pub struct Loader { /* private fields */ }

Service for loading configuration from sources.

The Loader is responsible for:

• Loading raw content from sources
• Detecting and parsing formats
• Converting to typed configuration

Implementations

impl Loader

pub fn new() -> Self

Create a new Loader with default options.

pub fn builder() -> LoaderBuilder

Create a builder for constructing a Loader.

pub fn options(&self) -> &LoadOptions

Get the load options.

pub fn load_raw<S: Source>(&self, source: &S) -> Result<RawContent>

Load raw content from a source.

Errors

Returns an error if the source cannot be read.

pub fn load<S: Source>(&self, source: &S) -> Result<ParsedContent>

Load and parse content from a source.

Errors

Returns an error if loading or parsing fails.

pub fn load_as<S: Source, T: DeserializeOwned>(&self, source: &S) -> Result<T>

Load and parse content from a source into a specific type.

Errors

Returns an error if loading, parsing, or deserialization fails.

pub fn parse(&self, raw: &RawContent, format: Format) -> Result<ParsedContent>

Parse raw content using a specific format.

Errors

Returns an error if parsing fails.

pub fn parse_raw( &self, raw: RawContent, detected_format: Option<Format>, ) -> Result<ParsedContent>

Parse raw content, detecting the format.

Errors

Returns an error if parsing fails or format cannot be detected.

pub fn merge(&self, contents: Vec<ParsedContent>) -> ParsedContent

Merge multiple parsed contents.

Uses the merge strategy from options.

pub fn to_type<T: DeserializeOwned>(&self, content: ParsedContent) -> Result<T>

Convert parsed content to a specific type.

Errors

Returns an error if deserialization fails.

pub fn load_multiple<S: Source>(&self, sources: &[S]) -> Result<ParsedContent>

Load from multiple sources and merge.

Sources are loaded in order and merged according to the merge strategy. Optional sources that fail are skipped if ignore_optional_missing is true.

Errors

Returns an error if a required source fails and fail_fast is true.

Trait Implementations

impl Clone for Loader

fn clone(&self) -> Loader

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Loader

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

Formats the value using the given formatter.

impl Default for Loader

fn default() -> Self

Returns the “default value” for a type.