Golang testing: Difference between revisions
From wikinotes
No edit summary |
|||
Line 68: | Line 68: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
</blockquote><!-- Assertions --> | </blockquote><!-- Assertions --> | ||
= Subtests = | |||
<blockquote> | |||
Evaluate subtests under one function using <code>t.Run("TESTNAME", ...)</code>. | |||
<syntaxhighlight lang="go"> | |||
func TestHello(t *testing.T) { | |||
cases := []struct { // <-- slice of structs containing testdata | |||
test string | |||
name string | |||
expects string | |||
}{ { test: "ValidName", name: "Adam", }, | |||
{ test: "NilName", name: nil, } } | |||
for _, case := range cases { | |||
t.Run(case.test, func(t, *testing.T) { // <-- t.Run() evaluates each case | |||
res := Hello(case.name) | |||
if res != case.expects { | |||
t.Errorf("Failed because...") | |||
} | |||
} | |||
} | |||
} | |||
</syntaxhighlight> | |||
You can also implement setup/teardown this way using <code>defer</code> functions. | |||
</blockquote><!-- Subtests --> | |||
= Benchmarking = | = Benchmarking = |
Revision as of 22:18, 6 June 2022
Go ships with a test suite.
Documentation
testing
https://pkg.go.dev/testing@go1.18.3
Usage
go test -run # run all tests go test -run Foo # run top-level tests containing 'Foo'
Example
The builtin go test framework is fairly minimalist.
Tests are just functions, you can loop them if useful.
Tests are typically kept alongside code.
// myproject/mypackage/mylib.go package mypackage func Hello(name string) string { return "Hello, " + name }// myproject/mypackage/mylib_test.go package mypackage import "testing" func TestHello(t *testing.T) { res := Hello("Adam") if res != "Hello, Adam" { t.Errorf("Hello() result did not match") } }
Assertions
There are no assertions, you are responsible for tests and messages.
func TestHello(t *testing.T) { // log message and fail (but continue executing) t.Errorf("An expectation was not satisfied") t.Fail() // mark test as failed, but continue t.FailNow() // mark test as failed and stop executing t.Skip("Reason") // log, and stop executing t.TempDir() // provides a tempdir that is deleted once test finishes running }
Subtests
Evaluate subtests under one function using
t.Run("TESTNAME", ...)
.func TestHello(t *testing.T) { cases := []struct { // <-- slice of structs containing testdata test string name string expects string }{ { test: "ValidName", name: "Adam", }, { test: "NilName", name: nil, } } for _, case := range cases { t.Run(case.test, func(t, *testing.T) { // <-- t.Run() evaluates each case res := Hello(case.name) if res != case.expects { t.Errorf("Failed because...") } } } }You can also implement setup/teardown this way using
defer
functions.
Benchmarking
There are tools for benchmarking. See docs
Fuzzing
There are tools for fuzzing tests. See docs