DotNetCore.Configuration.Formatter
5.0.1
See the version list below for details.
dotnet add package DotNetCore.Configuration.Formatter --version 5.0.1
NuGet\Install-Package DotNetCore.Configuration.Formatter -Version 5.0.1
<PackageReference Include="DotNetCore.Configuration.Formatter" Version="5.0.1" />
paket add DotNetCore.Configuration.Formatter --version 5.0.1
#r "nuget: DotNetCore.Configuration.Formatter, 5.0.1"
// Install DotNetCore.Configuration.Formatter as a Cake Addin #addin nuget:?package=DotNetCore.Configuration.Formatter&version=5.0.1 // Install DotNetCore.Configuration.Formatter as a Cake Tool #tool nuget:?package=DotNetCore.Configuration.Formatter&version=5.0.1
DotNetCore Configuration Templates
DotNetCore.Configuration.Formatter is a simple Configuration ASP.NET Core Templates for Microsoft.Extensions.Configuration. It is used various Configuration Providers for generating configuration value text output by substituting Configuration Key with its Value.
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.
Nuget.org
- Nuget package DotNetCore.Configuration.Formatter
Annotation format syntax
Annotation | Definition |
---|---|
{Key} | If the Key reference will be located/resolved it will be replaced with a value. |
If {Key} is not found | The reference will not be located it will be replaced with the '?NotFound?`. |
{Key??Default} | If the Key reference will not be located in it will be replaced with the Default. |
{{{Key3}Key2}Key1} | Supports recursive references substitution, it will be replaced with a final constructed reference value. |
How to use
For example 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?"
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net5.0 is compatible. net5.0-windows was computed. net6.0 was computed. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 was computed. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. |
-
net5.0
- No dependencies.
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
Version | Downloads | Last updated |
---|---|---|
9.0.0 | 85 | 12/8/2024 |
8.0.0 | 808 | 11/18/2023 |
7.2.1 | 227 | 4/22/2023 |
7.1.1 | 291 | 3/8/2023 |
7.0.2 | 333 | 12/15/2022 |
7.0.0 | 561 | 11/12/2022 |
6.4.1 | 252 | 4/22/2023 |
6.3.1 | 263 | 3/8/2023 |
6.2.2 | 337 | 12/15/2022 |
6.1.1 | 501 | 2/13/2022 |
6.0.2 | 310 | 12/28/2021 |
6.0.1 | 1,108 | 12/1/2021 |
6.0.0 | 363 | 11/16/2021 |
5.0.1 | 440 | 3/11/2021 |
3.1.1 | 408 | 3/11/2021 |
Supports only net 5.0