TWCore.Serialization.NSerializer 3.1.0-beta1

This is a prerelease version of TWCore.Serialization.NSerializer.
There is a newer version of this package available.
See the version list below for details.
dotnet add package TWCore.Serialization.NSerializer --version 3.1.0-beta1                
NuGet\Install-Package TWCore.Serialization.NSerializer -Version 3.1.0-beta1                
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="TWCore.Serialization.NSerializer" Version="3.1.0-beta1" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add TWCore.Serialization.NSerializer --version 3.1.0-beta1                
#r "nuget: TWCore.Serialization.NSerializer, 3.1.0-beta1"                
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install TWCore.Serialization.NSerializer as a Cake Addin
#addin nuget:?package=TWCore.Serialization.NSerializer&version=3.1.0-beta1&prerelease

// Install TWCore.Serialization.NSerializer as a Cake Tool
#tool nuget:?package=TWCore.Serialization.NSerializer&version=3.1.0-beta1&prerelease                

<img src="https://raw.githubusercontent.com/tonyredondo/TWCore2/master/doc/icon.png" alt="Potato" width="45px" height="45px" /> TWCore 3.1

Build status Nuget

A multipurpose framework library used to create microservices solutions on multiple platforms (runs on windows, linux, linux-arm [raspberry pi], and osx).

Compatible with

  • .NET Framework 4.7.2
  • netstandard2.0
  • netcoreapp2.1
  • netcoreapp2.2
  • netcoreapp3.1
  • net5.0
  • net6.0
  • net7.0
  • net8.0

Advantages

  • Easy development of microservices: With fewer code you can subscribe to a message broker and start to process messages as pub/sub or RPC architecture.
  • Completely agnostic and loosely coupled: All subsystems of the framework are registered with a dependency injector engine, so using only the configurations files you can switch between Messages brokers, Serialization formats, Rpc transports, Stream compressors, and many more.
  • Integrated Log, Trace, and Status engines: you can log on different storage, also use differents trace storages and you have an integrated status library to check your service health.
  • A bot subsystem to create bot services on Telegram and Slack
  • Extensions methods for objects, strings, and IEnumerables.
  • Aspnet Core object viewer and compiler developer tool.
Supported log storages
  • Console
  • File
  • Html File
  • MessageBroker
  • ElasticSearch
  • Mail
Supported trace storages
  • File
  • MessageBroker
Supported compressors
  • Gzip
  • Deflate
  • Brotli
Supported messages brokers
  • RabbitMQ
  • NATS
  • NSQ
  • Kafka
  • Redis (Pub/Sub)
Supported key/value cache storages
  • Custom TWCore
  • Redis
Supported bot connectors
  • Slack
  • Telegram
Supported serializers
  • Newtonsoft JsonNet
  • XmlSerializer
  • BinaryFormatter
  • Utf8Json
  • MsgPack
  • NSerializer (Custom binary serializer with object reference graph support and cyclic reference)
  • RawSerializer (Like NSerializer but without internal caching, faster, but serialized objects are bigger in bytes size.)

Simple Object Serializer Benchmark

BenchmarkDotNet=v0.11.3, OS=Windows 10.0.17134.523 (1803/April2018Update/Redstone4)\
Intel Core i7-4770R CPU 3.20GHz (Haswell), 1 CPU, 8 logical and 4 physical cores\
.NET Core SDK=2.2.101\
  [Host] : .NET Core 2.2.0 (CoreCLR 4.6.27110.04, CoreFX 4.6.27110.04), 64bit RyuJIT\
  Core   : .NET Core 2.2.0 (CoreCLR 4.6.27110.04, CoreFX 4.6.27110.04), 64bit RyuJIT\
