Nimbus

Nimbus is a .NET messaging framework that provides a clean abstraction over multiple messaging transports, supporting commands, events (pub/sub), and request/response patterns.

Documentation: https://nimbusapi.com

Supported Transports

| Transport | Package | |-----------|---------| | Azure Service Bus | Nimbus.Transports.AzureServiceBus | | Redis | Nimbus.Transports.Redis | | PostgreSQL | Nimbus.Transports.Postgres | | SQL Server | Nimbus.Transports.SqlServer | | AMQP | Nimbus.Transports.AMQP | | In-Process (testing) | Nimbus.Transports.InProcess |

Message Patterns

• Commands — fire-and-forget, single handler
• Events — pub/sub with competing or multicast consumers
• Requests — request/response, single or multicast

Quick Start

var bus = new BusBuilder()
    .Configure()
    .WithTransport(new RedisTransportConfiguration().WithConnectionString("localhost"))
    .WithNames("MyApp", Environment.MachineName)
    .WithTypesFrom(typeProvider)
    .WithAutofacDefaults(componentContext)
    .WithJsonSerializer()
    .Build();

await bus.Start();

Developing Nimbus

git clone <this repository>
docker-compose up -d --build
dotnet build

Development Infrastructure

docker-compose up -d --build starts:

| Service | URL / Port | |---------|-----------| | Seq log server | http://localhost:5341 | | Redis | localhost:6379 | | Apache ActiveMQ Artemis (AMQP) | localhost:5672, console at http://localhost:8161 | | SQL Server | localhost:1433 | | PostgreSQL | localhost:5432 |

SQL Server uses a custom Docker image (in docker/sqlserver) — the --build flag ensures it is built before starting.

Integration tests use appsettings.json in the pipeline and appsettings.Development.json locally (not committed) to point at localhost ports.

Sample Application

The Cafe sample app demonstrates Nimbus messaging patterns through a simple café scenario (cashier, barista, waiter). Run it with:

dotnet run --project src/Cafe.Cashier
dotnet run --project src/Cafe.Barista
dotnet run --project src/Cafe.Waiter

See CONTRIBUTING.md for contribution guidelines.