Mappy.dotNet 1.0.0

🍁Mappy - Object Mapping

Introduction

Mappy is a lightweight object mapping utility for C# applications. It allows you to easily map objects between models and DTOs, handle nested objects, and map collections. This utility supports both synchronous and asynchronous mapping operations, with options for custom transformations.

Features

1. Simple Object Mapping: Map properties between objects with identical names and types.
2. Nested Object Mapping: Automatically maps nested properties.
3. Collection Mapping: Handles collections of objects and maps them to the destination collection type.
4. Custom Mapping: Supports custom transformations using lambda expressions.
5. Asynchronous Mapping: Enables async operations for custom transformations.
6. Null Safety: Handles null values gracefully.
7. Support mapping private properties.

Usage

1. Basic Mapping

var product = new Product
{
    Id = 1,
    Name = "Laptop",
    Price = 1200.50m,
    Category = new Category { Id = 10, Name = "Electronics" }
};

var productDto = product.Map<ProductDto>();
Console.WriteLine($"Product DTO: {productDto.Name}, {productDto.Category.Name}");

2. Custom Mapping

var product = new Product
{
    Id = 1,
    Name = "Laptop",
    Price = 1200.50m
};

var productDto = product.Map<ProductDto>(dto =>
{
    dto.Name = product.Name.ToUpper();
});

Console.WriteLine($"Custom Product DTO: {productDto.Name}");

3. Async Mapping

var product = new Product { Id = 1, Name = "Laptop", Price = 1200.50m };

var productDto = await product.MapAsync<ProductDto>(async dto =>
{
    dto.Name = await Task.FromResult(dto.Name.ToUpper());
});

Console.WriteLine($"Async Product DTO: {productDto.Name}");

4. Collection Mapping

var products = new List<Product>
{
    new Product { Id = 1, Name = "Laptop", Price = 1200.50m },
    new Product { Id = 2, Name = "Phone", Price = 800.00m }
};

var productDtos = products.MapCollection<ProductDto>();
productDtos.ForEach(dto => Console.WriteLine($"{dto.Id} - {dto.Name}"));

5. Mapping Nested Collections

var order = new Order
{
    Id = 100,
    CustomerName = "John Doe",
    Items = new List<OrderItem>
    {
        new OrderItem { ProductName = "Laptop", Quantity = 1 },
        new OrderItem { ProductName = "Mouse", Quantity = 2 }
    }
};

var orderDto = order.Map<OrderDto>();
Console.WriteLine($"Order DTO: {orderDto.CustomerName}");
orderDto.Items.ForEach(item => Console.WriteLine($"{item.ProductName} - {item.Quantity}"));

Notes

1. Performance: This mapper is not optimized for very large datasets or scenarios with high-frequency mapping needs. Use with caution for such cases.
2. Limitations:
   • Cannot handle circular references.

License

This project is open source and can be freely modified and distributed.