Riok.Mapperly 4.0.0

Prefix Reserved
.NET Standard 2.0 This package targets .NET Standard 2.0. The package is compatible with this framework or higher.
There is a newer version of this package available.
See the version list below for details. 
dotnet add package Riok.Mapperly --version 4.0.0
                    


                    

                
NuGet\Install-Package Riok.Mapperly -Version 4.0.0
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="Riok.Mapperly" Version="4.0.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="Riok.Mapperly" Version="4.0.0" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="Riok.Mapperly" />
                    


                            Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package. 
paket add Riok.Mapperly --version 4.0.0
                    


                    

                
#r "nuget: Riok.Mapperly, 4.0.0"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
#:package Riok.Mapperly@4.0.0
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package. 
#addin nuget:?package=Riok.Mapperly&version=4.0.0
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=Riok.Mapperly&version=4.0.0
                    


                            Install as a Cake Tool

Mapperly

Nuget Nuget Preview License Downloads GitHub Sponsors GitHub

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.

Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 was computed.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 was computed.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
.NET Core netcoreapp2.0 was computed.  netcoreapp2.1 was computed.  netcoreapp2.2 was computed.  netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
.NET Standard netstandard2.0 is compatible.  netstandard2.1 was computed. 
.NET Framework net461 was computed.  net462 was computed.  net463 was computed.  net47 was computed.  net471 was computed.  net472 was computed.  net48 was computed.  net481 was computed. 
MonoAndroid monoandroid was computed. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen tizen40 was computed.  tizen60 was computed. 
Xamarin.iOS xamarinios was computed. 
Xamarin.Mac xamarinmac was computed. 
Xamarin.TVOS xamarintvos was computed. 
Xamarin.WatchOS xamarinwatchos was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

  • .NETStandard 2.0

    • No dependencies.

NuGet packages (23)

Showing the top 5 NuGet packages that depend on Riok.Mapperly:

Package Downloads
AssemblyAI

The AssemblyAI C# .NET SDK provides an easy-to-use interface for interacting with the AssemblyAI API, which supports async and real-time transcription, audio intelligence models, as well as the latest LeMUR models.
Indice.Hive.Core

Package Description
Rocket.Surgery.LaunchPad.Mapping

Package Description
Fanzoo.Kernel

An opinionated framework for building scalable web applications.
TossPlatform.Common

TossPlatform Common for SDK

GitHub repositories (24)

Showing the top 20 popular GitHub repositories that depend on Riok.Mapperly:

