NetMapper 1.1.3

NetMapper

NetMapper is a lightweight and fast object mapping library for .NET, without using reflection at runtime. It is ideal for applications that require high performance and low coupling.

✅ Features

• Mapping between different objects (DTO ↔ Entity)
• Date formatting support with the [MapWithFormat] attribute
• Ignore properties with [IgnoreMap]
• Mapping with different names using [MapTo("DestinationName")]
• Allows customization with delegate during mapping

📦 Installation

dotnet add package NetMapper

## 🛠️ Object Configurations

public class Product
{
    public string ProductName { get; set; }
    
    [MapTo("ManufactureDate")]
    public DateTime Manufacture { get; set; }
    
    public decimal Price { get; set; }
    public string Status { get; set; }
    public List<OrderItem> Items { get; set; }
}

public class ProductDTO
{
    public string ProductName { get; set; }

    [MapWithFormat("dd/MM/yyyy")]
    [MapWithFormat("dd/MM/yyyy HH:mm")]
    [MapWithFormat("dd/MM/yyyy HH:mm:ss")]
    public string ManufactureDate { get; set; }

    [IgnoreMap]
    public decimal Price { get; set; }
    
    public string Status { get; set; }
    public List<OrderItem> Items { get; set; }
}

## 🔁 Example 1 – Simple Mapping

var product = new Product
{
    ProductName = "Keyboard",
    Manufacture = DateTime.Now,
    Price = 100.00m,
    Status = "S"
};

var dtoProduct = product.MapTo<Product, ProductDTO>(dto =>
{
    dto.ProductName = dto.ProductName.ToUpper();
    dto.Status = product.Status switch
    {
        "S" => "Active",
        "N" => "Inactive"
    };
});

## 📄 Example 2 – Simple List Mapping

var products = new List<Product>
{
    new Product { ProductName = "Laptop", Price = 3500.99m, Manufacture = DateTime.Now, Status = "Active" },
    new Product { ProductName = "Mouse", Price = 150.50m, Manufacture = DateTime.Now, Status = "Active" }
};

var productsDTO = products.MapToList<Product, ProductDTO>();

## 📦 Example 3 – List Mapping with Composed Objects

var products = new List<Product>
{
    new Product
    {
        ProductName = "Laptop",
        Price = 3500.99m,
        Manufacture = DateTime.Now,
        Status = "Active",
        Items = new List<OrderItem> { new OrderItem { ProductCode = 12323 } }
    },
    new Product
    {
        ProductName = "Monitor",
        Price = 1200.75m,
        Manufacture = DateTime.Now,
        Status = "Active",
        Items = new List<OrderItem> { new OrderItem { ProductCode = 23412 } }
    }
};

var productsDTO = products.MapToList<Product, ProductDTO>();

## 🧩 Example 4 – Mapping a Composed Object

var product = new Product
{
    ProductName = "Laptop",
    Price = 3500.99m,
    Manufacture = DateTime.Now,
    Status = "Active",
    Items = new List<OrderItem> { new OrderItem { ProductCode = 12323 } }
};

var dto = product.MapTo<Product, ProductDTO>();