https://github.com/noncommunicado/kutcode.automapper.extensions
Comfortable In-Type Map Profile Configuration
https://github.com/noncommunicado/kutcode.automapper.extensions
automapper automapper-alternative automapper-extension csharp dotnet extensions net7 net8
Last synced: 9 months ago
JSON representation
Comfortable In-Type Map Profile Configuration
- Host: GitHub
- URL: https://github.com/noncommunicado/kutcode.automapper.extensions
- Owner: noncommunicado
- Created: 2024-07-24T09:16:21.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2025-03-17T10:04:38.000Z (10 months ago)
- Last Synced: 2025-03-30T05:51:15.405Z (10 months ago)
- Topics: automapper, automapper-alternative, automapper-extension, csharp, dotnet, extensions, net7, net8
- Language: C#
- Homepage: https://www.nuget.org/packages/KutCode.AutoMapper.Extensions
- Size: 34.2 KB
- Stars: 3
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 
KutCode.AutoMapper.Extensions
.NET library that allows you:
- Configure Mappings in the type definition
- Use inheritance of interfaces for "default" mappings, without complex rules
## 📜 Installation
`KutCode.AutoMapper.Extensions` is designed with `net7.0` and higher.
Install `KutCode.AutoMapper.Extensions` using NuGet Package Manager:
```powershell
Install-Package KutCode.AutoMapper.Extensions
```
Or via the .NET CLI:
```shell
dotnet add package KutCode.AutoMapper.Extensions
```
All versions can be found [here](https://www.nuget.org/packages/KutCode.AutoMapper.Extensions/).
## 🚀 Quick Start
### Basic example
Let's declare two types:
```csharp
public class SomeEntity
{
public string Value { get;set; }
}
public class SomeDto : IMapWith // <-- just inherit it
{
public string Value { get;set; }
}
```
Use DI to configure AutoMapper:
```csharp
global using AutoMapper;
WebApplicationBuilder builder = WebApplication.CreateBuilder(args);
// just call this to scan All assemblies
builder.Services.AddAllMappings();
// or select assemblies manually
builder.Services.AddMappings(typeof(Program).Assembly, typeof(Domain).Assembly);
```
So, that's all, now you can map with AutoMapper's `IMapper` as usual:
```csharp
SomeDto dto = mapper.Map(entity);
```
----
### `IMapFrom` and `IMapTo`
⚠️ Whereas, you can also use those interfaces, which just calls `CreateMap()` if not overrided:
- `IMapFrom` create map from `T` to implementing class
- `IMapTo` create map from implementing class to `T`
----
### Override default mapping
If you just inherite interface `IMapWith` - that will created `.ReverseMap()` for two types.
So, you can override default mapping, and set your own behaviour:
```csharp
public class SomeDto : IMapWith
{
public string Value { get;set; }
// override Map method
public void Map(MapProfileDecorator decorator)
{
decorator.Profile.CreateMap()
.ForMember(m => m.Value, opt
=> opt.MapFrom(f => "SomeOverride")
);
}
}
```
----
### Use multiple interfaces
```csharp
public class SomeDto : IMapWith,
IMapTo, IMapFrom
{
public string Value { get;set; }
// also overrides available for all intrfaces
}
```
----
## ✨ Conclusion
- Use `IMapWith` for reverse mapping
- Use `IMapFrom` to map from `T` to an implementing type
- Use `IMapTo` to map from an implementing type to `T`
All of these interfaces allow you to override the `Map(MapProfileDecorator)` method to customize the mapping.
## ☕ Contribution
If you wanna to buy me a coffee, send any tokens in TON network:
💎 `noncommunicado.ton`
💎 `UQD0zFgp0p-eFnbL4cPA6DYqoeWzGbCA81KuU6BKwdFmf8jv`