Repository Stars
abpframework/abp
Open-source web application framework for ASP.NET Core! Offers an opinionated architecture to build enterprise software solutions with best practices on top of the .NET. Provides the fundamental infrastructure, cross-cutting-concern implementations, startup templates, application modules, UI themes, tooling and documentation.
martinothamar/Mediator
A high performance implementation of Mediator pattern in .NET using source generators.
lookup-foundation/RevitLookup
Interactive Revit RFA and RVT project database exploration tool to view and navigate BIM element parameters, properties and relationships.
bitfoundation/bitplatform
Build all of your apps using what you already know and love ❤️
ldqk/Masuit.MyBlogs
基于C#/.NET8的 masuit.org个人博客站项目源码，https://masuit.org ，供参考、学习、引用、非商业性质的部署。
velopack/velopack
Installer and automatic update framework for cross-platform desktop applications
mehdihadeli/food-delivery-microservices
🍔 A practical and cloud-native food delivery microservices, built with .Net Aspire, .Net 9, MassTransit, Domain-Driven Design, CQRS, Vertical Slice Architecture, Event-Driven Architecture, and the latest technologies.
Tim-Maes/Facet
Source generator for creating compile-time facets of your models, features mapping and LINQ projections, zero runtime overhead.
ThingsGateway/ThingsGateway
ThingsGateway is a cross-platform, high-performance gateway for edge data acquisition and IoT connectivity. Developed with .NET 8, it offers a suite of powerful tools, including advanced PLC communication libraries and debugging software.
yanpitangui/dotnet-api-boilerplate
A Dotnet 9.0 WebApi template project. MediatR, Swagger, Mapper, Serilog and more implemented.
nkdAgility/azure-devops-migration-tools
Azure DevOps Migration Tools allow you to migrate Teams, Backlogs, Work Items, Tasks, Test Cases, and Plans & Suits from one Project to another in Azure DevOps / TFS both within the same Organisation, and between Organisations.
mehdihadeli/vertical-slice-api-template
🍰 An asp.net core template based on .Net 9, Vertical Slice Architecture, CQRS, Minimal APIs, OpenTelemetry, API Versioning and OpenAPI.
josephnhtam/live-streaming-server-net
A .NET implementation of RTMP live streaming server, supporting HTTP-FLV, WebSocket-FLV, HLS, Kubernetes, cloud storage services integration and more.
higty/higlabo
HigLabo library provide 1.AI client library(OpenAI, Anthoripic, Groq) 2.Object Mapper(fastest in the world) 3.DbSharp(DAL generator) 4.Other.(Mail, Ftp, Utility...etc)
svrooij/WinTuner
Package any app from Winget to Intune - WinTuner
Azure/iotedge-lorawan-starterkit
Sample implementation of LoRaWAN components to connect LoRaWAN antenna gateway running IoT Edge directly with Azure IoT.
westonwalker/BlazorMinimalAPI
asesidaa/EXVS2-POC
SapiensAnatis/Dawnshard
Server emulator for Dragalia Lost
harrison314/BouncyHsm
Bouncy Hsm is a software simulator of HSM and smartcard simulator with HTML UI, REST API and PKCS#11 interface.
Version Downloads Last Updated
4.3.0-next.4 0 9/18/2025
4.3.0-next.3 3,358 7/29/2025
4.3.0-next.2 4,947 6/16/2025
4.3.0-next.1 407 6/13/2025
4.3.0-next.0 1,521 5/27/2025
4.2.1 1,234,429 4/23/2025
4.2.1-next.2 218 4/21/2025
4.2.1-next.1 257 4/20/2025
4.2.1-next.0 952 4/8/2025
4.2.0 372,809 3/26/2025
4.2.0-next.2 1,193 3/18/2025
4.2.0-next.1 3,484 2/17/2025
4.2.0-next.0 51,044 1/20/2025
4.1.1 2,341,586 11/20/2024
4.1.1-next.0 22,828 11/5/2024
4.1.0 610,693 10/31/2024
4.1.0-next.3 189 10/29/2024
4.1.0-next.2 1,012 10/25/2024
4.1.0-next.1 1,116 10/14/2024
4.1.0-next.0 8,108 10/11/2024
4.0.0 287,679 10/11/2024
4.0.0-next.4 2,849 9/29/2024
4.0.0-next.3 27,919 8/13/2024
4.0.0-next.2 533 8/6/2024
4.0.0-next.1 12,755 6/30/2024
3.6.0 1,783,000 6/18/2024
3.6.0-next.2 3,682 6/3/2024
3.6.0-next.1 7,926 5/3/2024
3.5.1 604,272 4/23/2024
3.5.1-next.2 3,812 4/15/2024
3.5.1-next.1 282 4/9/2024
3.5.0 440,684 4/5/2024
3.5.0-next.4 1,490 3/27/2024
3.5.0-next.3 9,919 3/18/2024
3.5.0-next.2 37,453 3/11/2024
3.5.0-next.1 953 3/9/2024
3.4.0 487,320 2/23/2024
3.4.0-next.5 1,906 2/20/2024
3.4.0-next.4 931 2/16/2024
3.4.0-next.3 5,490 2/5/2024
3.4.0-next.2 24,694 1/10/2024
3.4.0-next.1 377 1/6/2024
3.3.1-next.1 2,998 12/18/2023
3.3.0 691,908 12/12/2023
3.3.0-next.6 1,060 12/6/2023
3.3.0-next.5 1,421 11/28/2023
3.3.0-next.4 2,805 11/22/2023
3.3.0-next.3 9,225 11/19/2023
3.3.0-next.2 4,003 10/26/2023
3.3.0-next.1 4,009 10/11/2023
3.2.0 786,795 9/18/2023
3.2.0-next.4 1,450 9/12/2023
3.2.0-next.3 536 9/11/2023
3.2.0-next.2 399 9/5/2023
3.2.0-next.1 551 8/29/2023
3.1.0 166,688 8/18/2023
3.1.0-next.2 170 8/18/2023
3.1.0-next.1 4,793 8/8/2023
3.0.0 46,527 8/7/2023
3.0.0-next.1 487 8/2/2023
2.9.0-next.4 7,879 7/26/2023
2.9.0-next.3 978 7/16/2023
2.9.0-next.2 5,154 6/13/2023
2.9.0-next.1 5,678 5/11/2023
2.8.0 668,830 4/27/2023
2.8.0-next.2 593 4/20/2023
2.8.0-next.1 19,646 3/23/2023
2.7.1-next.1 738 3/17/2023
2.7.0 192,651 3/13/2023
2.7.0-next.2 927 1/26/2023
2.7.0-next.1 689 1/23/2023
2.6.0 113,723 1/12/2023
2.6.0-next.4 195 1/11/2023
2.6.0-next.3 247 1/9/2023
2.6.0-next.2 387 12/14/2022
2.6.0-next.1 661 12/12/2022
2.5.0 96,084 10/12/2022
2.5.0-next.2 422 9/28/2022
2.5.0-next.1 329 9/19/2022
2.4.1-next.1 294 9/16/2022
2.4.0 22,175 9/8/2022
2.3.3 3,253 8/10/2022
2.3.2 1,042 8/9/2022
2.3.1 61,806 5/31/2022
2.3.0 2,550 5/16/2022
2.2.1 3,682 4/6/2022
2.2.0 1,403 3/15/2022
2.1.0 1,223 2/28/2022
2.0.0 1,402 2/21/2022

🚨 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/