Struct spirit::cfg_loader::Builder

pub struct Builder { /* fields omitted */ }

A builder for the Loader.

See the module documentation for details about the use.

Methods

impl Builder

pub fn new() -> Self

Creates a new config loader builder.

pub fn build<O: StructOpt>(self) -> (O, Loader)

Turns the builder into the Loader.

This parses the command line options ‒ the ones specified by the type parameter, enriched by options related to configuration (paths to config files and config overrides).

This returns the parsed options and the loader.

If the command line parsing fails, the application terminates (and prints relevant help).

pub fn build_no_opts(self) -> Loader

Turns this into the Loader, without command line parsing.

It is similar to build, but doesn't parse the command line, therefore only the config_default_paths are used to find the config files.

This is likely useful for tests.

Trait Implementations

impl ConfigBuilder for Builder

fn config_defaults<D: Into<String>>(self, config: D) -> Self

Specifies the default configuration.

fn config_default_paths<P, I>(self, paths: I) -> Self where
    I: IntoIterator<Item = P>,
    P: Into<PathBuf>, 

Sets the configuration paths in case the user doesn't provide any.

fn config_env<E: Into<String>>(self, env: E) -> Self

Enables loading configuration from environment variables.

fn config_filter<F: FnMut(&Path) -> bool + Send + 'static>(
    self,
    filter: F
) -> Self

Sets a configuration dir filter.

fn config_defaults_typed<C: Serialize>(self, config: &C) -> Result<Self, Error>

Specifies the default configuration as typed value.

fn config_ext<E: Into<OsString>>(self, ext: E) -> Self

Configures a config dir filter for a single extension.

fn config_exts<I, E>(self, exts: I) -> Self where
    I: IntoIterator<Item = E>,
    E: Into<OsString>, 

Configures a config dir filter for multiple extensions.

impl Default for Builder

fn default() -> Self

Returns the "default value" for a type.