Struct nccl::config::Config

pub struct Config<'a> { /* fields omitted */ }

A nccl configuration

Indexable with &str.

e.g.

// config.nccl:
// server
//     domain
//         example.com
//         www.example.com
//     port
//         80
//         443
//     root
//         /var/www/html

let content = std::fs::read_to_string("examples/config.nccl").unwrap();
let config = parse_config(&content).unwrap();

// get the value of a single node
assert_eq!(Some("/var/www/html"), config["server"]["root"].value());

// value always returns the value of the first child node
assert_eq!(Some("example.com"), config["server"]["domain"].value());

// get multiple values
assert_eq!(
    vec!["example.com", "www.example.com"],
    config["server"]["domain"].values().collect::<Vec<_>>()
);

// parse multiple values
assert_eq!(
    Ok(vec![80, 443]),
    config["server"]["port"]
        .values()
        .map(|value| value.parse::<u16>())
        .collect::<Result<Vec<_>, _>>()
);

Implementations

impl<'a> Config<'a>

pub fn quoted(&self) -> bool

pub fn has_value(&self, value: &str) -> bool

Check whether the config has the node.

pub fn children(&self) -> impl Iterator<Item = &Config<'a>>

Iterator for the children of a node.

pub fn child(&self) -> Option<&Config<'a>>

The first child of the node.

// excerpt of long.nccl:
// strings
//    in which case
//       "just\nuse quotes"
let source = std::fs::read_to_string("examples/long.nccl").unwrap();
let config = parse_config(&source).unwrap();
assert_eq!(
    "just\nuse quotes",
    config["strings"]["in which case:"]
        .child()
        .unwrap()
        .parse_quoted()
        .unwrap()
);

pub fn values(&self) -> impl Iterator<Item = &str>

Iterator for the child values of a node.

pub fn value(&self) -> Option<&'a str>

The first child value of a node.

pub fn parse_quoted(&self) -> Result<String, NcclError>

Parse the string including escape sequences if it’s quoted.

See Config::child.

Trait Implementations

impl<'a> Clone for Config<'a>

fn clone(&self) -> Config<'a>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for Config<'a>

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

Formats the value using the given formatter.

impl Hash for Config<'_>

fn hash<H: Hasher>(&self, state: &mut H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H) where
    H: Hasher, 

Feeds a slice of this type into the given Hasher.

impl<'a> Index<&'_ str> for Config<'a>

type Output = Config<'a>

The returned type after indexing.

fn index(&self, index: &str) -> &Self::Output

Performs the indexing (container[index]) operation.

impl<'a> PartialEq<Config<'a>> for Config<'a>

fn eq(&self, other: &Config<'a>) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Config<'a>) -> bool

This method tests for !=.

impl ToString for Config<'_>

fn to_string(&self) -> String

Converts the given value to a String.

impl<'a> Eq for Config<'a>

impl<'a> StructuralEq for Config<'a>

impl<'a> StructuralPartialEq for Config<'a>