DotNetCore.Configuration.Formatter 3.1.1

DotNetCore Configuration formatter

Development Supported by JetBrains Open Source Program:

Rider <a href="https://www.jetbrains.com/?from=XmlResult"> <img src="https://github.com/Wallsmedia/XmlResult/blob/master/Logo/rider/logo.png?raw=true" Width="40p" /></a> Fast & powerful, cross platform .NET IDE

ReSharper <a href="https://www.jetbrains.com/?from=XmlResult"> <img src="https://github.com/Wallsmedia/XmlResult/blob/master/Logo/resharper/logo.png?raw=true" Width="40p" /></a> The Visual Studio Extension for .NET Developers

DotNetCore.Configuration.Formatter

Version 3.1.0

• Support SDK v.3.1-*

DotNetCore.Configuration.Formatter is a simple formatter implements configuration-driven templates Microsoft.Extensions.Configuration for generating configuration textual output.

Annotations '{...}' in the template refer to elements of the configuration data structure. It allows to application configuration values to be annotated and formatted with using key values of other configuration sections and providers.

For example referencing to values from "secret" section of configuration provider for Example: "Password":"{secret:db-{{environment}}-password}"

Nuget.org

• Nuget package DotNetCore.Configuration.Formatter

Annotation format syntax

Asp Net Core

The main area of using is to format (i.e. substitute ) configuration values with other value defined in other configuration providers like Azure KeyVault Secrets, AppRuntime.

Example of using

You have the following

Environment Variables set to :

DOTNET_RUNNING_IN_CONTAINER=true

...

host_environmet=datacenter

Secret KeyValaut Configuration Provider loads the following secrets:

DotNetCore.Azure.Configuration.KvSecrets

"secret:BusConnection":"... azure bus endpoint ... ... "

"secret:DbConnection":"... sql connection string ... ... "

"secret:CosmosDbConnection":"... mongo db connection string ... ... "

Web Service has the following appsettings.json:

{
  ApplicationConfiguration:{
     "IsDocker": "{DOTNET_RUNNING_IN_CONTAINER??false}",
     "RunLocation":"{host_environmet??local}"
     "BusConnection":"{secret:BusConnection}"
     "DbConnection":"{secret:DbConnection}",
     "CosmosDbConnection":"{secret:CosmosDbConnection}"
  }
}

Web Service has the ApplicationConfiguration.cs

public class ApplicationConfiguration 
{
     public bool IsDocker {get; set;}
     public string RunLocation {get; set;}
     public string BusConnection {get; set;}
     public string DbConnection {get; set;}
     public string CosmosDbConnection {get; set;}
}

Web Service has the Startup.cs

     var applicationConfig = Configuration.UseFormater()
     .GetSection(nameof(ApplicationConfiguration))
     .Get<ApplicationConfiguration>();

or with shorthand

     var applicationConfig = Configuration.GetTypeNameFormatted<ApplicationConfiguration>();

The Web Service will be provided with filly resolved configuration with Azure Key Vault secrets.

Dot Net Core

Example for a string formatting:

 var keyValues = new Dictionary<string, string>()
 {
     ["Key-1"] = "Value-1",
     ["Key-Value-1"] = "Complex-Value-1"
 };
 var format = "Get the {Key-1} and complex: {Key-{Key-1}} and {none??Default} and {NotFound}";
 var formatted = format.FormatString(keyValues);

Formated string will be 
    "Get the Value-1 and complex: Complex-Value-1 and Default ?NotFound?"