Configuration sources

Configuration sources fetch data from storage (local files or remote APIs) and convert it to settings nodes, abstracting away actual data formats such as JSON or YAML.

They are not meant to be consumed directly and should be used in conjunction with a configuration provider (see assign sources to types and obtain settings from provider scenarios).

Sources are also responsible for data change detection. They expose a reactive interface with subscription support:

IObservable<(ISettingsNode settings, Exception error)> Observe();

On each update, triggered either periodically or by an internal event, the source emits a pair: (settings, null) on success or (null, error) on failure. It's not required to deduplicate settings or errors at this level, although it's never wrong to do so.

Sources must never block indefinitely while waiting for data and should rather publish null settings after a short initial timeout.

Sources must be thread-safe and should be designed to support multiple concurrent observers. It is also expected that every new observer would immediately receive a notification with current state upon subscription.

Here are some of the often used source implementations:

• JSON source

• ClusterConfig source

• In-memory object source

It's also possible to implement a custom source.

Related pages

SourcesCombine sourcesScope sourcesNest sourcesTransform sources

Create custom sources

Assign sources to types

Obtain settings from provider