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.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.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 287 10/22/2023
3.1.0-beta2 103 10/20/2023
3.1.0-beta1 101 10/19/2023
3.0.0-beta5 454 9/8/2019
3.0.0-beta4 403 9/8/2019
3.0.0-beta3 434 8/20/2019
3.0.0-beta2 400 8/18/2019
3.0.0-beta1 402 8/18/2019
2.1.181 684 7/24/2019
2.1.181-beta5 459 7/16/2019
2.1.181-beta4 445 5/10/2019
2.1.181-beta3 462 3/16/2019
2.1.181-beta2 459 3/8/2019
2.1.181-beta 490 3/3/2019
2.1.180 581 3/1/2019
2.1.180-rc1 485 2/28/2019
2.1.180-beta9 537 2/14/2019
2.1.180-beta8 499 2/14/2019
2.1.180-beta7 523 2/8/2019
2.1.180-beta6 558 2/7/2019
2.1.180-beta5 530 2/6/2019
2.1.180-beta4 530 2/5/2019
2.1.180-beta3 534 2/4/2019
2.1.180-beta2 519 2/4/2019
2.1.180-beta1 534 2/4/2019
2.1.180-alpha8 532 1/30/2019
2.1.180-alpha7 522 1/22/2019
2.1.180-alpha6 519 1/21/2019
2.1.180-alpha5 564 1/18/2019
2.1.180-alpha4 560 1/17/2019
2.1.180-alpha3 551 1/16/2019
2.1.180-alpha2 538 1/16/2019
2.1.180-alpha1 547 1/15/2019
2.1.179 698 1/9/2019
2.1.179-beta9 524 1/3/2019
2.1.179-beta8 571 1/2/2019
2.1.179-beta7 595 1/2/2019
2.1.179-beta6 516 12/21/2018
2.1.179-beta5 515 12/19/2018
2.1.179-beta4 516 12/19/2018
2.1.179-beta3 578 12/19/2018
2.1.179-beta2 557 12/18/2018
2.1.179-beta12 567 1/8/2019
2.1.179-beta11 545 1/7/2019
2.1.179-beta10 533 1/4/2019
2.1.179-beta1 541 12/18/2018
2.1.179-alpha9 522 12/18/2018
2.1.179-alpha8 566 11/28/2018
2.1.179-alpha7 569 11/22/2018
2.1.179-alpha6 591 11/20/2018
2.1.179-alpha5 581 11/20/2018
2.1.179-alpha4 575 11/20/2018
2.1.179-alpha3 608 11/19/2018
2.1.179-alpha2 569 11/16/2018
2.1.179-alpha 580 11/16/2018
2.1.178 766 11/6/2018
2.1.178-beta2 562 11/6/2018
2.1.178-beta1 581 10/29/2018
2.1.178-alpha7 612 10/22/2018
2.1.178-alpha6 603 10/19/2018
2.1.178-alpha5 584 10/17/2018
2.1.178-alpha4 569 10/14/2018
2.1.178-alpha3 614 10/13/2018
2.1.178-alpha2 609 10/9/2018
2.1.178-alpha 585 10/9/2018
2.1.177 772 9/27/2018
2.1.177-rc4 603 9/26/2018
2.1.177-rc3 607 9/26/2018
2.1.177-rc2 592 9/26/2018
2.1.177-rc1 595 9/25/2018
2.1.177-beta 588 9/25/2018
2.1.177-alpha 592 9/24/2018
2.1.176 759 9/20/2018
2.1.175 791 9/19/2018
2.1.174 767 9/16/2018
2.1.173 756 9/12/2018
2.1.173-beta 611 9/12/2018
2.1.172 773 9/11/2018
2.1.171 790 8/27/2018
2.1.171-rc1 651 8/27/2018
2.1.171-beta 637 8/27/2018
2.1.170 850 8/15/2018
2.1.169 810 8/14/2018
2.1.168 852 8/10/2018
2.1.167 885 8/9/2018
2.1.166 890 8/9/2018
2.1.165 912 8/9/2018
2.1.164 881 8/8/2018
2.1.163 838 8/8/2018
2.1.162 824 8/8/2018
2.1.161 858 8/8/2018
2.1.160 853 8/7/2018
2.1.159 868 8/3/2018
2.1.158 872 8/2/2018
2.1.157 842 8/1/2018
2.1.156 850 7/30/2018
2.1.155 832 7/29/2018
2.1.154 967 7/19/2018
2.1.153 968 7/12/2018
2.1.152 994 7/11/2018
2.1.151 941 7/11/2018
2.1.150 1,009 7/11/2018
2.1.149 988 7/10/2018
2.1.148 964 7/4/2018
2.1.147 946 7/3/2018
2.1.146 958 7/1/2018
2.1.145 943 7/1/2018
2.1.144 948 6/28/2018
2.1.143 844 6/25/2018
2.1.142 967 6/19/2018
2.1.141 955 6/19/2018
2.1.140 951 6/18/2018
2.0.149 1,023 7/10/2018
2.0.148 956 7/4/2018
2.0.147 954 7/3/2018
2.0.146 849 7/1/2018
2.0.145 965 7/1/2018
2.0.144 860 6/28/2018
2.0.143 954 6/25/2018
2.0.142 956 6/19/2018
2.0.141 867 6/19/2018
2.0.140 867 6/18/2018
2.0.139 963 6/18/2018
2.0.138 833 6/15/2018
2.0.137 963 6/15/2018
2.0.136 949 6/12/2018
2.0.135 925 6/11/2018
2.0.134 940 6/11/2018
2.0.133 853 6/11/2018
0.2.132 1,016 5/25/2018
0.2.131 941 5/21/2018
0.2.130 1,035 5/20/2018
0.2.129 869 5/20/2018
0.2.128 869 5/14/2018
0.2.127 870 5/11/2018
0.2.126 974 5/10/2018
0.2.125 953 5/8/2018
0.2.124 1,048 4/30/2018
0.2.123 1,014 4/29/2018
0.2.122 924 4/27/2018
0.2.121 872 4/26/2018
0.2.120 1,012 4/25/2018
0.2.119 992 4/25/2018
0.2.118 1,018 4/25/2018
0.2.117 985 4/24/2018
0.2.116 852 4/24/2018
0.2.115 917 4/19/2018
0.2.114 956 4/19/2018
0.2.113 991 4/19/2018
0.2.112 964 4/18/2018
0.2.111 955 4/18/2018
0.2.110 994 4/18/2018
0.2.109 953 4/17/2018
0.2.108 916 4/17/2018