title: Chapar – The Persian Courier for .NET Messaging

🐎 Chapar

The Clean, Extensible, and Business‑Friendly Messaging Abstraction for .NET

dotnet add package Chapar
dotnet add package Chapar.MassTransit

Why Chapar?

  • Zero ceremony — PublishAsync and SendAsync are all you need.
  • Transparent Outbox / Inbox — Add one NuGet package and every message is automatically stored in the database before delivery. No code changes.
  • Pipeline — A chain of configurable behaviours (diagnostics, error handling, origin validation, …) that wrap every handler.
  • Framework agnostic — Works standalone or on top of Zamin.
  • Transport agnostic — Currently uses MassTransit v8 (free & community‑supported), with Wolverine coming soon.

Inspired by the ancient Persian courier system – fast, reliable, and invisible to the message sender.

Quick Start

// 1. Define a message
public record UserRegistered(Guid UserId, string Email) : IEvent;

// 2. Publish
var bus = provider.GetRequiredServiceIChaparBus();
await bus.PublishAsync(new UserRegistered(Guid.NewGuid(), "user@example.com"));

// 3. Handle
public class UserRegisteredHandler : IMessageHandlerUserRegistered
{
    public Task HandleAsync(UserRegistered message, CancellationToken ct)
    {
        Console.WriteLine($"User {message.Email} registered.");
        return Task.CompletedTask;
    }
}

Explore the Documentation

Section Description
Complete Guide Walk through every scenario from publish/subscribe to advanced Outbox/Inbox, Pipeline, and Zamin integration.
GitHub Repository Source code, issue tracker, and contribution guidelines.

API Reference (Generated Automatically)

Welcome to the complete API reference for Chapar.
Below you can find every namespace documented in the library.

Documentation

Chapar.Core

Chapar.Inbox

Chapar.MassTransit

Chapar.Outbox

Chapar.Pipeline

Chapar.Zamin

License

MIT