README.md

Mappee - Fastest avaiable mapper for .NET

Mappee is a high performance object-to-object mapper for .NET. It is a simple and easy to use library that can be used to map objects of different types. It is designed to be fast and efficient, and it is the fastest available mapper for .NET. The main idea is to map objects using precompiled code, which makes it much faster than other mappers that use reflection. Generated code is cached, so it is only generated once for each type pair, and then reused for all subsequent mappings.

Features

• Fast and efficient
• Simple and easy to use

Getting Started

Using static methods

Mapper.Bind<TestObject, TestObjectDto>()
    .IgnoreMember<TestObject, TestObjectDto>(e => e.Name);
    .BeforeMap<TestObject, TestObjectDto>((source, _) =>
    {
        source.Nickname = $"{source.FirstName}{source.LastName}".ToLower();
    })
    .AfterMap<TestObject, TestObjectDto>((_, destination) =>
    {
        destination.Char = destination.FirstName.First();
    })
    .Bind<TestObjectModification, TestObjectModificationDto>()
    .Bind<TestObjectField, TestObjectFieldDto>()
    .Bind<TestObjectLink, TestObjectLinkDto>()
    .Compile();

var testObject = new TestObject();

var testObjectDto = Mapper.Map<TestObjectDto>(testObject);

Using dependency injection

var servicesCollection = new ServiceCollection();
servicesCollection.AddMappee(profile =>
{
    profile.Bind<TestObject, TestObjectDto>()
        .IgnoreMember<TestObject, TestObjectDto>(e => e.Name)
        .BeforeMap<TestObject, TestObjectDto>((source, _) =>
        {
            source.Nickname = $"{source.FirstName}{source.LastName}".ToLower();
        })
        .AfterMap<TestObject, TestObjectDto>((_, destination) =>
        {
            destination.Char = destination.FirstName.First();
        });

    //invoke compile method is not necessary, it will be called automatically
});

//[...]

var serviceProvider = servicesCollection.BuildServiceProvider();
var scope = serviceProvider.CreateScope();

var mapper = scope.ServiceProvider.GetRequiredService<IMapper>();

var testObject = new TestObject();
var testObjectDto = mapper.Map<TestObject, TestObjectDto>(testObject);

Mappee vs other mappers (performance comparison)

Benchmarks

2500 items in 3 different collections and 2500 nested objects (like linked list)

BenchmarkDotNet v0.13.12, Windows 11 (10.0.22631.3155/23H2/2023Update/SunValley3)
12th Gen Intel Core i7-12700K, 1 CPU, 20 logical and 12 physical cores
.NET SDK 8.0.101
  [Host]   : .NET 8.0.1 (8.0.123.58001), X64 RyuJIT AVX2
  .NET 8.0 : .NET 8.0.1 (8.0.123.58001), X64 RyuJIT AVX2

Job=.NET 8.0  Runtime=.NET 8.0  

Method	Items	Mean	Error	StdDev	Ratio	Rank	Gen0	Gen1	Gen2	Allocated	Alloc Ratio
AutoMapper	2500	1,697.0 μs	33.92 μs	58.50 μs	1.00	1	144.5313	142.5781	35.1563	1.5 MB	1.00
TinyMapper	2500	426.8 μs	1.94 μs	1.82 μs	1.00	1	99.1211	49.3164	-	1.24 MB	1.00
Mappee	2500	268.0 μs	2.85 μs	2.67 μs	1.00	1	140.6250	93.2617	-	1.75 MB	1.00
Handwritten	2500	233.5 μs	4.08 μs	3.62 μs	1.00	1	122.0703	66.4063	-	1.52 MB	1.00

---

1,5,20 items in 3 different collections and 1,5,20 nested objects (like linked list)

BenchmarkDotNet v0.13.12, Windows 11 (10.0.22631.3155/23H2/2023Update/SunValley3)
12th Gen Intel Core i7-12700K, 1 CPU, 20 logical and 12 physical cores
.NET SDK 8.0.101
  [Host]   : .NET 8.0.1 (8.0.123.58001), X64 RyuJIT AVX2
  .NET 8.0 : .NET 8.0.1 (8.0.123.58001), X64 RyuJIT AVX2

Job=.NET 8.0  Runtime=.NET 8.0  

Method	Items	Mean	Error	StdDev	Ratio	Rank	Gen0	Gen1	Allocated	Alloc Ratio
AutoMapper	5	928.6 ns	12.45 ns	11.64 ns	1.00	1	0.2775	0.0029	3.55 KB	1.00
TinyMapper	5	930.4 ns	9.43 ns	8.82 ns	1.00	1	0.2356	0.0019	3.01 KB	1.00
Mappee	5	457.6 ns	9.17 ns	10.56 ns	1.00	1	0.3252	0.0029	4.16 KB	1.00
Handwritten	5	368.8 ns	1.90 ns	1.58 ns	1.00	1	0.2813	0.0024	3.59 KB	1.00
AutoMapper	10	1,663.7 ns	14.35 ns	13.42 ns	1.00	1	0.5302	0.0095	6.79 KB	1.00
TinyMapper	10	1,708.8 ns	18.58 ns	17.38 ns	1.00	1	0.4387	0.0057	5.6 KB	1.00
Mappee	10	832.1 ns	13.57 ns	12.70 ns	1.00	1	0.6113	0.0095	7.8 KB	1.00
Handwritten	10	683.4 ns	5.36 ns	4.75 ns	1.00	1	0.5302	0.0076	6.77 KB	1.00
AutoMapper	20	3,082.1 ns	13.87 ns	12.30 ns	1.00	1	1.0376	0.0343	13.26 KB	1.00
TinyMapper	20	3,334.9 ns	65.42 ns	77.87 ns	1.00	1	0.8392	0.0229	10.72 KB	1.00
Mappee	20	1,575.2 ns	31.47 ns	52.58 ns	1.00	1	1.1768	0.0343	15.03 KB	1.00
Handwritten	20	1,313.9 ns	15.95 ns	14.14 ns	1.00	1	1.0223	0.0286	13.06 KB	1.00

Supported platforms

• .NET 8.0
• .NET 7.0
• .NET 6.0
• .NET Standard 2.1
• .NET Standard 2.0
• .NET Framework 4.8.1