CronQuery

CronQuery is an open source and lightweight job runner for ASP.NET Core.

# Installation

CronQuery is installed via NuGet package.

• .NET CLI
• Package Manager (Visual Studio)

dotnet add package CronQuery

Install-Package CronQuery

# Creating jobs

Jobs are created by implementing the interface IJob.

public class MyJob : IJob
{
    public async Task RunAsync()
    {
        // Do your magic
    }
}

# Registering jobs

Jobs are registered in the Program.cs class.

using CronQuery.Mvc.DependencyInjection;

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddCronQuery(builder.Configuration.GetSection("CronQuery"));

builder.Services.AddTransient<MyFirstJob>();
builder.Services.AddTransient<MySecondJob>();

# Setting up jobs

Schedule your jobs using CRON expressions of six fields to a specific timezone (UTC is default). Save the configuration in your appsettings.json like the example below:

{
  "CronQuery": {
    "Running": true,
    "TimeZone": "E. South America Standard Time",
    "Jobs": [
      {
        "Name": "MyFirstJob",
        "Running": true,
        "Cron": "* * * * * 1-6"
      },
      {
        "Name": "MySecondJob",
        "Running": true,
        "Cron": "0 0 2 * * *"
      },
      {
        "Name": "MyThirdJob",
        "Running": true,
        "Cron": "* * 14-18 * * 6/15"
      }
    ]
  }
}

Whenever you save the appsettings.json CronQuery immediately assumes the new configuration.