Info
Version: | 2.0.3-beta.2 |
Author(s): | Val Melamed |
Last Update: | Monday, September 3, 2018 |
.NET Fiddle: | Create the first Fiddle |
Project Url: | https://github.com/vmelamed/vm/tree/master/Aspects/Diagnostics |
NuGet Url: | https://www.nuget.org/packages/vm.Aspects.Diagnostics.ObjectTextDumper |
Install
Install-Package vm.Aspects.Diagnostics.ObjectTextDumper
dotnet add package vm.Aspects.Diagnostics.ObjectTextDumper
paket add vm.Aspects.Diagnostics.ObjectTextDumper
vm.Aspects.Diagnostics.ObjectTextDumper Download (Unzip the "nupkg" after downloading)
Dependencies
Tags
Helpful for debugging and logging purposes.
Features:
* The dump output is separated from the targeted dump media by the familiar TextWriter interface
* The programmer can dump the value of any type of object: primitive and enum types (including those marked with FlagsAttribute), custom classes, struct-s, collections, etc.
* For complex type objects (classes and structs) the dumper outputs the names and the values of the properties
* The dump is recursive: the complex members of the dumped object are dumped indented
* Dumps the elements of sequences (arrays, lists, dictionaries, etc.)
* Handles circular references
* The developers can easily customize various aspects of the dump by using an attribute (DumpAttribute) on the classes and their members, such as:
- the order in which the properties are dumped
- formatting of the property names and/or values
- suppressing the dump of some uninteresting properties
- masking the values of sensitive properties (e.g.
PII)
- the depth of the recursion into complex members
- the maximum number of dumped elements of sequence properties
* The dumper picks the customization attributes also from buddy classes declared with MetadataTypeAttribute
* Even if the class doesn't have any attributes, the programmer can still pass a metadata class as a separate parameter to the dumping method. This allows for control over the dump of BCL and third party classes
* Built and tested with .NET 4.5.2, 4.6.2, 4.7.2, .NET Standard 2.0
For more information see the documentation at https://github.com/vmelamed/vm/blob/master/Aspects/Diagnostics/ObjectDumper.md.