TeymurDevv.UnitOfWorkPlus 1.0.0

TeymurDevv.UnitOfWorkPlus

📌 Introduction

TeymurDevv.UnitOfWorkPlus is a lightweight, generic Unit of Work and Repository pattern for Entity Framework Core. This package simplifies database operations by providing a structured Unit of Work and Generic Repository implementation, allowing you to easily manage transactions and repositories.

🚀 Features

✅ Generic Repository with built-in support for filtering, pagination, and tracking options.
✅ Unit of Work pattern to manage database transactions efficiently.
✅ Automatic Repository Registration for clean dependency injection.
✅ Works with Any DbContext – supports all Entity Framework Core providers.
✅ NuGet-Compatible for easy integration into any .NET project.

📦 Installation

Install via NuGet:

 dotnet add package TeymurDevv.UnitOfWorkPlus

OR manually add it to your .csproj file:

<PackageReference Include="TeymurDevv.UnitOfWorkPlus" Version="1.0.0" />

⚙️ Configuration

1️⃣ Register Services in Program.cs (or Startup.cs)

In .NET 6+, modify Program.cs:

using Microsoft.EntityFrameworkCore;
using Microsoft.Extensions.DependencyInjection;
using TeymurDevv.UnitOfWorkPlus;

var builder = WebApplication.CreateBuilder(args);

// Add DbContext
builder.Services.AddDbContext<MyDbContext>(options =>
    options.UseSqlServer("YourConnectionString"));

// Register UnitOfWork
builder.Services.AddUnitOfWork<MyDbContext>();

var app = builder.Build();

For .NET 5 and earlier, add this in Startup.cs:

public void ConfigureServices(IServiceCollection services)
{
    services.AddDbContext<MyDbContext>(options =>
        options.UseSqlServer(Configuration.GetConnectionString("DefaultConnection")));
    
    services.AddUnitOfWork<MyDbContext>();
}

📌 Usage

2️⃣ Inject IUnitOfWork and Use Repositories

Once registered, you can inject IUnitOfWork in your services and access repositories dynamically.

public class CategoryService
{
    private readonly IUnitOfWork _unitOfWork;

    public CategoryService(IUnitOfWork unitOfWork)
    {
        _unitOfWork = unitOfWork;
    }

    public async Task<List<Category>> GetCategories()
    {
        return await _unitOfWork.Repository<Category>().GetAll();
    }

    public async Task AddCategory(Category category)
    {
        await _unitOfWork.Repository<Category>().Create(category);
        await _unitOfWork.SaveChangesAsync();
    }
}

🎯 Unit of Work API

IUnitOfWork Methods

📌 Repository API

IRepository<T> Methods

📌 Example Queries

Retrieve a Single Entity with Filters

var category = await _unitOfWork.Repository<Category>()
    .GetEntity(c => c.Name == "Technology");

Retrieve All with Includes & Pagination

var categories = await _unitOfWork.Repository<Category>()
    .GetAll(predicate: c => c.IsActive, take: 10, includes: q => q.Include(c => c.Products));

Update an Entity

var category = await _unitOfWork.Repository<Category>().GetEntity(c => c.Id == 1);
category.Name = "Science";
await _unitOfWork.Repository<Category>().Update(category);
await _unitOfWork.SaveChangesAsync();

Delete an Entity

var category = await _unitOfWork.Repository<Category>().GetEntity(c => c.Id == 1);
await _unitOfWork.Repository<Category>().Delete(category);
await _unitOfWork.SaveChangesAsync();

📌 Contributing

We welcome contributions! If you'd like to improve this library, feel free to fork the repository and submit a pull request.

📜 License

This project is licensed under the MIT License.

🛠 Support & Contact

For issues and feature requests, please create an issue on GitHub.

Happy Coding! 🚀