Job=Core  Runtime=Core
Method N Mean Error StdDev Min Max Gen 0/1k Op Gen 1/1k Op Gen 2/1k Op Allocated Memory/Op
NewtonsoftJsonSerializerToStream 1 42.935 us 0.4296 us 0.4019 us 42.123 us 43.608 us 3.6621 0.1831 - 23296 B
NewtonsoftJsonDeserializerFromStream 1 78.432 us 1.5565 us 1.4560 us 76.154 us 80.546 us 3.5400 0.8545 - 22960 B
XmlSerializerToStream 1 45.512 us 0.3721 us 0.3299 us 44.858 us 46.154 us 1.8921 - - 12224 B
XmlDeserializerFromStream 1 91.809 us 1.4537 us 1.3598 us 89.874 us 94.327 us 4.5166 0.3662 - 28608 B
BinaryFormatterSerializerToStream 1 53.381 us 0.5491 us 0.5137 us 52.418 us 54.022 us 2.5635 - - 16504 B
BinaryFormatterDeserializerFromStream 1 44.802 us 0.5174 us 0.4840 us 43.914 us 45.613 us 3.6011 0.4883 - 22720 B
Utf8JsonSerializerToStream 1 7.609 us 0.1364 us 0.1276 us 7.429 us 7.832 us - - - -
Utf8JsonDeserializerFromStream 1 20.249 us 0.2015 us 0.1885 us 20.009 us 20.641 us 0.9460 0.1831 - 6016 B
MessagePackSerializerToStream 1 7.777 us 0.0682 us 0.0638 us 7.658 us 7.900 us - - - 96 B
MessagePackDeserializerFromStream 1 11.087 us 0.1592 us 0.1489 us 10.795 us 11.419 us 1.3123 0.3204 - 8272 B
NSerializerToStream 1 7.823 us 0.1440 us 0.1347 us 7.607 us 8.051 us - - - -
NDeserializerFromStream 1 7.301 us 0.0702 us 0.0657 us 7.106 us 7.405 us 0.4425 0.0458 - 2800 B
RawSerializerToStream 1 6.574 us 0.1298 us 0.1275 us 6.375 us 6.781 us - - - -
RawDeserializerFromStream 1 7.837 us 0.0655 us 0.0613 us 7.748 us 7.937 us 0.5569 0.0763 - 3520 B

<img src="https://raw.githubusercontent.com/tonyredondo/TWCore2/master/doc/serializer-deserializer1.png" alt="Serializer Graph" />

Created by Daniel Redondo

Powered By

<img src="https://raw.githubusercontent.com/tonyredondo/TWCore2/master/doc/rider.jpg" alt="Rider" width="50px" height="50px" /><img src="https://raw.githubusercontent.com/tonyredondo/TWCore2/master/doc/dotTrace.png" alt="dotTrace" width="50px" height="50px" /><img src="https://raw.githubusercontent.com/tonyredondo/TWCore2/master/doc/dotMemory.png" alt="dotMemory" width="50px" height="50px" />

Thanks to @jetbrains for helping on this development with the licenses for Rider, dotTrace and dotMemory

