AutoMappic.Cli 0.4.0

AutoMappic v0.4.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. What's New in v0.4.0
2. Goals
3. Benchmarks
4. Quick Start
5. NuGet Packages
6. Diagnostics
7. Proven at Scale
8. Documentation

What's New in v0.4.0

v0.4.0 introduces Graph Mapping -- moving AutoMappic from simple tree-based mapping to enterprise-grade entity graph management, all while maintaining Native AOT and zero-allocation performance.

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

1. Add the package: dotnet add package AutoMappic
2. Define your Profile:

   public class MyProfile : AutoMappic.Profile {
       public MyProfile() { CreateMap<User, UserDto>(); }
   }
   

3. Map with Zero Overhead:

   var dto = mapper.Map<User, UserDto>(user); // Intercepted at compile-time!
   

Why AutoMappic?

• Native AOT Compatible: No runtime reflection, no dynamic IL emission.
• Zero Resolution Tax: Call-site interception binds source to destination at compile-time.
• Enterprise Ready: Support for cyclic graphs, identity management, and collection syncing.
• Diagnostic Safety: Rich build-time feedback (e.g., AM013 for patch-mode integrity).

Performance Comparison (v0.4.0)

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.4.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.