expect

package module

v0.0.0-...-1fe4c93 Latest Latest Go to latest Published: Dec 9, 2019 License: BSD-2-Clause Imports: 6 Imported by: 3

Details

Valid go.mod file

The Go module system was introduced in Go 1.11 and is the official dependency management solution for Go.
Redistributable license

Redistributable licenses place minimal restrictions on how software can be used, modified, and redistributed.
Tagged version

Modules with tagged versions give importers more predictable builds.
Stable version

When a project reaches major version v1 it is considered stable.
Learn more about best practices

Repository

github.com/pkg/expect

Links

Open Source Insights

README ¶

expect

A simple assertion library that you probably shouldn't use.

Quickstart

Package expect contains various test assertion helpers.

func TestOpenFile(t *testing.T) {
        f, err := os.Open("notfound")
        expect.Nil(err)
        err = f.Close()
        expect.True(err == nil)
}

expect helpers can be called from any function called from the main testing goroutine.

% go test
--- FAIL: TestOpenFile (0.00s)
    check_test.go:12: expected: <nil>, got: open notfound: no such file or directory

Consult the documentation for more information.

How does this work?

Magic

No, seriously, how does this work?

*testing.T is recovered dynamically from the call stack. Read the blog post.

License

BSD-2-Clause

Documentation ¶

Overview ¶

package expect contains various test assertion helpers.

The functions this package recover the *testing.T value passed to the Test from the call stack. This implies that expect functions should not be called from a goroutine launched from a test. However, this restriction applies to calling t.Fatal/FailNow directly, so here we are.