Tenekon.Coroutines 0.1.0-preview.2

Tenekon.Coroutines

Write C# async-await coroutines in a Redux-Saga fashion and let them behave like JavaScript generators

You found a bug, have ideas or just want to talk? Join the Tenekon Community, start a discussion or open an issue.

Tenekon.Coroutines key facts on a glance

• Async iterators: make coroutines iterable
  • Each suspension point allows to clone the async iterator
• Fully AOT-compatible
• Highly extendible via new yielders and/or custom coroutine context
• Child coroutines inherit context of their parents: reduce explicit dependency injection
• Almost as fast as ValueTask

Installation

Minimum requirements

• Target framework that at least supports NET Standard 2.1 or .NET 6.0

Package Manager

Install-Package Tenekon.Coroutines -Version <type version here>

.NET CLI

dotnet add package Tenekon.Coroutines --version <type version here>

Quick start guide

Simple Coroutine

using static Tenekon.Coroutines.Yielders;

await Coroutine.Start(asnyc () => {
  await Call(Console.WriteLine, "Hello world");
});

// or

await Func<Coroutine>(asnyc () => {
  await Call(Console.WriteLine, "Hello world");
});

// Outputs:
// Hello world

Simple AsyncIterator

using static Tenekon.Coroutines.Yielders;
using static Tenekon.Coroutines.Yielders.Arguments;

var iterator = AsyncIterator.Create(asnyc () => {
  await Call(Console.WriteLine, "Hello world");
});

while (await iterator.MoveNextAsync()) {
  if (iterator.CurrentKey == CallKey) {
    Console.WriteLine(((CallArgument<string>)iterator.Current).Closure);
  }
}

// Outputs:
// Hello world

Advanced AsyncIterator

using static Tenekon.Coroutines.Yielders;
using static Tenekon.Coroutines.Yielders.Arguments;

var iterator = AsyncIterator.Create(asnyc () => {
  await Call(Console.WriteLine, "Hello world");
});

while (await iterator.MoveNextAsync()) {
  if (iterator.CurrentKey == CallKey) {
    Console.WriteLine(((CallArgument<string>)iterator.Current).Closure);
    iterator.Current = new CallArgument<string>(Console.WriteLine, "Hello iterator")
  }
}

// Outputs:
// Hello world
// Hello iterator

Advanced AsyncIterator

using static Tenekon.Coroutines.Iterator.Yielders;
using static Tenekon.Coroutines.Iterator.Yielders.Arguments;

var iterator = AsyncIterator.Create(asnyc () => {
  Console.WriteLine(await Exchange("Hello world"));
});

while (await iterator.MoveNextAsync()) {
  if (iterator.CurrentKey == ExchangeKey) {
    Console.WriteLine(((CallArgument<string>)iterator.Current).Closure);
    iterator.YieldReturn("Hello iterator");
  }
}

// Outputs:
// Hello world
// Hello iterator

Quick references

Yielders are the equivalent to effects in Redux-Saga.

In the following are all available Yielders classes and their contained yielders listed.

We recommend to make use of using static, e.g. using static Tenekon.Coroutines.Yielders.

Tenekon.Coroutines.Yielders

Call

The Call yielder is the equivalent to the call effect in Redux-Saga.

Use it to instruct the coroutine to suspend and invoke provider with optional closure. The coroutine resumes as soon as provider completed.

Launch

The Launch yielder is the equivalent to the fork effect in Redux-Saga.

Use it to instruct the coroutine to suspend and invoke provider with optional closure. The coroutine resumes immediatelly, but in case coroutine returns before provider finished it will suspend as long as provider won't have completed.

Spawn

The Spawn yielder is the equivalent to the spawn effect in Redux-Saga.

Use it to instruct the coroutine to suspend and invoke provider with optional closure. The coroutine resumes immediatelly, but in case coroutine returns before provider finished it will just return and provider will just continue to operate independently.

Spawn

Use Throw to instruct the coroutine to suspend and let the coroutine throw exception. The coroutine resumes immediatelly and throws excpetion.

WithContext

Use WithContext to instruct the coroutine to suspend and invoke provider with additiveContext and optional closure.

Yield

Use YieldReturn to instruct the coroutine to suspend and resume immediatelly. Allows the coroutine middleware to get the hands on value.

Tenekon.Coroutines.Iterators.Yielders

Use Exchange to instruct the coroutine to suspend and resume immediatelly. Allows the coroutine middleware to get the hands on value and exchange it.