Skip to content

Latest commit

 

History

History
111 lines (81 loc) · 3.95 KB

README.md

File metadata and controls

111 lines (81 loc) · 3.95 KB

Tomlyn.Extensions.Configuration NuGet

TomlConfigurationProvider using Tomlyn

Mostly based on Microsoft.Extensions.Configuration.Json

Usage

// ASP.NET Core
public static IHostBuilder CreateHostBuilder(string[] args) =>
    Host.CreateDefaultBuilder(args)
        .ConfigureAppConfiguration((hostingContext, config) =>
        {
            config.Sources.Clear(); // CreateDefaultBuilder adds default configuration sources like appsettings.json. Here we can remove them

            var env = hostingContext.HostingEnvironment;
            
            bool reloadOnChange = hostingContext.Configuration.GetValue("hostBuilder:reloadConfigOnChange", defaultValue: true);

            config.AddTomlFile("appsettings.toml", optional: true, reloadOnChange: reloadOnChange)
                .AddTomlFile($"appsettings.{env.EnvironmentName}.toml", optional: true, reloadOnChange: reloadOnChange);
                
            if (env.IsDevelopment() && env.ApplicationName is { Length: > 0 })
            {
                var appAssembly = Assembly.Load(new AssemblyName(env.ApplicationName));
                if (appAssembly is not null)
                {
                    config.AddUserSecrets(appAssembly, optional: true, reloadOnChange: reloadOnChange);
                }
            }
            
            config.AddEnvironmentVariables();

            if (args is { Length: > 0 })
            {
                config.AddCommandLine(args);
            }
        })
        .ConfigureWebHostDefaults(webBuilder => { webBuilder.UseStartup<Startup>(); });
        
// Console
var config = new ConfigurationBuilder()
    .AddTomlFile("appsettings.toml", optional: true, reloadOnChange: true)
    .Build();

appsettings.toml

AllowedHosts = "*"

[Logging]

    [Logging.LogLevel]
        Default = "Information"
        Microsoft = "Warning"
        "Microsoft.Hosting.Lifetime" = "Information"

or

AllowedHosts = "*"

[Logging.LogLevel]
Default = "Information"
Microsoft = "Warning"
"Microsoft.Hosting.Lifetime" = "Information"

Then you can access it like Configuration["Logging:LogLevel:Default"].

Binding with IOptions<TOptions> should work too.

Case sensitivity

TOML is case-sensitive but configuration keys aren't. So even though this is accepted when using Tomlyn alone, it's not accepted when using this library and exception will be thrown:

name = "Gina"
Name = "Gina"

Snake Case Keys

TOML file keys usually follow the 'snake_case' naming convention along with 'PascalCase' variables that bind to the keys.

name_of_person = "Gina"
string NameOfPerson = "Gina"

If your .toml file has any 'snake_case' keys, you can use the [RemoveUnderscores] method to modify the keys with underscores after the build and before the bind call.

var configuration = new ConfigurationBuilder()
    .AddTomlFile("sample_with_underscores.toml")
    .Build();

// Modifying keys in the below line
var config = configuration.RemoveUnderscores();

// Bind the new ConfigurationBuilder called 'config' with the class to be bound
config.Bind(sample);

If using 'snake_case' keys, YOU MUST make sure that your C# variables are 'PascalCase' to ensure proper binding.

Alternatives and benchmarks

Another possibly slightly faster alternative is Tommy.Extensions.Configuration.