• Stars
    star
    156
  • Rank 239,589 (Top 5 %)
  • Language
    Go
  • Created over 11 years ago
  • Updated almost 11 years ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

Comparison of go lang testing libraries

Go Test It Build Status

Summary from the July presentation: There are a couple of interesting testing libraries in go. "testing" comes with the standard library, and gives only very basic support for asserting facts.

Of the other libraries, I recommend looking at "testify/assert", "zen", and "gocheck". testify/assert is used in conjunction with testing to which it adds a lot of useful assertions, but doesn't change the basics of how a test is written. Zen implements the best version of BDD style testing I have seen in go. Essentially, you write one test into which you embed describes, its, and expects. Like testify/assert "gocheck" comes with many matchers out of the box. Gocheck requires creating a suite struct and uses a non-standard way of running the test methods. Its most useful feature to me are setup and teardown methods to allow tests in a suite to share common code. The shared state can lead to problems with concurrent code.

As far as the other libraries go, check them out to see the different styles. Beware of go-spec: The version tested here, never fails assertions!

So, summary of the summary: if you are just trying to test stuff and need assertions, go with testify/assert. If you want to see and play with BDD for go, use zen.

Slides from my presentation at Denver Gopher's 7/25/2013

Comparison of go lang testing libraries

Libraries in comparison

Libraries in need of addition

  • GoConvey
  • submit a pull request!

Assertions/Matchers

Name testing Ginkgo GoConvey testify gocheck prettytest go-spec gospec mao/zen
License BSD MIT MIT MIT BSD MIT BSD Apache MIT/Apache
Assertions Gomega uses gocheck
Style make your own spec spec assert spec spec spec spec spec
Equal ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓
IsSame ✓ ✓ ✓
DeepEqual ✓ ✓ ✓ ✓
True ✓ ✓ ✓ ✓
False ✓ ✓ ✓ ✓
Nil ✓ ✓ ✓ ✓ ✓ ✓ ✓
Empty ✓ ✓ ✓
Error ✓ ✓ ✓ ✓ ✓ ✓
Implements ✓ ✓ ✓
IsType ✓ ✓ ✓ ✓ ✓
StringContains ✓ ✓ ✓
StringMatches ✓ ✓ ✓
Collection ✓ ✓ ✓
Panics ✓ ✓ ✓ ✓ ✓ ✓
HasLen ✓ ✓ ✓
Matches ✓ ✓ ✓
Satisfy ✓ ✓
Within ✓

*CollectionContains allows checks for All, Any, Exactly, InOrder, and InPartialOrder

Sample tests

The code to be tested is taken from the cloudfoundry loggregator project. Specifically, we are testing a piece that receives data on a channel and sends it off via UPD. We will be testing that the code sends data, but that it does not send any empty data it might receive.

All the tests are in packages relating to their name within the gotestit package.

Sources

https://code.google.com/p/go-wiki/wiki/Projects#Testing