RzR.Scheduling.RecurringJobs 3.0.0.7953

RzR.Scheduling.RecurringJobs is a lightweight recurring job scheduler for .NET.

It is designed for cases where you want to run one or more pieces of work on a repeating schedule without pulling in a heavier scheduling framework. The library is built around System.Threading.Timer, works well with dependency injection, and now exposes a clearer job-based API for starting, observing, and stopping recurring work.

What It Gives You

• Schedule a single recurring job or several work items in one job.
• Run through DI with IMethodScheduler or without DI through MethodSchedulerService.Default.
• Stop a job by handle, by id, or stop everything managed by the scheduler.
• Configure retries, first-run delay, max iterations, stop-on-failure, and stop-on-first-success behavior.
• Control parallel execution when one job contains multiple work items.
• Register class-based scheduled tasks through AddScheduledTask<TTask>().

Quick Start

For most applications, the simplest path is:

1. Register the scheduler in DI.
2. Inject IMethodScheduler.
3. Call Schedule(...) with ScheduledJobOptions.

using System;
using System.Threading;
using System.Threading.Tasks;
using Microsoft.Extensions.DependencyInjection;
using RzR.Scheduling.RecurringJobs;
using RzR.Scheduling.RecurringJobs.Abstractions;
using RzR.Scheduling.RecurringJobs.Models;

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddMethodScheduler();

public sealed class ReportSyncService
{
  private readonly IMethodScheduler _scheduler;

  public ReportSyncService(IMethodScheduler scheduler)
  {
    _scheduler = scheduler;
  }

  public IScheduledJob Start()
  {
    return _scheduler.Schedule(
      new ScheduledJobOptions
      {
        Id = "reports.sync",
        SuccessInterval = TimeSpan.FromMinutes(5),
        FailInterval = TimeSpan.FromSeconds(30),
        InitialDelay = TimeSpan.FromSeconds(10)
      },
      SyncReportsAsync);
  }

  private static Task SyncReportsAsync(CancellationToken cancellationToken = default)
  {
    return Task.CompletedTask;
  }
}

Once a job is scheduled, you can:

• keep the returned IScheduledJob and call await job.StopAsync(),
• stop a job later with await scheduler.TryStopAsync("reports.sync"),
• or stop everything with await scheduler.StopAllAsync().