Usage and configuration

📄️ Mapper configuration

The MapperAttribute provides options to customize the generated mapper class.

Mapperly supports static mappers and extension methods:

It is pretty common to flatten objects during mapping, eg. Car.Make.Id => CarDto.MakeId.

An enum mapping can be customized by setting the strategy to use.

To run custom code before or after a mapping, the generated map method can be wrapped in a custom method:

If Mapperly cannot generate a mapping, one can implement it manually simply by providing a method body in the mapper declaration:

Mapperly supports using parameterized constructors of mapping target types.

By default the generated code will instantiate objects using the default parameterless constructor if available.

If an existing object instance should be used as target, you can define the mapping method as void with the target as second parameter:

Mapperly can support mapping object structures with circular references.

Mapperly does support IQueryable projections:

Mapperly implements several types of automatic conversions (in order of priority):

Mapperly emits several diagnostics:

Most IDEs allow you to view the source code generated by Mapperly. Usually you can jump to the implementation via the partial mapper method.