dapper

type Config struct {
	// Filters is the set of filters to apply when formatting values.
	Filters []Filter

	// Indent is the string used to indent nested values.
	// If it is empty, DefaultIndent is used.
	Indent []byte

	// ZeroValueMarker is a string that is displayed instead of a structs field
	// list when it is the zero-value. If it is empty, DefaultZeroValueMarker is
	// used.
	ZeroValueMarker string

	// RecursionMarker is a string that is displayed instead of a value's
	// representation when recursion has been detected.
	// If it is empty, DefaultRecursionMarker is used.
	RecursionMarker string

	// OmitPackagePaths, when true, causes the printer to omit the
	// fully-qualified package path from the rendered type names.
	OmitPackagePaths bool

	// OmitUnexportedFields omits unexported struct fields when set to true
	OmitUnexportedFields bool
}

type Filter func(
	w io.Writer,
	v Value,
	c Config,
	p FilterPrinter,
) error

type FilterPrinter interface {
	// Write writes a pretty-printed representation of v to w.
	Write(w io.Writer, v Value)

	// FormatTypeName returns the name of v's dynamic type, rendered as per the
	// printer's configuration.
	FormatTypeName(v Value) string

	// Fallback writes the filtered value using the standard pretty-printer.
	Fallback(w io.Writer, c Config)
}

type Printer struct {
	// Config is the configuration for the printer.
	Config Config
}

type Stringer interface {
	DapperString() string
}

type Value struct {
	// Value is the value to be formatted.
	Value reflect.Value

	// DynamicType is the value's type.
	DynamicType reflect.Type

	// StaticType is the type of the "variable" that the value is stored in, which
	// may not be the same as its dynamic type.
	//
	// For example, when formatting the values within a slice of interface{}
	// containing integers, such as []interface{}{1, 2, 3}, the DynamicType will be
	// "int", but the static type will be "interface{}".
	StaticType reflect.Type

	// IsAmbiguousDynamicType is true if the value's dynamic type is not clear from
	// the context of what has already been rendered.
	IsAmbiguousDynamicType bool

	// IsAmbiguousStaticType is true if the value's static type is not clear from
	// the context of what has already been rendered.
	IsAmbiguousStaticType bool

	// IsUnexported is true if this value was obtained from an unexported struct
	// field. If so, it is not possible to extract the underlying value.
	IsUnexported bool
}