gosuite alternatives and similar packages
Based on the "Testing Frameworks" category.
Alternatively, view gosuite alternatives based on common mentions on social networks and blogs.
-
dockertest
Write better integration tests! Dockertest helps you boot up ephermal docker images for your Go tests with minimal work. -
gnomock
Test your code without writing mocks with ephemeral Docker containers ๐ฆ Setup popular services with just a couple lines of code โฑ๏ธ No bash, no yaml, only code ๐ป -
embedded-postgres
Run a real Postgres database locally on Linux, OSX or Windows as part of another Go application or test -
gotest.tools
A collection of packages to augment the go testing package and support common patterns. -
go-testdeep
Extremely flexible golang deep comparison, extends the go testing package, tests HTTP APIs and provides tests suite -
testza
Full-featured test framework for Go! Assertions, fuzzing, input testing, output capturing, and much more! ๐ -
GoSpec
Testing framework for Go. Allows writing self-documenting tests/specifications, and executes them concurrently and safely isolated. [UNMAINTAINED] -
jsonassert
A Go test assertion library for verifying that two representations of JSON are semantically equal -
assert
:exclamation:Basic Assertion Library used along side native go testing, with building blocks for custom assertions
WorkOS - The modern identity platform for B2B SaaS
Do you think we are missing an alternative of gosuite or a related project?
Popular Comparisons
README
Go Suite
The support for test suites for Golang 1.7 and later.
Golang 1.7 featured Subtests that allowed you to group tests in order to share common setup and teardown logic. While that was a great addition to the testing
package, it was a bit clunky syntactically. The GoSuite package leverages Golang's 1.7 Subtests feature, defines a simple TestSuite
interface and runs test cases inside of them keeping setup/teardown logic for the whole suite and for single cases in place.
Quick Start
To start with, create a struct with the four methods implemented:
type MyTestSuite struct {
// DB connection
// etc
}
// SetUpSuite is called once before the very first test in suite runs
func (s *MyTestSuite) SetUpSuite() {
}
// TearDownSuite is called once after thevery last test in suite runs
func (s *MyTestSuite) TearDownSuite() {
}
// SetUp is called before each test method
func (s *MyTestSuite) SetUp() {
}
// TearDown is called after each test method
func (s *MyTestSuite) TearDown() {
}
Then add one or more test methods to it, prefixing them with Test
prefix:
func (s *MyTestSuite) TestMyFirstTestCase(t *testing.T) {
if !someJob {
t.Fail("Unexpected failure!")
}
}
Almost done! The only piece that remains is to run the suite! You do this by calling the Run
method. Note, the enclosing TestIt
method is a normal testing method you usually write in Go, nothing fancy at all!
func TestIt(t *testing.T) {
Run(t, &MyTestSuite{})
}
Installation
To install Go Suite, use go get
:
go get github.com/pavlo/gosuite
The import the pavlo/gosuite
package into your code like this:
package yours
import (
"testing"
"github.com/pavlo/gosuite"
)
...
Complete Example
The complete example is shown to help you to see the whole thing on the same page. Note, it leverages the Is package for assertions... the package is great though indeed it is not required to use with Go Suite. The example however demonstrates a slick technique making the assertion methods available on the suite itself!
import (
"testing"
"github.com/pavlo/gosuite"
)
type Suite struct {
*is.Is
setUpSuiteCalledTimes int
tearDownSuiteCalledTimes int
setUpCalledTimes int
tearDownUpCalledTimes int
}
func (s *Suite) SetUpSuite() {
s.setUpSuiteCalledTimes++
}
func (s *Suite) TearDownSuite() {
s.tearDownSuiteCalledTimes++
}
func (s *Suite) SetUp() {
s.setUpCalledTimes++
}
func (s *Suite) TearDown() {
s.tearDownUpCalledTimes++
}
func TestIt(t *testing.T) {
s := &Suite{Is: is.New(s.t)}
gosuite.Run(t, s)
s.Equal(1, s.setUpSuiteCalledTimes)
s.Equal(1, s.tearDownSuiteCalledTimes)
s.Equal(2, s.setUpCalledTimes)
s.Equal(2, s.tearDownUpCalledTimes)
}
func (s *Suite) TestFirstTestMethod(t *testing.T) {
s.Equal(1, s.setUpSuiteCalledTimes)
s.Equal(0, s.tearDownSuiteCalledTimes)
s.Equal(1, s.setUpCalledTimes)
s.Equal(0, s.tearDownUpCalledTimes)
}
func (s *Suite) TestSecondTestMethod(t *testing.T) {
s.Equal(1, s.setUpSuiteCalledTimes)
s.Equal(0, s.tearDownSuiteCalledTimes)
s.Equal(2, s.setUpCalledTimes)
s.Equal(1, s.tearDownUpCalledTimes)
}
Running it with go test -v
would emit this:
> go test -v
=== RUN TestIt
=== RUN TestIt/TestFirstTestMethod
=== RUN TestIt/TestSecondTestMethod
--- PASS: TestIt (0.00s)
--- PASS: TestIt/TestFirstTestMethod (0.00s)
--- PASS: TestIt/TestSecondTestMethod (0.00s)
PASS
ok github.com/pavlo/gosuite 0.009s
Success: Tests passed.
License
Go Suite
is released under the MIT License.
*Note that all licence references and agreements mentioned in the gosuite README section above
are relevant to that project's source code only.