Getting Started Guide

What is MappingGenerator?

MappingGenerator is C# source generator that allows generating object mapping code on compilation stage.

Having source code for your mappings generated provides the following benefits:

• Your mappings are always up to date.

• You see code for all your mappings. Nothing is hidden.

• All debugging features are available. You can step-in to your mappings, set breakpoints etc.

• If mapping can’t be done or has issues you get compiler errors rather than runtime errors.

Note. C# source generators require NET5.0 or higher.

How do I get started?

Install Talk2Bits.MappingGenerator nuget package.

Define source and destination:

public class Source
{
    public int Number { get; set; }

    public string Text { get; set; }

    public long BigNumber { get; set; }
}

public class Destination
{
    public int Number { get; set; }

    public string Text { get; set; }

    public long BigNumber { get; set; }
}

Define mapper “anchor” class:

[MappingGenerator(typeof(Source), typeof(Destination))]
public partial class Mapper
{ }

Rebuild your project

Use generated mapping:

var source = new Source();
var mapper = new Mapper();
var result = mapper.Map(source);