Oakrey.Applications.Settings 7.0.0

Oakrey.Applications.Settings

WPF-only (.NET 10, Windows) library providing persistent and volatile typed key-value settings backed by JSON, bindable SettingsBase view-model integration, automatic CallerMemberName key inference, built-in window-bounds restore, and composition-root DI integration.

Main features

• ISettingsService / ISettingsService<T> - typed, generic service for loading, saving and querying settings per settings class.
• Persistent and volatile settings - persistent settings survive application restarts; volatile settings are held in memory only for the current session.
• SettingsBase - abstract base class deriving from ViewModelBase; combines ISettingsService with INotifyPropertyChanged so settings properties bind directly in WPF.
• CallerMemberName key inference - Get<T>() and Set<T>() use the calling property name as the storage key automatically; no magic strings required.
• RestoreBounds - ready-made settings class that stores and restores Top, Left, Width, Height for a Window, with sensible minimum-value guards.
• RestoreBoundExtension - ApplyRestoreBounds and SaveRestoreBounds extension methods on System.Windows.Window.
• JSON backing - settings are serialized to and loaded from JSON via IJsonSettingService; each settings class occupies its own section keyed by its full type name.
• DI integration - explicit registrations keep service lifetimes visible in the composition root.
• Logging and tracing - integrated with Oakrey.Log and Oakrey.Telemetry.Tracing.
• Safe persistence - malformed or inaccessible JSON is not silently replaced with defaults.
• Concurrent section updates - read-modify-write operations are serialized per settings file.

Architecture

classDiagram
    class ISettingsService {
        +Get~TValue~(key) TValue
        +GetVolatile~TValue~(key) TValue
        +Set~TValue~(value, key)
        +SetVolatile~TValue~(value, key)
        +Load()
        +Save()
        +AppSettingPath string
    }
    class SettingsService~TSetting~ {
        -settingsStorage Dictionary
        -volatileSettingsStorage Dictionary
        -jsonService IJsonSettingService
    }
    class SettingsBase {
        #Get~TValue~(key) TValue
        #Set~TValue~(value, key)
        #GetVolatile~TValue~(key) TValue
        #SetVolatile~TValue~(value, key)
    }
    class RestoreBounds {
        +Top int
        +Left int
        +Width int
        +Height int
    }

    ISettingsService <|.. SettingsService~TSetting~
    SettingsBase --> ISettingsService
    RestoreBounds --|> SettingsBase

Requirements

• .NET 10 Windows (WPF)
• Direct packages: Oakrey.Log.Abstractions 3.0.0, Oakrey.Telemetry 2.0.1, and Oakrey.ViewModels 3.0.0.
• Project references (when used from source): Abstractions, Files.Abstractions, Json, and ViewModels.

Installation

NuGet Package Manager

1. Open the project in Visual Studio.
2. Navigate to Tools > NuGet Package Manager > Manage NuGet Packages for Solution.
3. Search for Oakrey.Applications.Settings and install.

.NET CLI

dotnet add package Oakrey.Applications.Settings

Package Manager Console

Install-Package Oakrey.Applications.Settings

Configuration

Register all required services with a single call in your DI setup:

services.AddTransient<IFileService, FileService>();
services.AddTransient<IJsonSettingService, JsonSettingService>();
services.AddTransient(typeof(ISettingsService<>), typeof(SettingsService<>));

Register the file, JSON section, and open-generic settings services in the application composition root as shown above.

Example usage

Custom settings class

public sealed class AppSettings(ISettingsService<AppSettings> settingsService)
    : SettingsBase(settingsService)
{
    public string Theme
    {
        get => Get<string>() ?? "Dark";
        set => Set(value);
    }

    public bool ShowToolbar
    {
        get => Get<bool>();
        set => Set(value);
    }
}

Register with DI:

services.AddTransient<IFileService, FileService>();
services.AddTransient<IJsonSettingService, JsonSettingService>();
services.AddTransient(typeof(ISettingsService<>), typeof(SettingsService<>));
services.AddTransient<AppSettings>();

Window bounds restore

// In Window.Loaded
window.ApplyRestoreBounds(restoreBounds);

// In Window.Closing
window.SaveRestoreBounds(restoreBounds);

Register RestoreBounds in DI (it is resolved via ISettingsService<RestoreBounds>):

services.AddTransient<IFileService, FileService>();
services.AddTransient<IJsonSettingService, JsonSettingService>();
services.AddTransient(typeof(ISettingsService<>), typeof(SettingsService<>));
services.AddTransient<RestoreBounds>();

Development notes

• Settings are stored per type: the full type name of TSetting is used as the JSON section key.
• Default settings are loaded first and used per key when a user value is missing or has an incompatible type.
• SettingsService<T> implements IDisposable; Dispose() triggers a final Save().
• RestoreBounds enforces a minimum of 100 px for position and 768 px for dimensions.
• Volatile settings are not persisted to disk and are cleared on dispose.

Project information

License

This project is licensed under the MIT License. See the LICENSE file for details.