RMapper 1.0.3

RMapper 🚀

RMapper es un micro mapeador de objetos para .NET: ligero, sin dependencias externas y fácil de extender.
Resuelve el problema de copiar datos entre objetos (p. ej., DTOs ⇄ Entidades) sin repetir código ni añadir librerías pesadas.

✨ Características

• Mapeo automático por nombre y tipo de propiedad.
• Ignora propiedades decoradas con [IgnoreMap].
• API mínima: IMapper y SimpleMapper.
• Cero dependencias externas.
• Compilado para .NET Standard 2.0 (compatible con .NET Framework 4.6.1+, .NET Core 2.0+) y .NET 8.0.

🧰 Requisitos

• Cualquier proyecto en .NET Framework 4.6.1+, .NET Core 2.0+, .NET 5/6/7/8+.
• No requiere configuración adicional.

📦 Instalación

.NET CLI

dotnet add package RMapper

Package Manager (Visual Studio)

Install-Package RMapper

PackageReference

<ItemGroup>
  <PackageReference Include="RMapper" Version="1.*" />
</ItemGroup>

🚀 Uso básico

using RMapper.Core.Attributes;
using RMapper.Core.Interfaces;
using RMapper.Reflection;

public class UserDto
{
    public string Nombre { get; set; }

    [IgnoreMap] // 👈 No se mapeará
    public int Edad { get; set; }
}

public class Usuario
{
    public string Nombre { get; set; }
    public int Edad { get; set; }
}

class Program
{
    static void Main()
    {
        var dto = new UserDto { Nombre = "Carlos", Edad = 30 };

        IMapper mapper = new SimpleMapper();
        var usuario = mapper.Map<UserDto, Usuario>(dto);

        Console.WriteLine(usuario.Nombre); // Carlos
        Console.WriteLine(usuario.Edad);   // 0 (ignorado por [IgnoreMap])
    }
}

¿Qué hace [IgnoreMap]?

Cualquier propiedad marcada con IgnoreMap será omitida durante el mapeo.
Ejemplo:

public class ProductoDto
{
    public string Nombre { get; set; }

    [IgnoreMap]
    public decimal Precio { get; set; }
}

En el objeto destino, Precio queda con su valor por defecto (p. ej. 0m).

🔍 ¿Cómo funciona?

RMapper usa Reflection para:

1. Leer las propiedades públicas de origen y destino.
2. Comparar por nombre y tipo.
3. Ignorar las que tengan [IgnoreMap].
4. Copiar valores en el objeto destino.

🧪 Prueba rápida local

dotnet new console -n RMapper.Demo
cd RMapper.Demo
dotnet add package RMapper
// Abre Program.cs y pega el ejemplo de "Uso básico"
dotnet run

🧩 Compatibilidad

El paquete incluye netstandard2.0 y net8.0. En entornos antiguos usa el TFM netstandard2.0.

📚 Documentación y enlaces

• NuGet: https://www.nuget.org/packages/RMapper

🛣️ Roadmap

• Mapping Profiles (configuraciones por tipo).
• ForMember(...) para mapeos personalizados.
• Expression Trees para mayor rendimiento.
• Conversiones simples (int ⇄ string, enums, fechas).
• Test suite y benchmarks.

💬 Feedback & Soporte

• Contacto (placeholder): @RafaDev19 · rafael09.develop@gmail.com

⚖️ Licencia

Este proyecto está bajo la licencia MIT. Consulta el archivo LICENSE para más detalles.