IeuanWalker.AppSettings 0.0.1-Preview.8

AppSettings

Automatically generates the registration code for IOptions and can optionally validate them on startup using fluent validation.

How to use it?

1. Install the NuGet package into your project.

Install-Package IeuanWalker.AppSettings

2. Inherit the IAppSettings interface onto the class that models your IOptions

public class ConfirmationEmailSettings : IAppSettings
{
	public required string Subject { get; set; }
}

3. Register the app settings

   Once IAppSettings has been added to a class in your project, several extension methods will automatically be created. The extension method name convention is AddAppSettingsFrom + your assembly name, and the namespace is your assembly name.

   3.1 An extension method for IServiceCollection is created for all project types by default

   builder.Services.AddAppSettingsFromApiProjectNestedClassLibrary(builder.Configuration);
   

   3.2 If your project is a backend/blazor project, then it will also have an extension method for IHostApplicationBuilder, allowing you to easily chain the registration in your progam.cs

   builder.AddAppSettingsFromApiProject();
   

   3.3 If it's a MAUI project, it will also have an extension method for MauiAppBuilder, allowing you to easily chain the registration in your MauiProgam.cs

   builder.AddAppSettingsFromMauiProject();
   

Section name

By default, it maps the IOptions model to the section name based on the name of the model. For example, the following model -

public class ConfirmationEmailSettings : IAppSettings
{
	public required string Subject { get; set; }
}

Would automatically map to the following app setting section -

{
  "ConfirmationEmailSettings": {
    "Subject": "Test subject"
  }
}

If your model name and configuration section don't match or you want to bind a nested configuration, you can override this within your model by setting the SectionName property

public class ConfirmationEmailSettings : IAppSettings
{
    public static string? SectionName => "ConfirmationEmail";
    public required string Subject { get; set; }
}

public class ConfirmationEmailSettings : IAppSettings
{
    public static string? SectionName => "NestedConfiguration:ConfirmationEmail";
    public required string Subject { get; set; }
}

Validation

To perform validation on startup using Fluent Validation, you just need to create an AbstractValidator for your app settings model and add that validator to the IAppSettings inheritance.

public class ConfirmationEmailSettings : IAppSettings<ConfirmationEmailSettingsValidator>
{
	public required string Subject { get; set; }
}

sealed class ConfirmationEmailSettingsValidator : AbstractValidator<ConfirmationEmailSettings>
{
	public ConfirmationEmailSettingsValidator()
	{
		RuleFor(x => x.Subject)
			.NotEmpty()
			.MinimumLength(5);
	}
}

What does the error look like?

If something fails validation as the application starts up, you will get an exception explaining the exact issue -

Considerations

I do not recommend adding validation to a MAUI project as it can/ will slow startup.