Location: Sources.Xml module.

XmlStringSource parses well-formed XML documents from in-memory strings and supports manual external updates:

var source = new XmlStringSource("<xml content>")

source.Push("<xml content>") // update with new content

XmlFileSource parses XML files and automatically watches for changes:

var source = new XmlFileSource("settings/config.xml");

A file that does not exist simply leads to a null node, which implies default settings values unless something is explicitly required.

Related pages

Conversion process obeys the following priority list:

• • Conversion is performed recursively for keys and values;

• • Conversion is performed recursively for sequence elements;

• • Conversion is performed recursively for public instance fields and properties;

Related pages

A lazy constant source does the same but defers the node acquisition until first subscription:

Errors in the provided delegate are propagated via (null, error) notification. It's guaranteed to execute not more than once.

Practical use

Related pages

Related pages

Location: Sources.Yaml module.

YamlStringSource parses well-formed YAML documents from in-memory strings and supports manual external updates:

var source = new YamlStringSource("<yaml content>")

source.Push("<yaml content>") // update with new content

YamlFileSource parses YAML files and automatically watches for changes:

var source = new YamlFileSource("settings/config.yml");

A file that does not exist simply leads to a null node, which implies default settings values unless something is explicitly required.

Related pages

Keys with dots, colons and double underscores are treated as hierarchical and get split into segments:

This source is static and never issues data updates.

Related pages

Location: main sources module.

CommandLineSource converts CLI arguments into settings nodes.

public static void Main(string[] args)
{
    var source = new CommandLineSource(args);
}

It supports 7 syntax options for key-value parameters:

• --key=value

• --key value

• -key=value

• -key value

• /key=value

• /key value

• key=value

Keys with dots (such as a.b.c) are treated as hierarchical and get split into segments:

--throttling.capacity=50 --> { "throttling": { "capacity": "50" } }

Multiple occurrences of the same key are merged into arrays.

This source is static and never issues data updates.

Default keys and values

Standalone keys may optionally be supplied with a default value.

Standalone values may optionally be grouped under default key.

var source = new CommandLineSource(args, "main", "true");

--enable --> { "enable": "true" }
100 200 --> { "main": ["100", "200"] }

Related pages