RhoMicro.AlgebraicEffects 1.1.0

RhoMicro.AlgebraicEffects

Provides an implementation of algebraic effects for C#.

If you are new to algebraic effects, here is a great explanation: https://overreacted.io/algebraic-effects-for-the-rest-of-us/

How to Use

Effects can be handles using the Effect<> type:

Effect<AskForName>.Handle(EffectHandler<T> handler)

Effect<AskForName>.HandleAsync(AsyncEffectHandler<T> handler)

Handle and HandleAsync both return an instance of IDisposable that manages the lifetime of the handler registration:

EffectHandler<T> myHandler = static () => EffectHandlerResult<T>.CreateFromResult("Some Result");
using(var lt = Effect<T>.Handle(myHandler)){
    //methods called here may receive the handler
}
//the handler is unregistered, methods called here may not receive it

Effects may be handled and performed synchronously or asynchronously:

EffectHandler<T> syncHandler = static () => EffectHandlerResult<T>.CreateFromResult("Some Result");
using var _ = Effect<T>.Handle(syncHandler);

EffectHandler<T> asyncHandler = static () => Task.FromResult(EffectHandlerResult<T>.CreateFromResult("Some Result"));
using var _ = Effect<T>.HandleAsync(asyncHandler);

var missingData = Effect<T>.Perform();

var moreMissingData = await Effect<T>.PerformAsync();