Niubility.LightDataAccess
2.1.8
dotnet add package Niubility.LightDataAccess --version 2.1.8
NuGet\Install-Package Niubility.LightDataAccess -Version 2.1.8
<PackageReference Include="Niubility.LightDataAccess" Version="2.1.8" />
paket add Niubility.LightDataAccess --version 2.1.8
#r "nuget: Niubility.LightDataAccess, 2.1.8"
// Install Niubility.LightDataAccess as a Cake Addin #addin nuget:?package=Niubility.LightDataAccess&version=2.1.8 // Install Niubility.LightDataAccess as a Cake Tool #tool nuget:?package=Niubility.LightDataAccess&version=2.1.8
EmitMapper
Project Description
What is EmitMapper
EmitMapper is a small library for parsing object-object clones, typically used to convert data objects into domain objects and vice versa.
Powerful customizable tool for mapping entities to each other. Entities can be plain objects, DataReaders, SQL commands and anything you need. The tool uses run-time code generation via the Emit library. It is useful for dealing with DTO objects, data access layers an so on.
How do I get started?
var simple = Mapper.Default.GetMapper<BenchNestedSource, BenchNestedDestination>();
BenchNestedDestination dest = simple.Map(_benchSource); //for single object;
List<BenchNestedDestination> dests = simple.MapEnum(_benchSources1000List);// for list object
Supported platforms:
- NETStandard 2.1
- .Net Framework 4.8
- net 6.0
- netcore app 3.1
Where can I get it?
First, install NuGet. Then, install EmitMapper from the package manager console:
Install-Package Niubility.EmitMapper
About Emit Mapper
- Overview
- Benefits of EmitMapper
- Getting started
- Type conversion
- Customization
Customization overview
Customization using default configurator
- Default configurator overview
- Custom converters
- Custom converters_for_generics
- Null substitution
- Ignoring members
- Custom constructors
- Shallow and_deep_mapping
- Names matching
- Post processing
Low-level customization using custom configuratorors
Emit Mapper in practice.
- Benchmark: EmitMapper vs Handwritten code vs AutoMapper
- Objects change tracking
- Mapping DbDatareader to objects
- Mapping objects to DbCommand (UPDATE and INSERT) Last edited Jan 11, 2010 at 3:01 PM by romankovs
Benchmark
BenchmarkDotNet=v0.13.1, OS=Windows 10.0.18363.2037 (1909/November2019Update/19H2)
Intel Core i5-8350U CPU 1.70GHz (Kaby Lake R), 1 CPU, 8 logical and 4 physical cores
.NET SDK=6.0.101
[Host] : .NET 6.0.1 (6.0.121.56705), X64 RyuJIT
.NET 6.0 : .NET 6.0.1 (6.0.121.56705), X64 RyuJIT
Job=.NET 6.0 Runtime=.NET 6.0
Method | Mean | Error | StdDev | Median | Ratio | Gen 0 | Gen 1 | Allocated |
---|---|---|---|---|---|---|---|---|
BenchNested_a_HardMapper | 0.8563 ns | 0.0173 ns | 0.0341 ns | 0.8489 ns | 1.00 | 0.0010 | - | 3 B |
BenchNested_b_EmitMapper | 0.8897 ns | 0.0431 ns | 0.1264 ns | 0.8451 ns | 1.00 | 0.0010 | - | 3 B |
BenchNested_c_AutoMapper | 16.5678 ns | 0.7823 ns | 2.2945 ns | 16.7384 ns | 1.00 | 0.0009 | - | 3 B |
BenchNested1000_a_HardMapper | 3,988.9549 ns | 79.6474 ns | 97.8142 ns | 3,965.5109 ns | 1.00 | 0.4766 | 0.2344 | 3,024 B |
BenchNested1000_b_EmitMapper | 3,781.9851 ns | 74.5756 ns | 122.5298 ns | 3,776.3773 ns | 1.00 | 0.4766 | 0.2344 | 3,024 B |
BenchNested1000_c_AutoMapper | 16,978.1985 ns | 333.1485 ns | 396.5896 ns | 16,966.0594 ns | 1.00 | 0.4688 | 0.2188 | 3,033 B |
SimpleTypes_a_HardMapper | 0.0310 ns | 0.0008 ns | 0.0023 ns | 0.0307 ns | 1.00 | 0.0000 | - | - |
SimpleTypes_b_EmitMapper | 0.0512 ns | 0.0009 ns | 0.0010 ns | 0.0513 ns | 1.00 | 0.0000 | - | - |
SimpleTypes_c_AutoMapper | 0.1718 ns | 0.0035 ns | 0.0076 ns | 0.1709 ns | 1.00 | 0.0000 | - | - |
SimpleTypes100_a_HardMapper | 4.0774 ns | 0.0804 ns | 0.1714 ns | 4.0509 ns | 1.00 | 0.0041 | - | 13 B |
SimpleTypes100_b_EmitMapper | 8.4392 ns | 0.4806 ns | 1.4020 ns | 8.3280 ns | 1.00 | 0.0044 | - | 14 B |
SimpleTypes100_c_AutoMapper | 8.4149 ns | 0.5269 ns | 1.5285 ns | 8.0763 ns | 1.00 | 0.0045 | - | 14 B |
SimpleTypes1000_a_HardMapper | 53.3382 ns | 1.0229 ns | 2.8684 ns | 52.6775 ns | 1.00 | 0.0320 | 0.0103 | 128 B |
SimpleTypes1000_b_EmitMapper | 81.6188 ns | 1.9400 ns | 5.5036 ns | 79.9001 ns | 1.00 | 0.0308 | 0.0101 | 128 B |
SimpleTypes1000_c_AutoMapper | 89.3916 ns | 4.3419 ns | 12.6655 ns | 86.0168 ns | 1.00 | 0.0369 | 0.0082 | 137 B |
Changelog
- Feb 8, 2022 The newest benchmark test is shown that the performance problem has been resolved. to see the method ToInt32(decimal?) of class NullableConverter
- Add github action for publish the package to nuget.org automatically
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net5.0 was computed. net5.0-windows was computed. net6.0 is compatible. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 was computed. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. |
.NET Core | netcoreapp3.0 was computed. netcoreapp3.1 was computed. |
.NET Standard | netstandard2.1 is compatible. |
.NET Framework | net48 is compatible. net481 was computed. |
MonoAndroid | monoandroid was computed. |
MonoMac | monomac was computed. |
MonoTouch | monotouch was computed. |
Tizen | tizen60 was computed. |
Xamarin.iOS | xamarinios was computed. |
Xamarin.Mac | xamarinmac was computed. |
Xamarin.TVOS | xamarintvos was computed. |
Xamarin.WatchOS | xamarinwatchos was computed. |
-
.NETFramework 4.8
- Microsoft.Bcl.HashCode (>= 1.1.1)
- Niubility.EmitMapper (>= 2.1.8)
-
.NETStandard 2.1
- Microsoft.Bcl.HashCode (>= 1.1.1)
- Niubility.EmitMapper (>= 2.1.8)
-
net6.0
- Microsoft.Bcl.HashCode (>= 1.1.1)
- Niubility.EmitMapper (>= 2.1.8)
NuGet packages (1)
Showing the top 1 NuGet packages that depend on Niubility.LightDataAccess:
Package | Downloads |
---|---|
Niubility.EMConfigurations
# EmitMapper ## Project Description [![CI](https://github.com/niubilitynetcore/EmitMapper/actions/workflows/dotnet.yml/badge.svg) ](https://github.com/niubilitynetcore/EmitMapper/actions/workflows/dotnet.yml) [![NuGet](https://img.shields.io/nuget/v/Niubility.EmitMapper.svg) ](https://www.nuget.org/packages/Niubility.EmitMapper/) ## What is EmitMapper EmitMapper is a small library for parsing object-object clones, typically used to convert data objects into domain objects and vice versa. Powerful customizable tool for mapping entities to each other. Entities can be plain objects, DataReaders, SQL commands and anything you need. The tool uses run-time code generation via the Emit library. It is useful for dealing with DTO objects, data access layers an so on. ## How do I get started? ```c# var simple = Mapper.Default.GetMapper<BenchNestedSource, BenchNestedDestination>(); BenchNestedDestination dest = simple.Map(_benchSource); //for single object; List<BenchNestedDestination> dests = simple.MapEnum(_benchSources1000List);// for list object ``` ## Supported platforms: * NETStandard 2.1 * .Net Framework 4.8 * net 6.0 * netcore app 3.1 ### Where can I get it? First, [install NuGet](http://docs.nuget.org/docs/start-here/installing-nuget). Then, install [EmitMapper](https://www.nuget.org/packages/Niubility.EmitMapper/) from the package manager console: ```dos Install-Package Niubility.EmitMapper ``` ## About Emit Mapper * Overview * Benefits of EmitMapper * Getting started * Type conversion * Customization # Customization overview Customization using default configurator * Default configurator overview * Custom converters * Custom converters_for_generics * Null substitution * Ignoring members * Custom constructors * Shallow and_deep_mapping * Names matching * Post processing Low-level customization using custom configuratorors # Emit Mapper in practice. * Benchmark: EmitMapper vs Handwritten code vs AutoMapper * Objects change tracking * Mapping DbDatareader to objects * Mapping objects to DbCommand (UPDATE and INSERT) Last edited Jan 11, 2010 at 3:01 PM by romankovs ## Benchmark ``` ini BenchmarkDotNet=v0.13.1, OS=Windows 10.0.18363.2037 (1909/November2019Update/19H2) Intel Core i5-8350U CPU 1.70GHz (Kaby Lake R), 1 CPU, 8 logical and 4 physical cores .NET SDK=6.0.101 [Host] : .NET 6.0.1 (6.0.121.56705), X64 RyuJIT .NET 6.0 : .NET 6.0.1 (6.0.121.56705), X64 RyuJIT Job=.NET 6.0 Runtime=.NET 6.0 ``` | Method | Mean | Error | StdDev | Median | Ratio | Gen 0 | Gen 1 | Allocated | |----------------------------- |---------------:|------------:|------------:|---------------:|------:|-------:|-------:|----------:| | BenchNested_a_HardMapper | 0.8563 ns | 0.0173 ns | 0.0341 ns | 0.8489 ns | 1.00 | 0.0010 | - | 3 B | | BenchNested_b_EmitMapper | 0.8897 ns | 0.0431 ns | 0.1264 ns | 0.8451 ns | 1.00 | 0.0010 | - | 3 B | | BenchNested_c_AutoMapper | 16.5678 ns | 0.7823 ns | 2.2945 ns | 16.7384 ns | 1.00 | 0.0009 | - | 3 B | | BenchNested1000_a_HardMapper | 3,988.9549 ns | 79.6474 ns | 97.8142 ns | 3,965.5109 ns | 1.00 | 0.4766 | 0.2344 | 3,024 B | | BenchNested1000_b_EmitMapper | 3,781.9851 ns | 74.5756 ns | 122.5298 ns | 3,776.3773 ns | 1.00 | 0.4766 | 0.2344 | 3,024 B | | BenchNested1000_c_AutoMapper | 16,978.1985 ns | 333.1485 ns | 396.5896 ns | 16,966.0594 ns | 1.00 | 0.4688 | 0.2188 | 3,033 B | | SimpleTypes_a_HardMapper | 0.0310 ns | 0.0008 ns | 0.0023 ns | 0.0307 ns | 1.00 | 0.0000 | - | - | | SimpleTypes_b_EmitMapper | 0.0512 ns | 0.0009 ns | 0.0010 ns | 0.0513 ns | 1.00 | 0.0000 | - | - | | SimpleTypes_c_AutoMapper | 0.1718 ns | 0.0035 ns | 0.0076 ns | 0.1709 ns | 1.00 | 0.0000 | - | - | | SimpleTypes100_a_HardMapper | 4.0774 ns | 0.0804 n |
GitHub repositories
This package is not used by any popular GitHub repositories.
Version | Downloads | Last updated |
---|---|---|
2.1.8 | 2,330 | 7/8/2022 |
2.1.7 | 2,124 | 5/10/2022 |
2.1.6 | 2,286 | 4/22/2022 |
2.1.5 | 2,172 | 4/22/2022 |
2.1.5-priview.2 | 126 | 4/22/2022 |
2.1.5-priview.1 | 115 | 4/22/2022 |
2.1.4 | 2,295 | 3/9/2022 |
2.1.4-preview.9 | 122 | 3/9/2022 |
2.1.4-preview.8 | 122 | 3/9/2022 |
2.1.4-preview.7 | 117 | 3/8/2022 |
2.1.4-preview.6 | 115 | 3/7/2022 |
2.1.4-preview.5 | 117 | 3/7/2022 |
2.1.4-preview.4 | 117 | 3/7/2022 |
2.1.4-preview.3 | 123 | 3/7/2022 |
2.1.4-preview.2 | 124 | 3/7/2022 |
2.1.4-preview.1 | 115 | 3/7/2022 |
2.1.3 | 2,182 | 3/7/2022 |
2.1.2 | 2,239 | 3/4/2022 |
2.1.2-beta.7 | 122 | 3/4/2022 |
2.1.2-beta.6 | 118 | 3/4/2022 |
2.1.1 | 2,249 | 3/4/2022 |
*** v2.1.8
- Optimized the Lambda Compile() to CompileFast()
*** v2.1.7
- Optimized the props include Directory.Build.props and solution.props
*** v2.1.6
- Optimized the props include Directory.Build.props and solution.props
*** v2.1.4
- Support .net core 3.1
*** v2.1.4-preview.9
- Support .net core 3.1
*** v2.1.3
- Stable version
- Optimized the performance simple type convertion
- Feb 8, 2022 The newest benchmark test is shown that the performance problem has been resolved. to see the method ToInt32(decimal?) of class NullableConverter
Add github action for publish the package to nuget.org automatically
*** v1.0.0
- Initial release.
See all on https://github.com/niubilitynetcore/EmitMapper/releases