Tago.Extensions.Configuration 6.0.0

Tago.Extensions.Configuration

Tago.Extensions.Configuration is a powerful .NET Core configuration library that enhances the flexibility of your appsettings.json by allowing dynamic property resolution. With this library, you can reference environment variables and other configuration properties directly within your configuration file, making your application configuration more dynamic and maintainable.

Features

• Environment Variable Resolution: Easily reference environment variables within your appsettings.json.
• Property Chaining: Reference other configuration properties within the same file, enabling complex configurations.
• Seamless Integration: Integrates effortlessly with the standard .NET Core configuration system.

Installation

You can install the package via NuGet Package Manager:

dotnet add package Tago.Extensions.Configuration

Or by using the NuGet Package Manager Console:

Install-Package Tago.Extensions.Configuration

Usage

Basic Setup

To use Tago.Extensions.Configuration, you need to add it to your configuration builder in Program.cs or Startup.cs:

var builder = WebApplication.CreateBuilder(args);

// Add dynamic configuration
builder.Configuration.AddDynamicConfiguration();

var app = builder.Build();

Configuration Example

Here is an example of how you can use dynamic properties in your appsettings.json:

{
  "AppSettings": {
    "Test": "Test",
    "Test2": "{env: TEST}",
    "Test3": "{property: AppSettings:TEST}",
    "Test4": "{property: AppSettings:Test3}",
    "Test5": "{property: AppSettings:Test4} {property: AppSettings:Test2}"
  }
}

Explanation

• Test: A static value.
• Test2: Resolves to the value of the TEST environment variable.
• Test3: Resolves to the value of the Test property within the AppSettings section.
• Test4: Resolves to the value of the Test3 property within the AppSettings section.
• Test5: Combines the values of Test4 and Test2 properties within the AppSettings section.

Accessing Configuration in Code

You can access these configuration values in your application code as usual:

var testValue = builder.Configuration["AppSettings:Test"];
var test2Value = builder.Configuration["AppSettings:Test2"];
var test5Value = builder.Configuration["AppSettings:Test5"];

Handling Missing Properties

By default, if a property or environment variable is not found, the library will throw an exception. You can customize this behavior by providing a fallback value or handling it gracefully in your application.

{
  "AppSettings": {
    "Test6": "{env: NON_EXISTENT_ENV || default_value}"
  }
}

Support

If you encounter any issues or have questions, please email support@tago-solutions.com.

Thank you for using Tago.Extensions.Configuration! We hope it makes your .NET Core configuration management easier and more dynamic.