NetLah.Extensions.Configuration is a library which contains a set of reusable classes for build configuration with environment. These library classes are ConfigurationBuilderBuilder, CertificateLoader and ConnectionStringManager.
Nuget package
Build Status
Getting started
ConsoleApp
public static void Main(string[] args)
{
var configuration = ConfigurationBuilderBuilder.Create<Program>(args).Build();
var defaultConnectionString = configuration.GetConnectionString("DefaultConnection");
Console.WriteLine($"[TRACE] ConnectionString: {defaultConnectionString}");
}
Host configuration from environment variables by prefix DOTNET_ and ASPNETCORE_
Chanined configuration (if any)
In memory configuration (if any)
appsettings.json using the JSON configuration provider
appsettings.EnvironmentName.json using the JSON configuration provider
Other extra configuration sources
App secrets when the app runs in the Development environment
Environment variables using the Environment Variables configuration provider
Command-line arguments using the Command-line configuration provider
BasePath of configuration files
The application binary folder is default basePath for appsettings.json, appsettings.Production.json,etc. In case want to change current directory as basePath:
var configuration = new ConfigurationBuilderBuilder()
.WithCurrentDirectory()
.Build();
Environment name
Production environmentName by default if no host environmentName configuration
ConfigurationBuilderBuilder will detect EnvironmentName by add configuration environment variables with prefix DOTNET_ and ASPNETCORE_. If no environment variable set, Production will use by default. Example of environment variables:
ASPNETCORE_ENVIRONMENT = Development
DOTNET_ENVIRONMENT = Staging
Specifying environmentName during build configuration
Sometime, we cannot set the environmentName using environment variable, or we need different environment configuration build lik in unit test project, we can specific the environmentName.
var configuration = ConfigurationBuilderBuilder.Create<ConfigurationBuilderBuilderTest>()
.WithEnvironment("Testing")
.Build();
