Mapperly is a .NET source generator for generating object mappings.
Because Mapperly creates the mapping code at build time, there is minimal overhead at runtime. Even better, the generated code is perfectly readable, allowing you to verify the generated mapping code easily.
The documentation is available here.
Add the NuGet Package to your project:
dotnet add package Riok.MapperlyCreate a mapper declaration as a partial class
and apply the Riok.Mapperly.Abstractions.MapperAttribute attribute.
Mapperly generates mapping method implementations for the defined mapping methods in the mapper.
// Mapper declaration
[Mapper]
public partial class CarMapper
{
public partial CarDto CarToCarDto(Car car);
}
// Mapper usage
var mapper = new CarMapper();
var car = new Car { NumberOfSeats = 10, ... };
var dto = mapper.CarToCarDto(car);
dto.NumberOfSeats.ShouldBe(10);Read the docs for any further information.
Mapperly is distributed through two release channels:
- Stable Channel: Production-ready releases with full support for the latest release. Install the latest stable version for production use. Subject to semantic versioning (breaking changes only in major version bumps).
- Next Channel: Preview releases with upcoming features and improvements. These versions may contain breaking changes and are not subject to semantic versioning. Use for testing and early access to new features.
Only the latest version released on the stable channel is fully supported. We strive to support all .NET versions that are currently supported by Microsoft.
Find a list of breaking changes for each major version and upgrade guides here.
Need assistance with Mapperly or looking for consulting services? The riok team is available to help with:
- Enterprise support and training
- Architecture consultation
- Custom feature development and integration support
- Performance optimization and code reviews
Reach out through GitHub Discussions for questions, or contact the riok team directly for professional consulting services at hello@riok.ch. You can also support the project and get priority support through GitHub Sponsors.
We would love for you to contribute to Mapperly and help make it even better than it is today! Find information on how to contribute in the docs.
Mapperly is Apache 2.0 licensed.
