Flavio.Santos.NetCore.ObjectMapping 1.0.1

FDS.NetCore.ObjectMapping

A lightweight, fluent object mapping library for .NET with automatic property transfer and functional transformation support.

✨ Features

• 🔁 Automatic property mapping by name and compatible type
• 🔄 Enum ↔ String conversion support
• 🧩 Fluent .Apply() to customize transformations inline
• 🧪 No setup, no DI, no registration required
• 🪶 Zero external dependencies

🚀 Why Use This Package?

Unlike traditional mapping libraries that require profiles, dependency injection or runtime configuration, FDS.NetCore.ObjectMapping offers:

• ✅ Simplicity: Just call MapTo<T>(), no setup needed
• ✅ Explicit control: Chain .Apply() for custom logic inline
• ✅ Readability: Improves developer experience with fluent syntax
• ✅ Minimalism: Great for microservices, small apps, and rapid development
• ✅ Safety: Handles enum ↔ string conversion explicitly and predictably

Whether you're mapping entities to DTOs or shaping request payloads for APIs, this package helps you do it cleanly, safely, and fluently.

💡 When to Use

Use FDS.NetCore.ObjectMapping when you want:

• Fast, explicit, and simple mapping (especially for small or medium apps)
• Clean code with inline overrides using .Apply()
• Avoiding the overhead of AutoMapper-style configuration

📦 Installation

dotnet add package Flavio.Santos.NetCore.ObjectMapping

✅ Usage

1. Add using

using FDS.NetCore.ObjectMapping.Extensions;

2. Map automatically by property name

var dto = entity.MapTo<ReadTransactionDto>();

3. Add extra behavior with .Apply()

var transaction = dto
    .MapTo<Transaction>()
    .Apply(t => t.Id = Guid.NewGuid())
    .Apply(t => t.CreatedAt = DateTime.Now);

🔄 Enum Support

Supports string → enum and enum → string automatically.

Example:

Domain

public enum TransactionType { Credit, Debit }

public class Transaction
{
    public TransactionType Type { get; set; }
}

DTO

public class ReadTransactionDto
{
    public string Type { get; set; } = string.Empty;
}

Mapping:

var dto = transaction.MapTo<ReadTransactionDto>(); // Type will be "Credit"

🧪 Example: Create + Return

var transaction = dto
    .MapTo<Transaction>()
    .Apply(t => t.Id = Guid.NewGuid())
    .Apply(t => t.CreatedAt = DateTime.Now);

await _repository.AddAsync(transaction);

var response = transaction.MapTo<ReadTransactionDto>();
return Result.CreateAdd(response);

📦 Package Details

📄 License

Licensed under the MIT License.