Flavio.Santos.NetCore.ObjectMapping 1.0.5

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
• 🧾 List mapping with .MapToList<TSource, TTarget>()
• ⚡️ Uses compiled expressions for high performance (no reflection at runtime)
• 🧩 Fluent .Apply() to customize transformations inline
• 🧪 No setup, no DI, no registration required
• 🪶 Zero external dependencies

💡 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()
• Automatic mapping between enums and strings
• 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"

📚 Collection Mapping

You can map lists or any IEnumerable<T>:

var dtoList = transactions.MapToList<Transaction, ReadTransactionDto>();

Perfect for mapping repository results into DTOs for API return.

🧪 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);

⚙️ How it Works Internally

• Uses compiled expressions to generate fast property setters and getters at runtime
• Enum-string conversion handled with type-safe reflection
• Caches mapping logic in memory per (source, target) combination
• Fluent API remains simple and chainable

📦 Package Details

✅ Advantages

• 📉 Minimal overhead compared to reflection or AutoMapper
• 💡 No registration or profiles required
• 🔁 Supports collections and enum/string mapping
• 🔐 Type-safe conversion with expression-based copying
• 🎯 Focused on clarity and performance for small/medium solutions

📄 License

Licensed under the MIT License.