TrimKit.EventBus 1.0.0

TrimKit.EventBus

A lightweight and mutation-safe event bus (event aggregator) for C# applications and games. Designed for simplicity and ease of use.

TrimKit.EventBus allows different parts of your system to communicate via strongly-typed events without hard dependencies or direct references.

Features

• Lightweight & dependency-free.
• Thread-safe.
• Mutation-safe - handlers can safely modify subscriptions even during event publishing.
• Disposable subscriptions - each Subscribe() returns an IDisposable token for easy unsubscribe.
• SubscribeOnce() support - automatically unsubscribes after first event.
• Duplicate protection - prevents duplicate handler registration.

Installation

Use provided nuget package or download the source.

🔧 dotnet add package TrimKit.EventBus

Quick start

Define your events, they must inherit from EventArgs:

public sealed class GameStartedEvent : EventArgs
{
    public DateTime StartTime { get; }
    public GameStartedEvent(DateTime startTime) => StartTime = startTime;
}

public sealed class CharacterDamagedEvent : EventArgs
{
    public string Name { get; }
    public int Damage { get; }
    public CharacterDamagedEvent(string name, int damage)
    {
        Name = name;
        Damage = damage;
    }
}

Create the event bus itself:

var bus = new EventBus();

Add subscribers. You can subscribe normally or use SubscribeOnce() for a one-time handler.

// normal subscription
var token = bus.Subscribe<CharacterDamagedEvent>((s, e) =>
{
    Console.WriteLine($"{e.Name} took {e.Damage} damage!");
});

// subscribe once
bus.SubscribeOnce<GameStartedEvent>((s, e) =>
{
    Console.WriteLine($"[Once] Game started at {e.StartTime:T}");
});

Each Subscribe() returns an IDisposable token you can later call Dispose() on to unsubscribe:

token.Dispose();

And now you can start publishing events:

bus.Publish(new GameStartedEvent(DateTime.Now));
bus.Publish(null, new CharacterDamagedEvent("Goblin", 25));

Thread safety

All operations (Subscribe, Unsubscribe, Publish, Reset) are protected by a lock and safe for concurrent use. During event dispatch, handlers are called using a snapshot copy, so you can safely modify subscriptions while publishing.

API Overview

Changes

• v1.0 - Initial release.

Contribution

Contributions are welcome!

You can start with submitting an issue on GitHub.

License

Virtual File System is released under the MIT License.