OxCore.QuantumQueue.Core 8.0.2

🌀 OxCore.QuantumQueue

OxCore.QuantumQueue is a lightweight, CRON-based job scheduler for .NET applications. Designed to be modular and developer-friendly, it lets you easily run background tasks with precise control over execution timing.

📦 Installation

Install the NuGet package:

.NET CLI

dotnet add package OxCore.QuantumQueue.Core --version 8.0.2

Package Manager

Install-Package OxCore.QuantumQueue.Core --version 8.0.2

⚙️ Getting Started

To start using OxCore.QuantumQueue, follow these steps in your .NET Core app.

1⃣ Register Services

Add the following in your Program.cs:

builder.Services.OxCoreService();

This registers all required services and job dependencies into the DI container.

2⃣ Enable Job Scheduler Middleware

After configuring your app and building it, add this line:

app.UseJobScheduler();

This activates the job scheduler and runs all registered jobs based on their defined schedules.

3⃣ Create a Job

Implement the IJob interface to define a recurring background task:

using OxCore.QuantumQueue;

public class SampleJob : IJob
{
    public string CronExpression => "*/5 * * * *"; // every 5 minutes

    public async Task ExecuteAsync(CancellationToken cancellationToken)
    {
        Console.WriteLine($"[SampleJob] Executed at: {DateTime.Now}");
        await Task.CompletedTask;
    }
}

4⃣ Register the Job

You do not need to manually register your job; it is automatically discovered and registered by the application.

🧪 Example: Data Sync Job

public class DataSyncJob : IJob
{
    public string CronExpression => "0 */6 * * *"; // Every 6 hours

    public async Task ExecuteAsync(CancellationToken cancellationToken)
    {
        Console.WriteLine("[DataSyncJob] Syncing data...");
        await MySyncService.SynchronizeAsync();
    }
}

⏰ CRON Expression Guide

Examples:

• */5 * * * * – every 5 minutes
• 0 0 * * * – every day at midnight
• 0 12 * * 1 – every Monday at 12:00 PM

Use crontab.guru to generate or validate CRON expressions.

🔐 Scoped Job Dependency Support

You can inject services inside your jobs using constructor injection:

public class EmailJob : IJob
{
    private readonly IEmailService _emailService;

    public EmailJob(IEmailService emailService)
    {
        _emailService = emailService;
    }

    public string CronExpression => "0 8 * * *"; // Every day at 8 AM

    public async Task ExecuteAsync(CancellationToken cancellationToken)
    {
        await _emailService.SendScheduledEmailsAsync();
    }
}

Make sure to register the dependency in Program.cs:

builder.Services.AddScoped<IEmailService, EmailService>();

🧹 Features

• ✅ Simple setup and lightweight design
• ⏱️ Flexible CRON-based scheduling
• ♻️ Supports scoped DI with IJob
• 🥵 Thread-safe and cancellation-aware
• 🔄 Automatically discovers and runs all registered jobs
• 🧪 Testable architecture with modular components

🛠️ Advanced Configuration (coming soon)

Custom options for:

• Retry policies
• Error handling strategies
• Dynamic job enable/disable
• Job health monitoring

Stay tuned for future releases!

🧼 Best Practices

• Avoid blocking threads (use async/await)
• Use logging to trace job runs
• Wrap your job logic in try-catch blocks to prevent silent failures

📄 License

This project is licensed under the MIT License.

🤝 Contributing

We welcome community contributions!

To contribute:

1. Fork the repo
2. Create a new feature branch
3. Submit a pull request

Created with ❤️ by OxCore Team (Prabuddha Jayawardhana)