Concurrency library for .Net
C#
Latest commit 44055db Apr 17, 2016 @chrisa23 Fixed formatting
Permalink
Failed to load latest commit information.
Examples/Example1 updates Feb 19, 2016
Fibrous.Tests updates Feb 19, 2016
Fibrous Updated readme Apr 17, 2016
.gitignore updated ignore Mar 17, 2012
Fibrous.sln updates Feb 19, 2016
README.md Fixed formatting Apr 17, 2016
Todo.txt updates Feb 19, 2016

README.md

Fibrous

High performace concurrency library for the .Net platform. Fibrous is a fork of Retlang [http://code.google.com/p/retlang/].

Fibrous is an actor-like framework that uses the concept of Fibers, Channels and Ports as abstractions. Fibers represent execution contexts (aka thread/actor/event loop) and Ports represent messaging end points. Channels allow decoupling of fiber components.

Some of the library benefits:

  • Tiny library that makes multi-threading simple and easy to reason about
  • Thread safe publishing
  • Single or multiple subscribers
  • UI fibers for worry free UI marshalling
  • Excellent batching support
  • UI throttling and redraw can be controlled easily
  • Agent abstractions to simplify working with fibers.

Fibers

Fibers are synchronous execution contexts with an action queue. They can be backed by a thread or the thread pool. There is also a StubFiber, which is used for testing and in special cases, and immediately executes actions on the calling thread. Fibers can manage state without worries of cross threading issues. While a Fiber is synchronous, your system can consist of multiple Fibers communicating through messaging to provide parallelism to your system.

Fibers subscribe to channels to receive messages which queues an action based on the assigned handler. Fibers have a scheduling API that allows actions to be scheduled in the future as well as repeatedly. You can also directly queue actions onto a Fiber for it to execute.

Fibers are a repository of IDisposable objects and will dispose of all children upon the Fibers disposal. This is used to clean up subscriptions and scheduling for any fiber. This is also useful for dealing with children used in the Fiber's context that implement IDisposable.

There are specialised Fibers for Windows Forms and WPF, which automatically handle invoking actions on the UI/Dispatcher thread

Ports and Channels

Ports are the end points for publishing and subscribing to messages.

Channels are the conduit for message passing between Fibers, and allow decoupling of the parts of your system. There are a variety of channel types built into Fibrous, including one way channels that notify all subscribers, request/reply, queue channels that give messages to one of multiple sibscribers, as well as some channels with functionality like a last value cache and replay channels.

There is also a static EventBus which allows a simpler mechanism for passing messages when only one normal channel per type is needed.

There are a variety of subscription methods, including filtered, batched, keyed batched and the last message after a time interval.

Examples:

//create a fiber that is already started and backed by a thread pool
//Work is done on the thread pool, but in a sequential fashion 
IFiber fiber = PoolFiber.StartNew();

//Create a channel and subscribe to messages
IChannel<string> channel = new Channel<string>();
channel.Subscribe(fiber, (s) => Console.WriteLine(s.ToUpper()));
// or you can subscribe via the Fiber
fiber.Subscribe(channel, (s) => Console.WriteLine(s.ToUpper()));

//Publish a message to the channel
channel.Publish("the message");

//You can enqueue methods
fiber.Enqueue(SomeParameterlessMethod);

//or lambdas
fiber.Enqueue(() => DoSomeWork(someParam));

//You can schedule when things happen
fiber.Schedule(ScheduledMethod, when);

//and also have them repeat
fiber.Schedule(ScheduledMethod, when, repeat);