is

A mini testing helper for Go.

• Simple interface (is.OK and is.Equal)
• Plugs into existing Go toolchain (uses testing.T)
• Obvious for newcomers and newbs
• Also gives you is.Panic and is.PanicWith helpers - because testing panics is ugly

Usage

1. Write test functions as usual
2. Add is := is.New(t) at top of your test functions
3. Call target code
4. Make assertions using new is object

func TestSomething(t *testing.T) {
  is := is.New(t)

  // ensure not nil
  obj := SomeFunc()
  is.OK(obj)

  // ensure no error
  obj, err := SomeFunc()
  is.NoErr(err)

  // ensure not false
  b := SomeBool()
  is.OK(b)

  // ensure not ""
  s := SomeString()
  is.OK(s)

  // ensure not zero
  is.OK(len(something))

  // ensure doesn't panic
  is.OK(func(){
    MethodShouldNotPanic()
  })

  // ensure many things in one go
  is.OK(b, err, obj, "something")

  // ensure something does panic
  is.Panic(func(){
    MethodShouldPanic(1)
  })
  is.PanicWith("package: arg must be >0", func(){
    MethodShouldPanicWithSpecificMessage(0)
  })

  // make sure two values are equal
  is.Equal(1, 2)
  is.Equal(err, ErrSomething)
  is.Equal(a, b)

}

Get started

Get it:

go get github.com/cheekybits/is

Then import it:

import (
  "testing"
  "github.com/cheekybits/is"
)