DotNetToolbox.ObjectDumper 8.0.2

Object Dumper (DotNetToolbox.ObjectDumper)

Introduction

DotNetToolbox.ObjectDumper is a powerful .NET 8 library for converting objects into a human-readable string representations. It provides customizable formatting options, including indentation, maximum depth control, and the ability to specify custom formatters for specific types. This library is particularly useful for logging, debugging, and serialization scenarios where a visual representation of an object is needed.

Table of Contents

1. Installation
2. Dependencies
3. Key Features
4. Extension Methods
5. Object Dumping
6. JSON Object Dumping
7. Customization

Installation

The DotNet Toolbox Object Dumper is available as a NuGet package. To install it, run the following command in the Package Manager Console:

PM> Install-Package DotNetToolbox.ObjectDumper

Dependencies

• .NET 8

Extension Methods

The library extends any object with Dump and DumpAsJson methods, allowing any object to be dumped easily without requiring manual instantiation of dumper objects.

Examples:

1. Dumping an object using default options:

   var person = new Person { Name = "John Doe", Age = 30 };
   Console.WriteLine(person.Dump());
   

2. Customizing the dump output:

   Console.WriteLine(person.Dump(options => {
       options.IndentSize = 2;
       options.UseTabs = true;
       options.UseFullNames = true;
   });
   

3. Dumping an object as JSON:

   Console.WriteLine(person.DumpAsJson());
   

4. Customizing JSON dump options:

   Console.WriteLine(person.DumpAsJson(options => {
       options.Indented = false;
       options.MaxDepth = 5;
   }));
   

Object Dumping

The core feature of DotNetToolbox.ObjectDumper is to create a human-readable string representation of an object. It traverses the object graph and outputs a formatted string that shows the types, properties, and values.

JSON Object Dumping

In addition to the custom object dumping, the library also provides support for dumping objects as JSON strings using the System.Text.Json serializer, offering a familiar and standardized output.

Customization

DotNetToolbox.ObjectDumper allows extensive customization of the output format:

• DumpBuilderOptions: Determines the behavior of the main object dumper. Users can configure indentation style, indent size, and whether to use full type names.
• JsonDumpBuilderOptions: Configures the JSON object dumper, with options for indentation and maximum object graph traversal depth.

One of the powerful features of DumpBuilderOptions is the ability to define custom formatters for types. This allows you to control exactly how objects of certain types are represented in the output.

Custom Formatter Example:

1. Defining a custom formatter for a type:

   string customDump = person.Dump(options => {
       options.CustomFormatters[typeof(DateTime)] = value => ((DateTime)value).ToString("yyyy-MM-dd");
   });
   Console.WriteLine(customDump);
   

In this example, all DateTime objects within the person object will be formatted using the "yyyy-MM-dd" format.