Struct ConfigStore

pub struct ConfigStore { /* private fields */ }

A Compute Config Store.

Implementations

impl ConfigStore

pub fn open(name: &str) -> Self

Open a config store, given its name.

Examples

let merriam = ConfigStore::open("merriam webster");
let oed = ConfigStore::open("oxford english config store");

pub fn try_open(name: &str) -> Result<Self, OpenError>

Try to open a config store, given its name.

Examples

let merriam = ConfigStore::try_open("merriam webster").unwrap();

pub fn get(&self, key: &str) -> Option<String>

Lookup a value in this config store.

If successful, this function returns Some(_) if an entry was found, or None if no entry with the given key was found.

Examples

assert_eq!(
     config_store.get("bread"),
     Some(String::from("a usually baked and leavened food")),
);
assert_eq!(
    config_store.get("freedom"),
    Some(String::from("the absence of necessity, coercion, or constraint")),
);

// Otherwise, `get` will return nothing.
assert!(config_store.get("zzzzz").is_none());

Panics

This may panic for any of the reasons that ConfigStore::try_get would return an error.

pub fn try_get(&self, key: &str) -> Result<Option<String>, LookupError>

Try to lookup a value in this Config Store.

If successful, this function returns Ok(Some(_)) if an entry was found, or Ok(None) if no entry with the given key was found. This function returns Err(_) if the lookup failed.

Examples

assert_eq!(
     config_store.try_get("bread").unwrap(),
     Some(String::from("a usually baked and leavened food")),
);
assert_eq!(
    config_store.try_get("freedom").unwrap(),
    Some(String::from("the absence of necessity, coercion, or constraint")),
);

// Otherwise, `try_get` will return nothing.
assert!(config_store.try_get("zzzzz").unwrap().is_none());

pub fn contains(&self, key: &str) -> bool

Return true if the config_store contains an entry with the given key.

Examples

assert!(config_store.contains("key"));

Panics

This may panic for any of the reasons that ConfigStore::try_get would return an error.