ファイルを出力する機能のユニットテストを書く場合に、期待値としてのファイルと生成したファイルを比較し、差分があれば当該差分をきれいに表示したい場合があります。

これはgo-diffを利用することで可能になります。

例えば、以下のような形です。テストが落ちた時にどこがおかしいのか読みやすいですね。

上記を実現しているテストコードはこんな形です。

import (
    "testing"
    // snip

    "github.com/sergi/go-diff/diffmatchpatch"
)
(略)
    for _, f := range fileNames {
        expectedFilePath := filepath.Join(expectedDir, f)
        expected, err := ioutil.ReadFile(expectedFilePath)
        if err != nil {
            t.Errorf("cannot read expetec file [%s]: %s", expectedFilePath, err)
            continue
        }

        actualPath := filepath.Join(dir, f)
        actual, err := ioutil.ReadFile(actualPath)
        if err != nil {
            t.Errorf("cannot read generated file [%s]: %s", actualPath, err)
            continue
        }

        if string(expected) != string(actual) {
            dmp := diffmatchpatch.New()
            a, b, c := dmp.DiffLinesToChars(string(expected), string(actual))
            diffs := dmp.DiffMain(a, b, false)
            diffs = dmp.DiffCharsToLines(diffs, c)
            t.Errorf("%sに差分があります\n%s", f, dmp.DiffPrettyText(diffs))
        }
    }
(略)