Eon

⌚ A Schedule type for C# and dotnet

Why?

Schedules are a common requirement when building software. Whenever you need some operation to repeat at some configured cadence, a way to encode that is needed.

The standard abstraction that many developers would be familiar with is Cron. This is a job scheduler that comes paired with a simple language; crontab that is used to define how the job is to be repeated.

Eon exposes a type Schedule, that is a modern alternative to Cron, that is not concerned with how its executed, just the cadence at which an execution engine could run it.

Its an immutable blueprint; a potentially infinite stream of Duration that can be iterated and potentially awaited.

// defines a simple schedule that emmits 5 durations each 2 seconds long
Schedule schedule = 
    Schedule.Spaced(TimeSpan.FromSeconds(2)) & Schedule.Recurs(5);

// the schedule can be used in any way; its an IEnumerable<Duration>
// so we can just foreach it and do the operation; awaiting the durations
// after
foreach(Duration duration in schedule)
{
    // some operation
    var result = await SomeService();
    // now wait 2 seconds
    await duration;
}

There are many combinators which allow Schedule to be composed out of simple building blocks reducing the need to extend Schedule directly. Eon exposes many of these combinators, which are documented here.

However if its required it is as simple as writing a custom IEnumerable<T> of Duration.

For more details/information keep reading the docs or have a look at the test projects or create an issue.

Table of Contents

Eon

Why?