PanoramicData.Mapper 10.0.85

PanoramicData.Mapper

Need help with APIs or .NET? Panoramic Data are experts in APIs and .NET, and we can help with your development. Contact us or see our software services.

A comprehensive, MIT-licensed, API-compatible replacement for AutoMapper.

Supports .NET Standard 2.0 and .NET 11.0.

Overview

PanoramicData.Mapper is a comprehensive, API-compatible replacement for AutoMapper with convention-based object mapping, explicit member configuration, and advanced features including mapping inheritance, value resolvers, type converters, open generics, EF Core projection, and more. It is a clean-room, black-box reimplementation — no AutoMapper source code was referenced.

Supported Features

Configuration & setup

• Profile-based configuration — derive from Profile and call CreateMap<TSource, TDestination>()
• Convention-based mapping — properties with matching names and compatible types map automatically
• ReverseMap — .ReverseMap() creates the inverse mapping automatically
• AssertConfigurationIsValid — detects unmapped destination properties at startup
• DI integration — AddAutoMapper() extension methods for IServiceCollection

Member configuration

• ForMember / Ignore — skip specific destination properties
• ForMember / MapFrom — custom source expressions including nested property access
• Condition / PreCondition — conditional member mapping (evaluated after/before value resolution)
• NullSubstitute — substitute a default value when the source resolves to null
• UseDestinationValue — preserve existing destination property values
• ForPath — .ForPath(d => d.Inner.Prop, opt => ...) for deep nested member configuration
• ForCtorParam — .ForCtorParam("name", opt => ...) for constructor parameter mapping
• ForAllMembers — apply configuration to all destination members
• [Ignore] attribute — PanoramicData.Mapper.Configuration.Annotations.IgnoreAttribute
• IgnoreAllPropertiesWithAnInaccessibleSetter — extension method to ignore all destination properties with non-public or absent setters

Custom resolution & hooks

• ConvertUsing — lambda, ITypeConverter<TSrc, TDst> type, or instance for full-type conversion
• ConstructUsing — custom destination construction via lambda
• Value Resolvers — IValueResolver<TSrc, TDst, TMember> for custom resolution logic
• Value Transformers — .AddTransform<T>(expr) for per-type value transforms
• BeforeMap / AfterMap — inline lambda and generic IMappingAction<TSrc, TDest> pre/post-mapping callbacks

Type relationships

• Nested mappings — recursive mapping of complex child types and collection properties when a CreateMap exists for the child types
• Collection/List/Array mapping — mapper.Map<List<Dest>>(sourceList) maps collections automatically when an element-type map is registered
• Flattening — PascalCase destination property names are split and traversed on the source graph (e.g. CustomerName → Customer.Name); also matches GetX() methods
• Mapping Inheritance — Include, IncludeBase, IncludeAllDerived for polymorphic hierarchies
• Open Generics — CreateMap(typeof(Source<>), typeof(Dest<>)) for generic type mappings
• MaxDepth — .MaxDepth(n) to limit recursive mapping depth

Execution & projection

• Map to new — mapper.Map<TDest>(source) creates a new destination
• Map to existing — mapper.Map(source, destination) updates an existing object
• ProjectTo — IQueryable<T>.ProjectTo<TDest>(configurationProvider) for EF Core SQL projection, including recursive projection of nested complex members and collections of complex elements
• ExplicitExpansion — .ForMember(d => d.Children, opt => opt.ExplicitExpansion()) excludes a member from ProjectTo projections unless requested via ProjectTo(config, d => d.Children); has no effect on in-memory Map

Installation

dotnet add package PanoramicData.Mapper

Quick Start

using PanoramicData.Mapper;

// Define a profile
public class MyProfile : Profile
{
    public MyProfile()
    {
        CreateMap<Source, Destination>()
            .ForMember(d => d.Secret, opt => opt.Ignore())
            .ForMember(d => d.FullName, opt => opt.MapFrom(s => s.FirstName + " " + s.LastName));
    }
}

// Configure and use
var config = new MapperConfiguration(cfg => cfg.AddProfile<MyProfile>());
config.AssertConfigurationIsValid();

IMapper mapper = config.CreateMapper();
var dest = mapper.Map<Destination>(source);

DI Registration

// In Program.cs / Startup.cs
services.AddAutoMapper(typeof(MyProfile).Assembly);

// Or with explicit configuration
services.AddAutoMapper(cfg => cfg.AddProfile<MyProfile>());

Migration from AutoMapper

1. Replace the AutoMapper NuGet package with PanoramicData.Mapper
2. Update using directives:
   • using AutoMapper; → using PanoramicData.Mapper;
   • using AutoMapper.QueryableExtensions; → using PanoramicData.Mapper.QueryableExtensions;
   • using AutoMapper.Configuration.Annotations; → using PanoramicData.Mapper.Configuration.Annotations;
3. The AddAutoMapper() DI extension methods and all type names (Profile, IMapper, MapperConfiguration, etc.) remain the same

License

MIT — see LICENSE for details.