Baubit.Logging.DI 2025.49.1

Baubit.Logging.DI

<br/> <br/>

Overview

DI extension for Microsoft.Extensions.Logging. Enables registration of ILoggerFactory with configurable logging providers (Console, Debug) driven by configuration.

Installation

dotnet add package Baubit.Logging.DI

Or via NuGet Package Manager:

Install-Package Baubit.Logging.DI

Quick Start

Baubit.Logging.DI supports three patterns for module loading, consistent with Baubit.DI:

Pattern 1: Modules from appsettings.json

Load logging configuration from JSON. Module types and settings are defined in configuration files.

await Host.CreateApplicationBuilder()
          .UseConfiguredServiceProviderFactory()
          .Build()
          .RunAsync();

appsettings.json:

{
  "modules": [
    {
      "type": "Baubit.Logging.DI.Module, Baubit.Logging.DI",
      "configuration": {
        "addConsole": true,
        "addDebug": true
      }
    }
  ]
}

Pattern 2: Modules from Code (IComponent)

Load logging programmatically using IComponent. No configuration file needed.

public class AppComponent : AComponent
{
    protected override Result<ComponentBuilder> Build(ComponentBuilder builder)
    {
        return builder.WithModule<Module, Configuration>(config =>
                {
                    config.AddConsole = true;
                    config.AddDebug = true;
                });
    }
}

await Host.CreateEmptyApplicationBuilder(new HostApplicationBuilderSettings())
          .UseConfiguredServiceProviderFactory(componentsFactory: () => [new AppComponent()])
          .Build()
          .RunAsync();

Pattern 3: Hybrid Loading (appsettings.json + IComponent)

Combine configuration-based and code-based module loading.

await Host.CreateApplicationBuilder()
          .UseConfiguredServiceProviderFactory(componentsFactory: () => [new AppComponent()])
          .Build()
          .RunAsync();

Using AddModule Directly

For direct service collection usage without Host:

var services = new ServiceCollection();

services.AddModule<Module, Configuration>(config =>
{
    config.AddConsole = true;
    config.AddDebug = true;
});

var serviceProvider = services.BuildServiceProvider();
var loggerFactory = serviceProvider.GetRequiredService<ILoggerFactory>();
var logger = loggerFactory.CreateLogger<MyClass>();
logger.LogInformation("Hello, World!");

Features

• Console Logging: Enable console output for log messages
• Debug Logging: Enable debug output for log messages
• Configuration-Driven: All providers can be enabled/disabled via configuration
• Type-Safe Configuration: Strongly-typed configuration with sensible defaults
• .NET Standard 2.0: Compatible with .NET Framework, .NET Core, and .NET 5+

API Reference

Configuration

Configuration class for the Logging DI module:

public class Configuration : AConfiguration
{
    // Enable console logging provider. Defaults to false.
    public bool AddConsole { get; set; } = false;

    // Enable debug logging provider. Defaults to false.
    public bool AddDebug { get; set; } = false;
}

Module

DI module for registering ILoggerFactory:

public class Module : AModule<Configuration>
{
    public Module(IConfiguration configuration);
    public Module(Configuration configuration, List<IModule> nestedModules = null);
    public override void Load(IServiceCollection services);
}

Usage Examples

Console Logging Only:

services.AddModule<Module, Configuration>(config =>
{
    config.AddConsole = true;
});

var loggerFactory = serviceProvider.GetRequiredService<ILoggerFactory>();
var logger = loggerFactory.CreateLogger("MyApp");
logger.LogInformation("This will appear in the console");

Debug Logging Only:

services.AddModule<Module, Configuration>(config =>
{
    config.AddDebug = true;
});

var loggerFactory = serviceProvider.GetRequiredService<ILoggerFactory>();
var logger = loggerFactory.CreateLogger("MyApp");
logger.LogDebug("This will appear in debug output");

Both Console and Debug:

services.AddModule<Module, Configuration>(config =>
{
    config.AddConsole = true;
    config.AddDebug = true;
});

Contributing

Contributions are welcome. Open an issue or submit a pull request.

License

MIT License - see LICENSE file for details.