Mecesoft.Result 1.0.2

Mecesoft.Result

Lightweight generic Result wrapper for .NET with optional pagination helpers (EF Core friendly).

• Target Framework: .NET 9
• Package: Mecesoft.Result
• License: MIT

Türkçe: .NET için hafif bir Result sarmalayıcısı. İsteğe bağlı sayfalama (pagination) bilgisi taşır ve EF Core ile uyumludur.

Install

NuGet Package Manager:

Install-Package Mecesoft.Result

.NET CLI:

dotnet add package Mecesoft.Result

Quick start

Return success results:

using Mecesoft.Result;

Result<string> ok = Result<string>.Succeed("Hello World");
// or via implicit conversion
Result<string> ok2 = "Hello World";

Return failures:

using Mecesoft.Result;
using System.Net;

var fail1 = Result<string>.Failure((int)HttpStatusCode.BadRequest, "Invalid input");
var fail2 = Result<string>.Failure("Unexpected error");
// or via implicit tuple conversion
Result<string> fail3 = ((int)HttpStatusCode.NotFound, "Not found");

Pagination with EF Core

using Mecesoft.Result;
using Microsoft.EntityFrameworkCore;

// IQueryable source (e.g., DbSet<User>)
var paged = await dbContext.Users
    .Where(u => u.IsActive)
    .OrderBy(u => u.Id)
    .ToPagedListAsync(pageNumber: 1, pageSize: 10, cancellationToken);

// Wrap into a Result
var result = Result<PaginationResult<User>>.Succeed(paged);

// Or return items with separate pagination metadata
var items = paged.Datas;               // IList<User>?
var pagination = new PaginationResultBase(paged.PageNumber, paged.PageSize, paged.TotalCount);
var result2 = Result<IList<User>>.Succeed(items!, pagination);

API overview

• Result<T>
  • Properties: Data, Pagination, ErrorMessages, IsSuccessful, StatusCode (JsonIgnore)
  • Factories: Succeed(...), Failure(...)
  • Implicit conversions from T and from (statusCode, errorMessage[s])
• PaginationResultBase: PageNumber, PageSize, TotalPages, TotalCount, IsFirstPage, IsLastPage
• PaginationResult<T>: Datas + all fields above
• IQueryable extension: ToPagedListAsync(pageNumber, pageSize, cancellationToken)

Notes

• StatusCode is ignored during JSON serialization by default (JsonIgnore attribute).
• If pageSize < 1 or pageNumber < 1, sensible defaults are applied (10 and 1 respectively).

License

MIT © 2025 Mecesoft