ralphhendriks / Paramore.Brighter

Command Dispatcher, Processor, and Distributed Task Queue

================================= Brighter

![canon] (https://openclipart.org/people/amilo/canon.svg)	Brighter is a command dispatcher, processor, and task queue. It can be used to implement the [Command Invoker] (http://servicedesignpatterns.com/WebServiceImplementationStyles/CommandInvoker) pattern
Version
Download
Web	http://brightercommand.github.io/Paramore.Brighter/
Source	https://github.com/BrighterCommand/Paramore.Brighter
Chat
Keywords	task queue, job queue, asynchronous, async, rabbitmq, amqp, c#, command, command dispatcher, command processor, queue, distributed

Why a Command Dispatcher, Command Processor, and Task Queue?

• When implementing a hexagonal architecture, one question is how to implement a port.
  • Brighter shows how to implement ports using a Command approach (with a Command Dispatcher)
  • This is the strategy described for services in Service Design Patterns as [Command Invoker] (http://servicedesignpatterns.com/WebServiceImplementationStyles/CommandInvoker)
• A command processor let's you add orthogonal concerns seperately to the processing of commands such as logging, undo, validation, retry, and circuit breaker
  • Brighter provides a Command Processor, using a 'Russian Doll' model to allow a pipeline of handlers to operate on a command.
• A task queue allows a one process to send work to be handled asynchronously to another process, using a message queue as the channel, for processing. A common use case is to help a web server scale by handing off a request to another process for back-end processing. This allows both a faster ack and throttling of the request arrival rate to that which can be handled by a back end processing component. For another project with this goal, see Celery
  • Brighter provides a Task Queue implementation for handling commands asynchronously via a work queue.

Getting started

• More detailed documentation on the project can be found on the GitHub pages for the project here: Paramore

What are the different branches?

Branch	Description
Master	The tip of active development. Anything in master should ship at the next release. Code here should conform to CI basics: compile, pass tests etc.
gh-pages	Documentation for the library
[Other]	A branch for any work that is not ready to go into master (for example would break CI) or is experimental i.e. we don't know if we intend to ever ship, we are just trying out ideas.

##How Do I get the NuGet packages for the latest build? We release the build artefacts (NuGet packages) to Nuget on a regular basis and we update the release notes on those drops. We also tag the master code line. If you want to take the packages that represent master at any point you can download the packages for the latest good build from AppVeyor. The easiest approach to using those is to download them into a folder that you add to your NuGet sources.