DotRMapper 1.0.0

DotRMapper

DotRMapper is a convention-based object-to-object mapper for .NET. It eliminates repetitive mapping code by automatically copying properties between types and providing a fluent API for custom transformations — similar to AutoMapper.

Table of Contents

• Features
• Installation
• Quick Start
• Documentation
• Running Tests
• Project Structure
• License

Features

Installation

Add a project reference to the library:

dotnet add reference path/to/DotRMapper/DotRMapper.csproj

Or, once published to NuGet:

dotnet add package DotRMapper

Requirements: .NET 8.0 or later.

Quick Start

1. Define your types

public class Source
{
    public int Id { get; set; }
    public string FirstName { get; set; } = string.Empty;
    public string LastName { get; set; } = string.Empty;
}

public class Destination
{
    public int Id { get; set; }
    public string FirstName { get; set; } = string.Empty;
    public string LastName { get; set; } = string.Empty;
    public string FullName { get; set; } = string.Empty;
}

2. Configure the mapper

using DotRMapper;
using DotRMapper.Abstractions.Configuration;

var config = new MapperConfiguration(cfg =>
{
    cfg.CreateMap<Source, Destination>()
        .ForMember(dest => dest.FullName, opt => opt.MapFrom(src => $"{src.FirstName} {src.LastName}"));
});

config.AssertConfigurationIsValid();
var mapper = config.CreateMapper();

3. Map objects

var source = new Source { Id = 1, FirstName = "John", LastName = "Doe" };
var destination = mapper.Map<Source, Destination>(source);

// destination.FullName == "John Doe"

Documentation

Running Tests

dotnet test

The test suite covers convention mapping, custom members, collections, profiles, reverse maps, validation, and enum conversions.

Project Structure

rimapper/
├── src/
│   └── DotRMapper/
│       ├── Abstractions/       # Public contracts (interfaces, Profile, ResolutionContext)
│       │   ├── Configuration/
│       │   ├── Converters/
│       │   └── Resolvers/
│       ├── Configuration/      # Mapping configuration implementations
│       ├── Internal/           # Engine and internal types
│       ├── Mapper.cs
│       └── MapperConfiguration.cs
├── tests/
│   └── DotRMapper.Tests/
├── docs/
└── DotRMapper.sln

Namespaces

License

This project is licensed under the MIT License.