XMapper 3.0.1

XMapper

The object-to-object mapper for C# that can be setup in a readable one-liner. No Attributes, no configuration - just write intuitive and safe code that works immediately. <p align="center"> <img src="https://avatars.githubusercontent.com/u/103217522?s=150&v=4" alt="XMapper logo"/> </p>

Available via NuGet.

Introduction

There's only one class in this package: XMapper<TSource, TTarget>. It has a single parameter of type PropertyList.

These are all the public methods:

• IgnoreSourceProperty
• IgnoreTargetProperty
• IncludeAction
• Map (2 overloads)

Hovering over XMapper and its methods in your editor will provide guiding documentation.

Examples

using XMapper;

Map to new

var dummy1 = new Dummy1 { ... };

var mapper = new XMapper<Dummy1, Dummy2>(PropertyList.Source);

var dummy2 = mapper.Map(dummy1);

Map to exising

var d1 = new Dummy1 { ... };
var d2 = new Dummy2 { ... };

var mapper = new XMapper<Dummy1, Dummy2>(PropertyList.Target)
    .IgnoreTargetProperty(x => x.Id);

mapper.Map(d1, d2);

Custom mapping of ValueTypes

var d1 = new Dummy1 { ... };
var d2 = new Dummy2 { ... };

var mapper = new XMapper<Dummy1, Dummy2>(PropertyList.Source)
    .IgnoreSourceProperty(x => x.MyInt)
    .IncludeAction((source, target) => target.MyInt = source.MyEnum > someValue ? null : source.Number * 10);

mapper.Map(d1, d2);

Map enumerable members to another target type

From Array to List with reference type elements:

var d1Xd2 = new XMapper<Dummy1, Dummy2>(PropertyList.Source);
var mapper = new XMapper<DummyA, DummyB>(PropertyList.Source)
    .IgnoreSourceProperty(x => x.Dummy1Array)
    .IncludeAction((source, target) => target.Dummy2List = source.Dummy1Array?.Select(x => d1Xd2.Map(x)).ToList());

From Array to List with ValueType elements:

var mapper = new XMapper<DummyA, DummyB>(PropertyList.Source)
    .IgnoreSourceProperty(x => x.XIntArray)
    .IncludeAction((source, target) => target.XIntList = source.XIntArray?.ToList());

Map non-enumerable reference type members to another target type

var dummyA = new DummyA
{
    Dummy1Property = new Dummy1
    {
        ...
    },
    ...
};

var d1Xd2 = new XMapper<Dummy1, Dummy2>(PropertyList.Source);
var mapper = new XMapper<DummyA, DummyB>(PropertyList.Target)
    .IgnoreTargetProperty(x => x.Dummy2Property)
    .IncludeAction((dummyA, dummyB) =>
    {
        if (dummyA.Dummy1Property == null)
        {
            dummyB.Dummy2Property = null;
        }
        else
        {
            d1Xd2.Map(dummyA.Dummy1Property, dummyB.Dummy2Property ??= new());
        }
    });

var dummyB = mapper.Map(dummyA);
var dummy2 = dummyB.Dummy2Property

Testing

Automate the testing of all your object-to-object mappers with one line of unit test code via XMapper.Testing.