https://github.com/panoramicdata/panoramicdata.mapper
A minimal, API-compatible replacement for AutoMapper. Supports convention-based mapping, ForMember, Ignore, MapFrom, AfterMap, ProjectTo, and DI integration.
https://github.com/panoramicdata/panoramicdata.mapper
Last synced: 2 months ago
JSON representation
A minimal, API-compatible replacement for AutoMapper. Supports convention-based mapping, ForMember, Ignore, MapFrom, AfterMap, ProjectTo, and DI integration.
- Host: GitHub
- URL: https://github.com/panoramicdata/panoramicdata.mapper
- Owner: panoramicdata
- License: mit
- Created: 2026-03-14T22:55:41.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-03-31T07:28:18.000Z (3 months ago)
- Last Synced: 2026-03-31T09:38:15.326Z (3 months ago)
- Language: C#
- Size: 101 KB
- Stars: 1
- Watchers: 1
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://opensource.org/licenses/MIT)
# PanoramicData.Mapper
A comprehensive, MIT-licensed, API-compatible replacement for AutoMapper.
[](https://www.nuget.org/packages/PanoramicData.Mapper/)
[](https://www.nuget.org/packages/PanoramicData.Mapper/)
[](https://app.codacy.com/gh/panoramicdata/PanoramicData.Mapper/dashboard?utm_source=gh&utm_medium=referral&utm_content=&utm_campaign=Badge_grade)
## 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
- **Convention-based mapping** — properties with matching names and compatible types map automatically
- **Profile-based configuration** — derive from `Profile` and call `CreateMap()`
- **ForMember / Ignore** — skip specific destination properties
- **ForMember / MapFrom** — custom source expressions including nested property access
- **BeforeMap / AfterMap** — inline lambda and generic `IMappingAction` pre/post-mapping callbacks
- **ForAllMembers** — apply configuration to all destination members
- **ReverseMap** — `.ReverseMap()` creates the inverse mapping automatically
- **ConvertUsing** — lambda, `ITypeConverter` type, or instance for full-type conversion
- **ConstructUsing** — custom destination construction via lambda
- **ForPath** — `.ForPath(d => d.Inner.Prop, opt => ...)` for deep nested member configuration
- **ForCtorParam** — `.ForCtorParam("name", opt => ...)` for constructor parameter mapping
- **Condition / PreCondition** — conditional member mapping (evaluated after/before value resolution)
- **NullSubstitute** — substitute a default value when the source resolves to null
- **Value Resolvers** — `IValueResolver` for custom resolution logic
- **Mapping Inheritance** — `Include`, `IncludeBase`, `IncludeAllDerived` for polymorphic hierarchies
- **Value Transformers** — `.AddTransform(expr)` for per-type value transforms
- **Open Generics** — `CreateMap(typeof(Source<>), typeof(Dest<>))` for generic type mappings
- **UseDestinationValue** — preserve existing destination property values
- **MaxDepth** — `.MaxDepth(n)` to limit recursive mapping depth
- **Map to new** — `mapper.Map(source)` creates a new destination
- **Map to existing** — `mapper.Map(source, destination)` updates an existing object
- **ProjectTo** — `IQueryable.ProjectTo(configurationProvider)` for EF Core SQL projection
- **[Ignore] attribute** — `PanoramicData.Mapper.Configuration.Annotations.IgnoreAttribute`
- **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>(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
- **AssertConfigurationIsValid** — detects unmapped destination properties at startup
- **IgnoreAllPropertiesWithAnInaccessibleSetter** — extension method to ignore all destination properties with non-public or absent setters
- **DI integration** — `AddAutoMapper()` extension methods for `IServiceCollection`
## Installation
```bash
dotnet add package PanoramicData.Mapper
```
## Quick Start
```csharp
using PanoramicData.Mapper;
// Define a profile
public class MyProfile : Profile
{
public MyProfile()
{
CreateMap()
.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());
config.AssertConfigurationIsValid();
IMapper mapper = config.CreateMapper();
var dest = mapper.Map(source);
```
## DI Registration
```csharp
// In Program.cs / Startup.cs
services.AddAutoMapper(typeof(MyProfile).Assembly);
// Or with explicit configuration
services.AddAutoMapper(cfg => cfg.AddProfile());
```
## 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](LICENSE) for details.