https://github.com/riok/mapperly

A .NET source generator for generating object mappings. No runtime reflection.
https://github.com/riok/mapperly

c-sharp csharp csharp-sourcegenerator dotnet dotnet-core hacktoberfest mapping roslyn

Last synced: about 2 months ago
JSON representation

A .NET source generator for generating object mappings. No runtime reflection.

• Host: GitHub
• URL: https://github.com/riok/mapperly
• Owner: riok
• License: apache-2.0
• Created: 2022-02-14T09:13:56.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2024-04-13T02:32:28.000Z (2 months ago)
• Last Synced: 2024-04-13T12:50:27.575Z (2 months ago)
• Topics: c-sharp, csharp, csharp-sourcegenerator, dotnet, dotnet-core, hacktoberfest, mapping, roslyn
• Language: C#
• Homepage: https://mapperly.riok.app
• Size: 3.31 MB
• Stars: 2,295
• Watchers: 18
• Forks: 121
• Open Issues: 51
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md

Lists

• awesome-dotnet - Mapperly - A .NET source generator for generating object mappings. No runtime reflection. (Object to object mapping)
• csharp-source-generators - Mapperly -   - A source generator for generating object mappings. Inspired by MapStruct. (Source Generators / Mappers)
• Awesome-Nuget-Packages - **Mapperly**
• awesome - riok/mapperly - A .NET source generator for generating object mappings. No runtime reflection. (C\#)
• awesome - riok/mapperly - A .NET source generator for generating object mappings. No runtime reflection. (C\#)
• awesome-stars - mapperly
• RSCG_Examples - https://github.com/riok/mapperly

README

        
# Mapperly

[![Nuget](https://img.shields.io/nuget/v/Riok.Mapperly?style=flat-square)](https://www.nuget.org/packages/Riok.Mapperly/)

[![Nuget Preview](https://img.shields.io/nuget/vpre/Riok.Mapperly?style=flat-square&label=nuget%20preview)](https://www.nuget.org/packages/Riok.Mapperly/)

[![License](https://img.shields.io/github/license/riok/mapperly?style=flat-square)](https://github.com/riok/mapperly/blob/main/LICENSE)

[![Downloads](https://img.shields.io/nuget/dt/riok.mapperly?style=flat-square)](https://www.nuget.org/packages/Riok.Mapperly/)

[![GitHub Sponsors](https://img.shields.io/github/sponsors/riok)](https://github.com/sponsors/riok)

[![GitHub](https://img.shields.io/badge/-source-181717.svg?logo=GitHub)](https://github.com/riok/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](https://mapperly.riok.app/docs/getting-started/installation).

## Quickstart

### Installation

Add the NuGet Package to your project:

```bash

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.

```c#

// 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](https://mapperly.riok.app/docs/getting-started/installation) for any further information.

## Upgrading

Find a list of breaking changes for each major version and upgrade guides [here](https://mapperly.riok.app/docs/category/upgrading/).

## 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](https://mapperly.riok.app/docs/contributing/).

## License

Mapperly is [Apache 2.0](https://github.com/riok/mapperly/blob/main/LICENSE) licensed.