CommonTK is a feature-rich toolkit for .NET applications, providing advanced context management, status providers, hierarchical settings, action groups, and more. It is designed for flexibility, extensibility, and performance.
Install with dotnet CLI:
dotnet add package SAPTeam.CommonTKContexts allow you to define and manage global or private application states, with support for locking execution via action groups.
Example: Custom Context
public class ExampleContext : Context
{
public override string[] Groups => new[] { Context.ActionGroup(ActionScope.Application, "sample_action") };
public ExampleContext()
{
Initialize(true); // Register as global context. must be called after ctor logic, if not called, the context won't be registered and not working.
}
protected override void CreateContext()
{
// Initialization logic here
}
protected override void DisposeContext()
{
// Cleanup logic here
}
}
Usage:
using (var context = new ExampleContext())
{
// Code here runs with the context changes.
// In this state, the action group application.sample_action is locked and all methods that use it will be blocked.
}
// Action group is unlocked here.
Action groups let you prevent unintended changes that may conflict eith the running context.
public void ModifyUnintendedValues()
{
Context.QueryGroup(Context.ActionGroup(ActionScope.Application, "sample_action"));
// Code here will only run if the action group is not locked
}
Define and manage settings in a hierarchical structure, with type convention and import/export capabilities.
var root = new SettingsStore();
var setting = root.CreateSetting("app.theme", "dark", "UI theme");
setting.Value = "light";
string theme = setting.Value;
Unified interfaces for reporting status, progress, and multi-status bars.
Basic Status Provider:
public class UIStatusProvider : IStatusProvider
{
private readonly Label status;
public UIStatusProvider(Label label) => status = label;
public void Clear() => status.Text = "";
public StatusIdentifier Write(string message)
{
status.Text = message;
return StatusIdentifier.Empty;
}
}
A simple registry for managing resources with resource locations.
var registry = new Registry<Stream>();
// Register a resource
var location = new ResourceLocation("private", "myimage");
var stream = File.OpenRead("path/to/image.png");
registry.TryAdd(location, stream);
// Retrieve a resource
var file = registry[location];
Call a method after a specified time interval, with optional repeat functionality and exception handling.
var timer = new Timer(5000, () => SendMessage("test"), repeat: false);
// Stop or pause before the timer ends
timer.Pause(); // Only for repeating timers
timer.Stop();
// Get thrown exceptions
var exception = timer.Exceptions.FirstOrDefault();
If you discover any security vulnerabilities, please report them by following our Security Guidelines.
We welcome contributions! Please see our Contributing guide for more information on how to get started.
This project is licensed under the MIT License.