Trico 1.1.7

Trico

trico is a simple configuration library for your .net projects

Status

main
develop
unit tests
version
downloads
license
size

Supported providers

Usage

Step 1. Add Trico services to the service collection

You start with adding trico services to the IServiceCollection

serviceCollection.AddConfiguration();

Step 2. Configure required providers

Add required providers to the IServiceCollection.

Important! Configurations are looked up in providers in the order of registration in service collection.

In-Memory provider

In-Memory configuration provider is a non-persistent short-term storage. Used to work with configurations that are set and used in runtime. In coupe with other providers can also be used as a default application configuration
To add provider to your application, use:

serviceProvider.AddInMemoryProvider();

Initial set of configurations can be set by passing Dictionary<string, string> into the method:

Dictionary<string, string> defaultConfigs = GetDefaultConfigs();
serviceProvider.AddInMemoryProvider(defaultConfigs);

File provider

File configuration provider is a persistent long-term storage.
To add provider to your application, use:

serviceCollection.AddFileProvider();

Load params:

Environment variable provider

Environment variable configuration provider is a non-persistent long-term storage. Allows to import application configurations from environment variables, but can't update them.
To add provider to your application, use:

serviceCollection.AddEnvironmentVariableProvider();

Load params:

Step 3. Explicitly load configurations

Load configurations either asynchronously:

Dictionary<string, string> options = new Dictionary<string, string>() {
    { "config-filepath", "..." },
    { "prefix", "" },
}
await config.LoadAsync(options, default);

Step 4. Use configurations

var value = config["key"];

More info

refer to the Playground project