This module was renamed to github.com/devnev/testeach

Go TestUp

Shared test setup/teardown for Go tests. Allows Suite-style tests without using reflection to detect methods. This makes the execution easier to follow and avoids errors caused by typos in the names of reflected methods.

Usage Example

See example_testup_test.go for longer example.

package my_test

import (
    "testing"
    "github.com/devnev/testup"
)

func TestMyType(t *testing.T) {
    // Suite setup goes here (equivalent to SetupSuite/TeardownSuite functions in suite frameworks)
    harness := createHarness(t)
    // In Go 1.14+, harness may use t.Cleanup, making this defer unnecessary.
    defer harness.Destroy()

    testup.Suite(t, func(t *testing.T, test testup.Register) {
        // Test setup goes here (equivalent to SetupTest/TeardownTest functions in suite frameworks)
        stuff := setupState(t)
        defer func() {
          teardown(stuff)
        }()

        // Individual test cases. The names must be static and are used as the sub-test name to `t.Run`.
        test("it does the thing", func() {
            // assert a thing
        })
        test("it does something else", func() {
            // assert something else
        })
        test("with a particular setup", func() {
          // Can have test calls within callbacks. All setup and teardown is re-run for every sub-test.
          test("it does another thing", func() {
            // more asserts
          })
        })
    })
}