com.wiwish.library.MapSharp 0.9.0

MapSharp

MapSharp is a lightweight, high-performance .NET object-to-object mapper that keeps mapping configuration explicit, readable, and easy to maintain.

Current package version: 0.8.0

Quick start

var configuration = new MapperConfiguration(cfg =>
{
	cfg.CreateMap<User, UserDto>()
		.ForMember(d => d.DisplayName, opt => opt.MapFrom(s => s.Name));
});

configuration.AssertConfigurationIsValid();

var mapper = configuration.CreateMapper();
var dto = mapper.Map<UserDto>(new User { Name = "Alice" });

Current feature coverage

Version 0.8.0 emphasizes faster steady-state runtime mapping while preserving the existing explicit configuration model and feature set.

• Mapping configuration:
  • CreateMap<TSource, TDestination>()
  • ForMember(...).MapFrom(expression)
  • ForMember(...).MapFrom<TResolver>()
  • ForMember(...).MapFromWithContext<TResolver>()
  • ForMember(...).Condition(...) (runtime mapping only)
  • Ignore(...) for destination properties, including read-only properties when you want them excluded from validation/mapping rules
  • ForSourceMember(..., opt => opt.DoNotValidate()) when source-member validation is enabled
  • ConvertUsing<TConverter>()
  • BeforeMap<TAction>() / AfterMap<TAction>()
  • ReverseMap() basics
• Runtime mapping:
  • Typed and object-based Map(...) overloads
  • Map-into-existing-instance overload: Map<TSource, TDestination>(source, destination)
    • Typed options overload: Map<TSource, TDestination>(source, Action<IMappingOperationOptions<TSource, TDestination>> options)
    • Automatic proxy-aware source type fallback (exact runtime source type first, then configured base types/interfaces)
  • Configuration access from mapper via IMapper.ConfigurationProvider
  • Nested object mapping
  • Collection mapping (arrays and common list/enumerable destinations)
  • Primitive and enum conversion support
  • Per-call mapping items via IMappingOperationOptions.Items
  • Typed per-call option helpers via Set<T>(...) and TryGet<T>(...)
• Projection:
  • IQueryable projection via ProjectTo
  • Supports convention mapping, MapFrom(expression), and Ignore(...)
• Extensibility hooks:
  • ITypeConverter<TSource, TDestination>
  • IValueResolver<TSource, TDestination, TDestMember>
  • IValueResolverWithContext<TSource, TDestination, TDestMember>
  • IMappingAction<TSource, TDestination>
• Configuration validation via AssertConfigurationIsValid()
  • Optional relaxed validation via AllowUnmappedDestinationMembers()
  • Optional strict source-member validation via ValidateSourceMembers()
  • Source members consumed through custom resolvers cannot be inferred statically; mark them with ForSourceMember(..., opt => opt.DoNotValidate()) when needed
• DI integration package: MapSharp.Extensions.Microsoft.DependencyInjection
  • ConstructServicesUsing(Func<Type, object>)
  • ConstructServicesUsing(IServiceProvider)

Known limitations

• Configuration API is intentionally smaller than other similar tools.
• ProjectTo does not support ConvertUsing, resolver-based members, BeforeMap/AfterMap, or conditional member mapping.
• Advanced member options and naming-convention customization are not yet complete.
• Source-member validation only understands convention-based mappings and MapFrom(expression); resolver-based source usage must be marked explicitly with ForSourceMember(..., opt => opt.DoNotValidate()).

Release documentation

• Migration notes
• Known gaps
• Compatibility matrix

Benchmark baseline

A simple benchmark harness is included in benchmarks/MapSharp.Benchmarks. It uses BenchmarkDotNet and writes reports to BenchmarkDotNet.Artifacts. Recent benchmark work for 0.8.0 focused on improving warmed mapping throughput and reducing runtime overhead in common mapping scenarios. Run it with:

dotnet run --project benchmarks/MapSharp.Benchmarks/MapSharp.Benchmarks.csproj -c Release