Added

• Added Config.RenderStructFieldPredicate, a predicate that controls which struct fields are rendered.
• Added support for rendering protobuf messages that use the "opaque" API.

Fixed

• Fixed rendering of sync.Mutex and sync.RWMutex under Go v1.24+.
• Fixed rendering of sync.Once under Go v1.25+.

This release is largely centered around a refactoring of the Config type and the way that a Printer is configured. It should not affect most users, but does introduce some breaking changes for filter authors.

Added

• Added Annotator, Config.Annotators and WithAnnotator, to add user-defined text annotations to rendered values.
• Added NewPrinter() function, that accepts the following functional options:
  • WithFilter()
  • WithDefaultFilters()
  • WithAnnotator()
  • WithUnexportedStructFields()
  • WithPackagePaths()

Changed

• [BC] Replaced Config.OmitUnexportedFields with RenderUnexportedStructFields, note the logic is inverted.
• [BC] Replaced Config.OmitPackagePaths with RenderPackagePaths, note the logic is inverted.
• Bumped the minimum supported Go version to 1.21.

Removed

• [BC] Removed DefaultPrinter, use NewPrinter() instead.
• [BC] Removed Config.Indent and DefaultIndent constant.
• [BC] Removed Config.RecursionMarker and DefaultRecursionMarker constant.
• [BC] Removed Config.ZeroValueMarker and DefaultZeroValueMarker constant.

Fixed

• Renderer.Config() and Renderer.WithModifiedConfig() now properly clone the slices within Config.

Fixed

• Fixed rendering of named types that was accidentally removed in [0.5.2].

Changed

• interface{} is now rendered as any.
• Zero-valued arrays are now rendered with the "zero value marker", similarly to structs.

Fixed

• Fixed inconsistent rendering of "element" type names within pointers, channels, maps, slices and functions.

Changed

• Use zero-allocation natural sorting algorithm from dogmatiq/jumble.

This release includes several changes to the experimental Filter system in preparation for unification of built-in and custom rendering behavior.

Added

• Added Renderer interface.
• Added ErrorFilter. Output for types that implement error now include the error message.
• Added Is(), AsConcrete() and AsImplementationOf() helpers for use in Filter implementations.

Changed

• [BC] The signature of Filter has changed to accept a Renderer and Value.
• [BC] Renamed ReflectTypeFilter to ReflectFilter, it now applies to the entire reflect package.
• [BC] Renamed ProtobufFilter to ProtoFilter.
• [BC] Changed Config.Indent to a string.

Removed

• [BC] Removed DurationFilter. TimeFilter now applies to the entire time package.
• Removed dependency on [Iago]

Fixed

• Fixed duplicate application of Filter that apply to specific interfaces when when T and *T both implement the interface.

Fixed

• Fix rendering of sync.RWMutex under Go v1.20

Fixed

• StringerFilter now takes precedence over all other filters
• FilterPrinter.Fallback() now only skips the filter it was called from

Added

• Add dapper.Stringer interface for types that produce their own dapper representation

Changed

• Rendering of Protocol Buffers messages is now consistent with other types

Added

• Improved rendering of protocol buffers messages (thanks @mrubiosan)