Oakrey.Applications.Log 4.0.4

Oakrey.Applications.Log

A .NET 10 library that integrates Oakrey logging into Windows applications via IServiceCollection extension methods. It provides a WpfQueueLogger-backed view model for real-time UI log visualization, settings-persisted log level filtering, and a preloadable cleanup service that removes log files older than 7 days.

Main features

• ConfigureLoggingServices � initializes LoggerFactory basic loggers and registers ILogger<T> / LoggerProxy<T> as singletons in the DI container.
• ConfigureLogViewServices � registers a WpfQueueLogger singleton (queue capacity 100) and a transient LogViewModel for WPF binding.
• LogViewModel � bindable view model exposing WpfQueueLogger, a settings-persisted DisplayLogLevel (Level.Information default), and a settings-persisted VerticalOffsetValue. Includes a design-time constructor that pre-populates sample log entries.
• LogFileCleanupService � implements IPreLoadable and IDisposable. On Preload(), deletes .log files older than 7 days from Documents\<AppName>\Logs. Reports failures as PreLoadingException via IObservable<PreLoadingException> backed by a ReplaySubject.
• ILogConfig � interface for decoupled access to DisplayLogLevel and VerticalOffsetValue.

Architecture

classDiagram
    class LoggingConfigurationExtension {
        +AddOakreyLogging(IServiceCollection) IServiceCollection
        +ConfigureLoggingServices(IServiceCollection) IServiceCollection
        +ConfigureLogViewServices(IServiceCollection) IServiceCollection
    }

    class LogViewModel {
        +WpfLogger : WpfQueueLogger
        +DisplayLogLevel : Level
        +VerticalOffsetValue : double
    }

    class LogFileCleanupService {
        +Preload(CancellationToken) Task
        +Subscribe(IObserver) IDisposable
        +Dispose()
    }

    class ILogConfig {
        <<interface>>
        +DisplayLogLevel : Level
        +VerticalOffsetValue : double
        +GetValue~T~(string) T
    }

    class ILogFileCleanupService {
        <<interface>>
    }

    LogViewModel ..|> INotifyPropertyChanged
    LogViewModel ..|> ILogConfig
    LogFileCleanupService ..|> ILogFileCleanupService
    LogFileCleanupService ..|> IPreLoadable
    LogFileCleanupService ..|> IDisposable
    LoggingConfigurationExtension --> LogViewModel : registers
    LoggingConfigurationExtension --> WpfQueueLogger : registers

Requirements

• .NET 10 (net10.0-windows)
• Windows
• Dependencies: Oakrey.Applications.Settings, Oakrey.Log, Oakrey.Log.Windows

Installation

.NET CLI

dotnet add package Oakrey.Applications.Log

Package Manager Console

Install-Package Oakrey.Applications.Log

NuGet Package Manager in Visual Studio

Navigate to Tools > NuGet Package Manager > Manage NuGet Packages for Solution, search for Oakrey.Applications.Log, and install.

Usage

Registering logging services

Call both methods during application startup, typically in your DI composition root:

services
    .ConfigureLoggingServices()   // registers ILogger<T>, initializes LoggerFactory
    .ConfigureLogViewServices();  // registers WpfQueueLogger + LogViewModel

AddOakreyLogging() is also available as a standalone call when you only need ILogger<T> registration without reinitializing LoggerFactory.

Binding LogViewModel in WPF

<ItemsControl ItemsSource="{Binding WpfLogger.Entries}">
    ...
</ItemsControl>

<ComboBox SelectedItem="{Binding DisplayLogLevel}" />

// inject via DI
public LogView(LogViewModel viewModel)
{
    DataContext = viewModel;
    InitializeComponent();
}

Registering the cleanup service

services.AddSingleton<ILogFileCleanupService, LogFileCleanupService>();

Then call Preload during application startup (or via the IPreLoadable pipeline):

await logFileCleanupService.Preload(cancellationToken);

Subscribe to failures if you want to surface them in the UI:

logFileCleanupService.Subscribe(ex =>
{
    // ex.Message, ex.Detail, ex.InnerException available
});

Using ILogConfig

public class MyService(ILogConfig logConfig)
{
    public void Apply()
    {
        Level level = logConfig.DisplayLogLevel;
    }
}

Development notes

• Log file path � files are deleted from Environment.SpecialFolder.MyDocuments\<IApplicationInfo.Name>\Logs. The application name is resolved via the injected IApplicationInfo.
• Retention period � hardcoded to 7 days (TimeSpan(7, 0, 0, 0)). There is currently no configuration API for this value.
• Design-time support � LogViewModel has a parameterless constructor that seeds sample entries at Information, Debug, and Error levels, enabling XAML designer previews without DI.
• ReplaySubject � LogFileCleanupService uses ReplaySubject<PreLoadingException> so late subscribers still receive exceptions that occurred before they subscribed. Dispose the service to release it.

Project information