CojectCore.BackgroundServices 1.0.3

Copyright (c) 2024 Akwad Arabia

CojectCore.BackgroundServices

A lightweight and easy-to-use background service library for ASP.NET Core applications. Manage SMS, Email, and custom background tasks with simple configuration.

Features

✅ Easy Integration - One line of code to enable background services
✅ Configurable - Enable/disable services via appsettings.json
✅ Extensible - Add custom background tasks easily
✅ Logging Support - Built-in logging for all operations
✅ Scoped Services - Proper dependency injection with scoped lifetimes

Installation

dotnet add package Coject.BackgroundServices

Or via NuGet Package Manager:

Install-Package Coject.BackgroundServices

Quick Start

1. Install the package

dotnet add package Coject.BackgroundServices

2. Configure appsettings.json

{
  "BackgroundService": {
    "EnabledServices": ["ServiceSMS", "ServiceMail"],
    "IntervalSeconds": 10
  }
}

3. Register in Program.cs

using Coject.BackgroundServices.Extensions;

var builder = WebApplication.CreateBuilder(args);

// Register your core dependencies
builder.Services.AddScoped<CoreModuleDB>();
builder.Services.AddScoped<ApiContext>();

// Add background services with one line
builder.Services.AddCojectBackgroundServices(builder.Configuration);

var app = builder.Build();
app.Run();

4. Done! 🎉

Your background services will start automatically and run based on the configured interval.

Configuration

appsettings.json

Available Services

• ServiceSMS - SMS message processing
• ServiceMail - Email message processing

Examples

Run every 10 seconds:

{
  "BackgroundService": {
    "EnabledServices": ["ServiceSMS", "ServiceMail"],
    "IntervalSeconds": 10
  }
}

Enable only SMS:

{
  "BackgroundService": {
    "EnabledServices": ["ServiceSMS"],
    "IntervalSeconds": 30
  }
}

Disable all services:

{
  "BackgroundService": {
    "EnabledServices": [],
    "IntervalSeconds": 60
  }
}

Adding Custom Background Tasks

1. Create your task class

using Coject.BackgroundServices.Interfaces;

public class CustomBackgroundTask : IBackgroundTask
{
    private readonly ILogger<CustomBackgroundTask> _logger;
    
    public string ServiceName => "ServiceCustom";
    
    public CustomBackgroundTask(ILogger<CustomBackgroundTask> logger)
    {
        _logger = logger;
    }
    
    public async Task ExecuteAsync(CancellationToken cancellationToken)
    {
        _logger.LogInformation("Custom task executing...");
        // Your logic here
    }
}

2. Register it

builder.Services.AddCojectBackgroundServices(builder.Configuration);
builder.Services.AddBackgroundTask<CustomBackgroundTask>();

3. Enable in appsettings.json

{
  "BackgroundService": {
    "EnabledServices": ["ServiceSMS", "ServiceMail", "ServiceCustom"],
    "IntervalSeconds": 10
  }
}

Requirements

• .NET 6.0 or higher
• ASP.NET Core

Dependencies

Your main project must register these dependencies before calling AddCojectBackgroundServices():

builder.Services.AddScoped<CoreModuleDB>();
builder.Services.AddScoped<ApiContext>();

Logging

The package uses ILogger for all logging. Configure your logging in appsettings.json:

{
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Coject.BackgroundServices": "Debug"
    }
  }
}

License

MIT License - see LICENSE.txt for details

Support

For issues, questions, or contributions, please visit:

• GitHub: [Your GitHub URL]
• NuGet: https://www.nuget.org/packages/Coject.BackgroundServices

Changelog

Version 1.0.0

• Initial release
• SMS background service
• Email background service
• Configurable intervals
• Enable/disable services via configuration