Product Compatible and additional computed target framework versions.
.NET net5.0 is compatible.  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 is compatible.  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 is compatible.  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 netcoreapp2.0 was computed.  netcoreapp2.1 is compatible.  netcoreapp2.2 is compatible.  netcoreapp3.0 was computed.  netcoreapp3.1 is compatible. 
.NET Standard netstandard2.0 is compatible.  netstandard2.1 was computed. 
.NET Framework net461 was computed.  net462 was computed.  net463 was computed.  net47 was computed.  net471 was computed.  net472 is compatible.  net48 was computed.  net481 was computed. 
MonoAndroid monoandroid was computed. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen tizen40 was computed.  tizen60 was computed. 
Xamarin.iOS xamarinios was computed. 
Xamarin.Mac xamarinmac was computed. 
Xamarin.TVOS xamarintvos was computed. 
Xamarin.WatchOS xamarinwatchos was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
3.1.0 274 10/22/2023
3.1.0-beta2 98 10/20/2023
3.1.0-beta1 97 10/19/2023
3.0.0-beta5 436 9/8/2019
3.0.0-beta4 385 9/8/2019
3.0.0-beta3 416 8/20/2019
3.0.0-beta2 381 8/18/2019
3.0.0-beta1 383 8/18/2019
2.1.181 666 7/24/2019
2.1.181-beta5 441 7/16/2019
2.1.181-beta4 426 5/10/2019
2.1.181-beta3 442 3/16/2019
2.1.181-beta2 439 3/8/2019
2.1.181-beta 470 3/3/2019
2.1.180 561 3/1/2019
2.1.180-rc1 465 2/28/2019
2.1.180-beta9 517 2/14/2019
2.1.180-beta8 478 2/14/2019
2.1.180-beta7 503 2/8/2019
2.1.180-beta6 538 2/7/2019
2.1.180-beta5 509 2/6/2019
2.1.180-beta4 510 2/5/2019
2.1.180-beta3 513 2/4/2019
2.1.180-beta2 498 2/4/2019
2.1.180-beta1 513 2/4/2019
2.1.180-alpha8 512 1/30/2019
2.1.180-alpha7 502 1/22/2019
2.1.180-alpha6 499 1/21/2019
2.1.180-alpha5 544 1/18/2019
2.1.180-alpha4 540 1/17/2019
2.1.180-alpha3 531 1/16/2019
2.1.180-alpha2 518 1/16/2019
2.1.180-alpha1 527 1/15/2019
2.1.179 676 1/9/2019
2.1.179-beta9 504 1/3/2019
2.1.179-beta8 550 1/2/2019
2.1.179-beta7 575 1/2/2019
2.1.179-beta6 496 12/21/2018
2.1.179-beta5 495 12/19/2018
2.1.179-beta4 496 12/19/2018
2.1.179-beta3 553 12/19/2018
2.1.179-beta2 537 12/18/2018
2.1.179-beta12 547 1/8/2019
2.1.179-beta11 525 1/7/2019
2.1.179-beta10 513 1/4/2019
2.1.179-beta1 521 12/18/2018
2.1.179-alpha9 502 12/18/2018
2.1.179-alpha8 544 11/28/2018
2.1.179-alpha7 546 11/22/2018
2.1.179-alpha6 566 11/20/2018
2.1.179-alpha5 556 11/20/2018
2.1.179-alpha4 548 11/20/2018
2.1.179-alpha3 581 11/19/2018
2.1.179-alpha2 541 11/16/2018
2.1.179-alpha 555 11/16/2018
2.1.178 739 11/6/2018
2.1.178-beta2 535 11/6/2018
2.1.178-beta1 554 10/29/2018
2.1.178-alpha7 584 10/22/2018
2.1.178-alpha6 577 10/19/2018
2.1.178-alpha5 556 10/17/2018
2.1.178-alpha4 542 10/14/2018
2.1.178-alpha3 586 10/13/2018
2.1.178-alpha2 581 10/9/2018
2.1.178-alpha 558 10/9/2018
2.1.177 739 9/27/2018
2.1.177-rc4 577 9/26/2018
2.1.177-rc3 581 9/26/2018
2.1.177-rc2 563 9/26/2018
2.1.177-rc1 566 9/25/2018
2.1.177-beta 559 9/25/2018
2.1.177-alpha 563 9/24/2018
2.1.176 723 9/20/2018
2.1.175 758 9/19/2018
2.1.174 735 9/16/2018
2.1.173 725 9/12/2018
2.1.173-beta 583 9/12/2018
2.1.172 742 9/11/2018
2.1.171 757 8/27/2018
2.1.171-rc1 624 8/27/2018
2.1.171-beta 608 8/27/2018
2.1.170 816 8/15/2018
2.1.169 777 8/14/2018
2.1.168 819 8/10/2018
2.1.167 852 8/9/2018
2.1.166 861 8/9/2018
2.1.165 879 8/9/2018
2.1.164 850 8/8/2018
2.1.163 790 8/8/2018
2.1.162 775 8/8/2018
2.1.161 808 8/8/2018
2.1.160 809 8/7/2018
2.1.159 822 8/3/2018
2.1.158 826 8/2/2018
2.1.157 794 8/1/2018
2.1.156 804 7/30/2018
2.1.155 782 7/29/2018
2.1.154 898 7/19/2018
2.1.153 897 7/12/2018
2.1.152 924 7/11/2018
2.1.151 869 7/11/2018
2.1.150 937 7/11/2018
2.1.149 918 7/10/2018
2.1.148 894 7/4/2018
2.1.147 874 7/3/2018
2.1.146 886 7/1/2018
2.1.145 871 7/1/2018
2.1.144 876 6/28/2018
2.1.143 795 6/25/2018
2.1.142 895 6/19/2018
2.1.141 883 6/19/2018
2.1.140 879 6/18/2018
2.0.149 955 7/10/2018
2.0.148 882 7/4/2018
2.0.147 884 7/3/2018
2.0.146 800 7/1/2018
2.0.145 893 7/1/2018
2.0.144 811 6/28/2018
2.0.143 882 6/25/2018
2.0.142 884 6/19/2018
2.0.141 818 6/19/2018
2.0.140 818 6/18/2018
2.0.139 891 6/18/2018
2.0.138 786 6/15/2018
2.0.137 893 6/15/2018
2.0.136 877 6/12/2018
2.0.135 853 6/11/2018
2.0.134 868 6/11/2018
2.0.133 804 6/11/2018
0.2.132 944 5/25/2018
0.2.131 869 5/21/2018
0.2.130 961 5/20/2018
0.2.129 819 5/20/2018
0.2.128 815 5/14/2018
0.2.127 816 5/11/2018
0.2.126 892 5/10/2018
0.2.125 871 5/8/2018
0.2.124 966 4/30/2018
0.2.123 932 4/29/2018
0.2.122 870 4/27/2018
0.2.121 818 4/26/2018
0.2.120 930 4/25/2018
0.2.119 910 4/25/2018
0.2.118 936 4/25/2018
0.2.117 903 4/24/2018
0.2.116 798 4/24/2018
0.2.115 838 4/19/2018
0.2.114 874 4/19/2018
0.2.113 908 4/19/2018
0.2.112 882 4/18/2018
0.2.111 873 4/18/2018
0.2.110 914 4/18/2018
0.2.109 873 4/17/2018
0.2.108 834 4/17/2018