TaskHub.Shared

Configuration Tools

The TaskHub.Shared.ConfigurationTools module provides extension methods for IConfigurationSection to simplify and safely retrieve configuration values.

Selectors

The Selectors static class provides methods to get values with built-in validation. If a required value is missing or empty, it throws an InvalidOperationException.

Available Methods

• GetString(this IConfigurationSection section, string name): Returns the string value or throws if missing.
• GetBool(this IConfigurationSection section, string name): Returns the boolean value.
• GetInt(this IConfigurationSection section, string name): Returns the integer value.

Usage Example

public class MyServiceOptions
{
    public string ApiKey { get; init; }
    public int TimeoutSeconds { get; init; }

    public MyServiceOptions(IConfiguration configuration)
    {
        var section = configuration.GetSection("MyService");
        ApiKey = section.GetString("ApiKey");
        TimeoutSeconds = section.GetInt("TimeoutSeconds");
    }
}

Configuration Schema (Standard)

Modules in TaskHub.Shared typically follow this schema in appsettings.json:

{
  "Module": {
    "Enabled": true,
    "OptionA": "Value",
    "OptionB": 123
  }
}

Impact of Fields

• Enabled: Often used in Bootstrap classes to conditionally register services.
• Missing Fields: Since Selectors are used, a missing field that is requested via GetString will cause the application to fail during startup (Fail-Fast principle).

This site is open source. Improve this page.