Using the Testify toolkit

The github.com/stretchr/testify package is a popular Go library used for writing unit tests. It provides a set of tools like assertions, mocks, and suites that make it easier to write tests in Go. With Testify, you can run your suites and methods as regular test functions. For more information about the toolkit, refer to the description of Testify on GitHub.

In this tutorial, we will generate and use tests for the following application in the main.go file:

package math

// Add returns the sum of two integers.
func Add(a, b int) int {
	return a + b
}
    

Generate a test for package

Open a Go file for which you want to generate a test.
In the main menu, click Code | Generate.
In the Generate pop-up window, select Tests for package.
GoLand creates _test.go file with a table test template.

Modify the generated test so it uses the testify toolkit. Consider the following code snippet for the test.

package math

import (
  "github.com/stretchr/testify/assert"
  "testing"
)

func TestAdd(t *testing.T) {
  type args struct {
    a int
    b int
  }
  tests := []struct {
    name string
    args args
    want int
  }{
    {"add positives", args{1, 2}, 3},
    {"add negatives", args{-1, -2}, -3},
    {"add positive and negative", args{-1, 1}, 1},
    {"add zeros", args{0, 0}, 0},
  }
  for _, tt := range tests {
    t.Run(tt.name, func(t *testing.T) {
      result := Add(tt.args.a, tt.args.b)
      assert.Equal(t, tt.want, result, "they should be equal")
    })
  }
}
    

GoLand has automatically added the following import declaration: "github.com/stretchr/testify/assert".

Synchronize missing dependencies

Click the import declaration that is missing.
Press Alt+Enter and select Fix missing dependencies.

Run tests with testify

Click the Run test icon and select Run <configuration>.
You can also run individual table tests if desired.

Compare expected and actual values

You can compare expected and actual values for failed assertion tests.

You can compare expected and actual values for failed assertion tests. To see the difference, click the Click to see difference link in the Run pane.
Right-click the failed test and select View Differences. Alternatively, press Ctrl+D.

Last modified: 26 May 2024