Diagnosticable mixin

A mixin class for providing string and DiagnosticsNode debug representations describing the properties of an object.

The string debug representation is generated from the intermediate DiagnosticsNode representation. The DiagnosticsNode representation is also used by debugging tools displaying interactive trees of objects and properties.

See also:

• debugFillProperties, which lists best practices for specifying the properties of a DiagnosticsNode. The most common use case is to override debugFillProperties defining custom properties for a subclass of DiagnosticableTreeMixin using the existing DiagnosticsProperty subclasses.
• DiagnosticableTree, which extends this class to also describe the children of a tree structured object.
• DiagnosticableTree.debugDescribeChildren, which lists best practices for describing the children of a DiagnosticsNode. Typically the base class already describes the children of a node properly or a node has no children.
• DiagnosticsProperty, which should be used to create leaf diagnostic nodes without properties or children. There are many DiagnosticsProperty subclasses to handle common use cases.