dapper

Dapper

Dapper is a pretty-printer for Go values that aims to produce the shortest possible output without ambiguity. Additionally, the output is deterministic, which allows for the generation of human-readable diffs using standard tools.

Example

This example renders a basic tree structure. Note that the output only includes type names where the value's type can not be inferred from the context.

Code

package main

import (
	"fmt"
	"github.com/dogmatiq/dapper"
)

type TreeNode struct {
	Name     string
	Value    interface{}
	Children []*TreeNode
}

type NodeValue struct{}

func main() {
	v := TreeNode{
		Name: "root",
		Children: []*TreeNode{
			{
				Name:  "branch #1",
				Value: 100,
			},
			{
				Name:  "branch #2",
				Value: NodeValue{},
			},
		},
	}

	s := dapper.Format(v)
	fmt.Println(s)
}

Output

main.TreeNode{
    Name:     "root"
    Value:    nil
    Children: {
        {
            Name:     "branch #1"
            Value:    int(100)
            Children: nil
        }
        {
            Name:     "branch #2"
            Value:    main.NodeValue{}
            Children: nil
        }
    }
}