README.md

Simple Multi-Transport Event Bus for .NET

This repository contains the code for the Tingle.EventBus libraries. This project exists so as to simplify the amount of work required to add events to .NET projects. The existing libraries seem to have numerous complexities in setup especially when it comes to the use of framework concepts like dependency inject and options configuration. At Tingle Software, we use this for all our event-driven architecture that is based on .NET

Packages

Package	Version	Description
Tingle.EventBus		Base of the event bus library to allow you publish and consume events from different transports.
Tingle.EventBus.Serializers.NewtonsoftJson		Support for serializing events using Newtonsoft.Json.
Tingle.EventBus.Transports.Amazon.Abstractions		Abstractions for working with Amazon (AWS) based transports.
Tingle.EventBus.Transports.Amazon.Kinesis		Event bus transport based on Amazon Kinesis.
Tingle.EventBus.Transports.Amazon.Sqs		Event bus transport based on Amazon Simple Queue Service.
Tingle.EventBus.Transports.Azure.Abstractions		Abstractions for working with Azure based transports.
Tingle.EventBus.Transports.Azure.EventHubs		Event bus transport based on Azure Event Hubs.
Tingle.EventBus.Transports.Azure.QueueStorage		Event bus transport based on Azure Storage Queues.
Tingle.EventBus.Transports.Azure.ServiceBus		Event bus transport based on Azure Service Bus.
Tingle.EventBus.Transports.Kafka		Event bus transport based on the open source Apache Kafka platform.
Tingle.EventBus.Transports.RabbitMQ		Event bus transport based on the open source Rabbit MQ broker.

Documentation

A number fo the documents below are still a work in progress and would be added as they get ready.

Getting started

Bus Concepts and Configuration

Features

• Choosing a transport
• Multiple transports in one bus
• Retries
• Event and Consumers
• Observability
• Your first app

How to ...

• Work with IoTHub
• Advanced Service Bus options
• Work with Feature Management
• Extend event configuration

Samples

• Simple Consumer
• Simple Publisher
• Build a custom serializer
• Consume multiple events in one consumer
• In memory background processing

Issues & Comments

Please leave all comments, bugs, requests, and issues on the Issues page. We'll respond to your request ASAP!

License

The code is licensed under the MIT license. Refer to the LICENSE file for more information.