AutoMappic 0.3.0

AutoMappic v0.3.0

Zero-Reflection. Zero-Overhead. Native AOT-First.

AutoMappic is a high-performance object-to-object mapper for .NET 9 and .NET 10. It uses Roslyn Interceptors to replace standard reflection-based mapping with statically-generated C# at compile time.

Table of Contents

1. Goals
2. Benchmarks
3. Quick Start
4. NuGet Packages
5. Diagnostics
6. Proven at Scale
7. Documentation

Goals

• High Performance: Faster than manual mapping by enabling aggressive JIT inlining of straight-line C# assignments.
• Native AOT Ready: 100% compatible with Native AOT and trimming. No dynamic code generation or reflection at runtime.
• Build-Time Safety: Mapping errors (ambiguity, missing members, circular references) are caught during compilation, not at runtime.
• Zero-Startup Cost: Eliminates reflection-based profile scanning. Dependency injection initializes instantly.

Development

AutoMappic is built for extreme performance using modern .NET tooling.

Tooling

• CSharpier: Opinionated code formatter for consistent semantics across the tree.
• Roslyn SDK: Powers the incremental source generator and interceptors.

Common Tasks

• Build: dotnet build /p:TreatWarningsAsErrors=true
• Test: dotnet run --project tests/AutoMappic.Tests/AutoMappic.Tests.csproj
• Bench: dotnet run -c Release --project tests/AutoMappic.Benchmarks/AutoMappic.Benchmarks.csproj

License

This project is licensed under the MIT License - see the LICENSE file for details.

Benchmarks

AutoMappic achieves performance parity with manual hand-written C# by shifting all mapping logic to compile-time.

Runtime Throughput (Mapping User to UserDto)

Quick Start

using AutoMappic;
using Microsoft.Extensions.DependencyInjection;

// 1. Define a Profile (Exactly like AutoMapper)
public class UserProfile : Profile
{
    public UserProfile()
    {
        CreateMap<User, UserDto>().ReverseMap();
    }
}

// 2. Setup Dependency Injection (AOT-Friendly!)
var services = new ServiceCollection();
services.AddAutoMappic(); // Compile-time discovery of all profiles

// 3. Use it (Async-Ready!)
var serviceProvider = services.BuildServiceProvider();
var mapper = serviceProvider.GetRequiredService<IMapper>();

// Zero dynamic code, 100% static execution
var dto = mapper.Map<User, UserDto>(new User { Name = "Digvijay Chauhan" });

NuGet Packages

• AutoMappic: The main package containing the IMapper abstractions and the runtime core.
• AutoMappic.Generator: The Roslyn incremental source generator. Typically included as a private asset/analyzer.

<PackageReference Include="AutoMappic" Version="0.3.0" />

Diagnostics

AutoMappic provides a rigorous build-time validation layer, ensuring structural integrity before the application starts.

Proven at Scale

AutoMappic has been verified as a drop-in replacement for complex enterprise templates like jasontaylordev/CleanArchitecture. By simply switching the namespace and enabling interceptors, even projects with deep Entity Framework projections and complex profiles can achieve Native AOT compatibility.

Documentation

For detailed guides, API reference, and advanced tutorials, visit our documentation site: automappic.digvijay.dev

Built for the .NET Community.