Job.Scheduler 1.0.1

Job Scheduler

A simple job scheduling library relying on the async/await pattern in C#.

Type of Jobs

One Time Job

By implementing the IJob interface you tell the scheduler that you just want this job to be executed once and directly upon being scheduled.

Recurring Job

By implementing the IRecurringJob the scheduler will run indefinitely your job with the given delay between execution.

Delayed Job

By implementing the IDelayedJob you tell the scheduler to wait a delay before executing your job.

Usage

I advise you to use a Dependency Injection (DI) engine (like SimpleInjector) to register the JobRunnerBuilder and JobScheduler as singleton.

Example:

public class MyJob : IRecurringJob
{
    public async Task ExecuteAsync(CancellationToken cancellationToken)
    {
        //Your complex recurring code, here pretty simple
        await Console.Out.WriteLineAsync("Hello World");
    }

    public Task<bool> OnFailure(JobException exception)
    {
//Any exception that occured when executing your job will be wrapped in a JobException, check the InnerException
//for you to be able to handle a failure without breaking your application neither needed a try/catch in ExecuteAsync

//Continue to run if the job has failed
//You can handle your self what to do in case of failure
//Returning false, will make the job stop
        return Task.FromResult(true);
    }
//This job will run every 15 seconds

    public TimeSpan Delay { get; } = TimeSpan.FromSeconds(15);
}

var builder = new JobRunnerBuilder();
var scheduler = new JobScheduler(builder);

//If you have already a cancellation token that you want to be used for stopping your job, you can pass it as second param
scheduler.Start(new MyJob());

//At the end of your application, you can ask the Scheduler to gracefully stop the running jobs and wait for them to stop.
//You can also pass a cancellationToken to force a non graceful cancellation of the jobs.
await scheduler.StopAsync();