Riok.Mapperly 4.0.0
Mapperly
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.
Documentation
The documentation is available here.
Quickstart
Installation
Add the NuGet Package to your project:
dotnet add package Riok.Mapperly
Create your first mapper
Create 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.Should().Be(10);
Read the docs for any further information.
Upgrading
Find a list of breaking changes for each major version and upgrade guides here.
How To Contribute
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.
License
Mapperly is Apache 2.0 licensed.
No packages depend on Riok.Mapperly.
🚨 Breaking Changes
ignore indexed properties by @latonz in #1351
add enum underlying type conversion by @latonz in #1352
strict mappings by default by @latonz in #1353
support mapping properties of custom collection mappings by @latonz in #1364
improve handling of read-only and immutable types by @latonz in #1413
improve member matching performance for member names with lots of upper case letters by @latonz in #1447
enum from/to string explicit mappings by @BeeTwin in #1483
🚀 Features
introduce MapValueAttribute to map constant values and method provided values by @latonz in #1335
add MappingTarget attribute to set the mapping target as the first parameter by @latonz in #1376
support additional mapping method parameters by @latonz in #1400
inline methods consisting of a single return statement or local variable declaration expression by @hartmair in #1422
support private constructors by @latonz in #1405
improve handling of read-only and immutable types by @latonz in #1413
improve constructor mapping readability by @aradalvand in #1448
add support for mappers being nested under interfaces or records by @david-driscoll in #1464
enum from/to string explicit mappings by @BeeTwin in #1483
enum from/to string naming strategies for different letter casings by @BeeTwin in #1486
enum from/to string naming strategies for DescriptionAttribute and EnumMemberAttribute by @latonz in #1507
🐛 Bug Fixes
adjust diagnostic messages to be correct when applied with MapValue by @latonz in #1332
allow same-name members with different casings by @latonz in #1350
replace invalid MapPropertyAttribute constructors with valid versions by @latonz in #1354
failing projection with static mapper from another assembly by @trejjam in #1418
collect EnumerateUnmappedOrConfiguredTargetMembers to prevent collection was modified exception by @trejjam in #1438
support inline expression with casting by @trejjam in #1419
correct map nested interfaced enumerations by @latonz in #1404
only initialize unflattened nullable target members when needed by @latonz in #1408
improve handling of read-only and immutable types by @latonz in #1413
improve member matching performance for member names with lots of upper case letters by @latonz in #1447
initialize nullable values when assigning null to a child member by @latonz in #1449
report inaccessible constructor instead of mapping could not be created by @latonz in #1462
support inlining of method with generic type arguments by @trejjam in #1498
refactor member matching and member mapping building process by @latonz in #1334
Full Changelog: https://github.com/riok/mapperly/compare/v3.6.0...v4.0.0 Migration guide: https://mapperly.riok.app/docs/breaking-changes/4-0/
.NET Standard 2.0
- No dependencies.
| Version | Downloads | Last updated |
|---|---|---|
| 4.3.1-next.0 | 3 | 12/10/2025 |
| 4.3.0 | 0 | 10/21/2025 |
| 4.3.0-next.6 | 1 | 12/14/2025 |
| 4.3.0-next.5 | 1 | 12/10/2025 |
| 4.3.0-next.4 | 0 | 09/18/2025 |
| 4.3.0-next.3 | 0 | 07/29/2025 |
| 4.3.0-next.2 | 0 | 06/16/2025 |
| 4.3.0-next.1 | 0 | 06/13/2025 |
| 4.3.0-next.0 | 1 | 12/11/2025 |
| 4.2.1 | 63 | 12/10/2025 |
| 4.2.1-next.2 | 0 | 04/21/2025 |
| 4.2.1-next.1 | 2 | 12/10/2025 |
| 4.2.1-next.0 | 0 | 04/08/2025 |
| 4.2.0 | 1 | 12/10/2025 |
| 4.2.0-next.2 | 0 | 03/18/2025 |
| 4.2.0-next.1 | 0 | 02/17/2025 |
| 4.2.0-next.0 | 0 | 01/20/2025 |
| 4.1.1 | 1 | 12/11/2025 |
| 4.1.1-next.0 | 2 | 12/10/2025 |
| 4.1.0 | 0 | 12/12/2025 |
| 4.1.0-next.3 | 0 | 10/29/2024 |
| 4.1.0-next.2 | 0 | 10/25/2024 |
| 4.1.0-next.1 | 0 | 12/12/2025 |
| 4.1.0-next.0 | 0 | 10/11/2024 |
| 4.0.0 | 1 | 12/14/2025 |
| 4.0.0-next.4 | 1 | 12/11/2025 |
| 4.0.0-next.3 | 1 | 12/10/2025 |
| 4.0.0-next.2 | 0 | 08/06/2024 |
| 4.0.0-next.1 | 0 | 06/30/2024 |
| 3.6.0 | 1 | 12/12/2025 |
| 3.6.0-next.2 | 0 | 06/03/2024 |
| 3.6.0-next.1 | 0 | 05/03/2024 |
| 3.5.1 | 0 | 04/23/2024 |
| 3.5.1-next.2 | 1 | 12/12/2025 |
| 3.5.1-next.1 | 1 | 12/12/2025 |
| 3.5.0 | 0 | 04/05/2024 |
| 3.5.0-next.4 | 0 | 03/27/2024 |
| 3.5.0-next.3 | 0 | 03/18/2024 |
| 3.5.0-next.2 | 1 | 12/10/2025 |
| 3.5.0-next.1 | 1 | 12/10/2025 |
| 3.4.0 | 0 | 02/23/2024 |
| 3.4.0-next.5 | 0 | 02/20/2024 |
| 3.4.0-next.4 | 0 | 02/16/2024 |
| 3.4.0-next.3 | 0 | 02/05/2024 |
| 3.4.0-next.2 | 0 | 01/10/2024 |
| 3.4.0-next.1 | 0 | 01/06/2024 |
| 3.3.1-next.1 | 2 | 12/10/2025 |
| 3.3.0 | 0 | 12/12/2023 |
| 3.3.0-next.6 | 0 | 12/06/2023 |
| 3.3.0-next.5 | 0 | 11/28/2023 |
| 3.3.0-next.4 | 0 | 11/22/2023 |
| 3.3.0-next.3 | 0 | 11/19/2023 |
| 3.3.0-next.2 | 0 | 10/26/2023 |
| 3.3.0-next.1 | 1 | 12/11/2025 |
| 3.2.0 | 1 | 12/11/2025 |
| 3.2.0-next.4 | 0 | 09/12/2023 |
| 3.2.0-next.3 | 1 | 12/10/2025 |
| 3.2.0-next.2 | 2 | 12/10/2025 |
| 3.2.0-next.1 | 1 | 12/10/2025 |
| 3.1.0 | 0 | 08/18/2023 |
| 3.1.0-next.2 | 0 | 08/18/2023 |
| 3.1.0-next.1 | 2 | 12/10/2025 |
| 3.0.0 | 0 | 08/07/2023 |
| 3.0.0-next.1 | 1 | 12/11/2025 |
| 2.9.0-next.4 | 2 | 12/10/2025 |
| 2.9.0-next.3 | 1 | 12/11/2025 |
| 2.9.0-next.2 | 1 | 12/13/2025 |
| 2.9.0-next.1 | 0 | 05/11/2023 |
| 2.8.0 | 1 | 12/12/2025 |
| 2.8.0-next.2 | 1 | 12/10/2025 |
| 2.8.0-next.1 | 0 | 03/23/2023 |
| 2.7.1-next.1 | 0 | 03/17/2023 |
| 2.7.0 | 1 | 12/11/2025 |
| 2.7.0-next.2 | 1 | 12/11/2025 |
| 2.7.0-next.1 | 1 | 12/11/2025 |
| 2.6.0 | 0 | 01/12/2023 |
| 2.6.0-next.4 | 0 | 01/11/2023 |
| 2.6.0-next.3 | 0 | 01/09/2023 |
| 2.6.0-next.2 | 0 | 12/14/2022 |
| 2.6.0-next.1 | 0 | 12/12/2022 |
| 2.5.0 | 0 | 10/12/2022 |
| 2.5.0-next.2 | 2 | 12/10/2025 |
| 2.5.0-next.1 | 0 | 09/19/2022 |
| 2.4.1-next.1 | 1 | 12/11/2025 |
| 2.4.0 | 0 | 09/08/2022 |
| 2.3.3 | 0 | 08/10/2022 |
| 2.3.2 | 0 | 08/09/2022 |
| 2.3.1 | 1 | 12/13/2025 |
| 2.3.0 | 0 | 05/16/2022 |
| 2.2.1 | 1 | 12/14/2025 |
| 2.2.0 | 2 | 12/10/2025 |
| 2.1.0 | 0 | 02/28/2022 |
| 2.0.0 | 0 | 02/21/2022 |