gotest.tools: gotest.tools/golden Index | Examples | Files

package golden

import "gotest.tools/golden"

Package golden provides tools for comparing large mutli-line strings.

Golden files are files in the ./testdata/ subdirectory of the package under test.

Index

Examples

Package Files

golden.go

func Assert Uses

func Assert(t assert.TestingT, actual string, filename string, msgAndArgs ...interface{})

Assert compares the actual content to the expected content in the golden file. If the `-test.update-golden` flag is set then the actual content is written to the golden file. Returns whether the assertion was successful (true) or not (false). This is equivalent to assert.Check(t, String(actual, filename))

Code:

golden.Assert(t, "foo", "foo-content.golden")

func AssertBytes Uses

func AssertBytes(
    t assert.TestingT,
    actual []byte,
    filename string,
    msgAndArgs ...interface{},
)

AssertBytes compares the actual result to the expected result in the golden file. If the `-test.update-golden` flag is set then the actual content is written to the golden file. Returns whether the assertion was successful (true) or not (false). This is equivalent to assert.Check(t, Bytes(actual, filename))

Code:

golden.AssertBytes(t, []byte("foo"), "foo-content.golden")

func Bytes Uses

func Bytes(actual []byte, filename string) cmp.Comparison

Bytes compares actual to the contents of filename and returns success if the bytes are equal. If the `-test.update-golden` flag is set then the actual content is written to the golden file.

func Get Uses

func Get(t assert.TestingT, filename string) []byte

Get returns the contents of the file in ./testdata

func Path Uses

func Path(filename string) string

Path returns the full path to a file in ./testdata

func String Uses

func String(actual string, filename string) cmp.Comparison

String compares actual to the contents of filename and returns success if the strings are equal. If the `-test.update-golden` flag is set then the actual content is written to the golden file.

Any \r\n substrings in actual are converted to a single \n character before comparing it to the expected string. When updating the golden file the normalized version will be written to the file. This allows Windows to use the same golden files as other operating systems.

Code:

assert.Assert(t, golden.String("foo", "foo-content.golden"))

Package golden imports 8 packages (graph). Updated 2018-09-11. Refresh now. Tools for package owners.