Extensions.Configuration 0.0.4

Extensions.Configuration

Description

This is a umbrella package for two seperate packages

• Extensions.Configuration.Sources.Objects
• Extensions.Configuration.Resolver

Installation

dotnet add package Extensions.Configuration

Extensions.Configuration.Sources.Objects

Description

This package adds functionality to Microsoft.Extensions.Configuration, to use objects as configuration source.

Installation

dotnet add package Microsoft.Extensions.Configuration
dotnet add package Extensions.Configuration.Sources.Objects

Usage

using Microsoft.Extensions.Configuration;

var configuration = new ConfigurationBuilder
    .AddObject(new { K1 = "V1" })
    .Build();

var val = configuration["K1"];
// Returns "V1"

Nesting is supported

var configuration = new ConfigurationBuilder
    .AddObject(new { K1 = new { K2 = "V1" } } })
    .Build();

var val = configuration["K1:K2"];
// Returns "V1"

Extensions.Configuration.Resolver

Description

This package adds functionality to Microsoft.Extensions.Configuration, to resolve substitutions within configuration entries.

Installation

dotnet add package Microsoft.Extensions.Configuration
dotnet add package Extensions.Configuration.Resolver

Usage

Examplary json configuration:

{
  "AppName": "MyApp",
  "UserSettings": "${HOMEPATH}/.{$env:AppName}/settings.json"
}

using Microsoft.Extensions.Configuration;

var configuration = new ConfigurationBuilder
    .AddJsonFile(...)
    .AddEnvironmentVariables()
    .Build();

var userSettingsResolved = configuration.ResolveValue("UserSettings");
// Returns e.g.: "C:\Users\MyUser\.MyApp\settings.json"

Remarks

Supported placeholders:

{$env:KEY}, ${KEY}, $(KEY), %KEY%