Struct spirit_cfg_helpers::CfgDump

pub struct CfgDump { /* fields omitted */ }

A command line fragment to add --dump-config to allow showing loaded configuration.

When this is added into the command line options structure, the --dump-config and --dump-config-as options are added.

These dump the current configuration and exit.

In case the configuration is collected over multiple configuration files, directories and possibly environment variables and command line overrides, it is not always clear what exact configuration is actually used. This allows the user to query the actual configuration the application would use.

The fragment can be either used manually with the dump method or automatically by registering its extension.

Requirements

For this to work, the configuration structure must implement Serialize. This is not mandated by Spirit itself. However, all the fragments provided by spirit crates implement it. For custom structures it is often sufficient to stick #[derive(Serialize)] onto them.

Examples

use serde_derive::{Deserialize, Serialize};
use spirit::Spirit;
use spirit::prelude::*;
use spirit_cfg_helpers::CfgDump;
use structopt::StructOpt;

#[derive(Default, Deserialize, Serialize)]
struct Cfg {
    option: Option<String>,
}

#[derive(Debug, StructOpt)]
struct Opts {
    #[structopt(flatten)]
    dump: CfgDump,
}

impl Opts {
    fn dump(&self) -> &CfgDump {
        &self.dump
    }
}

fn main() {
    Spirit::<Opts, Cfg>::new()
        .with(CfgDump::extension(Opts::dump))
        .run(|_| Ok(()));
}

Implementations

impl CfgDump

pub fn dump<C: Serialize>(&self, cfg: &C)

Dump configuration if it is asked for in the options.

If the parsed options specify to dump the configuration, this does so and exits. If the options don't specify that, it does nothing.

This can be used manually. However, the common way is to register the extension within an Extensible (either spirit::Spirit or spirit::Builder) and let it do everything automatically.

pub fn extension<E, F>(extract: F) -> impl Extension<E> where
    E: Extensible<Ok = E>,
    F: FnOnce(&E::Opts) -> &Self + Send + 'static,
    E::Config: Serialize, 

An extension that can be registered with Extensible::with.

The parameter is an extractor, a function that takes the whole command line options structure and returns a reference to just the CfgDump instance in there.

Note that for configuration to be dumped, it needs to be parsed first. Therefore it'll fail to dump it if the configuration is invalid.

Also, as this exits if the dumping is requested, it makes some sense to register it sooner than later. It registers itself as a config_validator and it is not needed to validate parts of the configuration only to throw it out on the exit.

Trait Implementations

impl Clone for CfgDump

fn clone(&self) -> CfgDump

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for CfgDump

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

Formats the value using the given formatter.

impl Default for CfgDump

fn default() -> CfgDump

Returns the "default value" for a type.

impl StructOpt for CfgDump

fn clap<'a, 'b>() -> App<'a, 'b>

Returns clap::App corresponding to the struct.

fn from_clap(matches: &ArgMatches<'_>) -> Self

Builds the struct from clap::ArgMatches. It's guaranteed to succeed if matches originates from an App generated by StructOpt::clap called on the same type, otherwise it must panic.

fn from_args() -> Self

Builds the struct from the command line arguments (std::env::args_os). Calls clap::Error::exit on failure, printing the error message and aborting the program.

fn from_args_safe() -> Result<Self, Error>

Builds the struct from the command line arguments (std::env::args_os). Unlike StructOpt::from_args, returns clap::Error on failure instead of aborting the program, so calling .exit is up to you.

fn from_iter<I>(iter: I) -> Self where
    I: IntoIterator,
    <I as IntoIterator>::Item: Into<OsString>,
    <I as IntoIterator>::Item: Clone, 

Gets the struct from any iterator such as a Vec of your making. Print the error message and quit the program in case of failure.

fn from_iter_safe<I>(iter: I) -> Result<Self, Error> where
    I: IntoIterator,
    <I as IntoIterator>::Item: Into<OsString>,
    <I as IntoIterator>::Item: Clone, 

Gets the struct from any iterator such as a Vec of your making.

impl StructOptInternal for CfgDump

fn augment_clap<'a, 'b>(app: App<'a, 'b>) -> App<'a, 'b>

fn is_subcommand() -> bool

fn from_subcommand(_sub: (&'b str, Option<&'b ArgMatches<'a>>)) -> Option<Self>