Gmock

Gmock is a mocking framework for the Groovy language.

Gmock is all about simple syntax and readability of your tests so you spend less time learning the framework and more writing code. To use Gmock just drop the gmock jar file in your classpath.

The current version is gmock-0.8.0 and is packed with tons of feature.

Checkout our official site at gmock.org and our documentation to get the full picture. Visit our roadmap to see what's coming next.

Getting Started

First extend the org.gmock.GMockTestCase. Create mock object using the mock() method. You setup expectation simply by calling method on your mock.

def mockLoader = mock()
mockLoader.load("fruit").returns("apple")

The code you are testing should be executed within the play closure.

void testBasic(){
  // create mock and setup expectation
  play {
    // run your code
  }
}

In A Nutshell

• Method mocking: mockLoader.load("fruit").returns("apple")
• Exception mocking: mockLoader.load("unknown").raises(new RuntimeException())
• Stub mocking: mockLoader.load("fruit").returns("apple").stub()
• Static method mocking: mockMath.static.random().returns(0.5)
• Property mocking: mockLoader.name.returns("loader")
• Constructor mocking: def mockFile = mock(File, constructor('/a/path/file.txt'))
• Partial mocking: mock(controller).params.returns([id: 3])
• Times expectation: mockLoader.load("fruit").returns("apple").atLeastOnce()
• Custom matcher: mockLoader.load(match{ it.startsWith("fru") })
• Strict ordering: ordered { ... }
• Optional support for Hamcrest matcher: mockLoader.put("test", is(not(lessThan(5))))
• GMockController if you can't extend GMockTestCase in your test

Here is a full example:

import org.gmock.GMockTestCase

class LoaderTest extends GMockTestCase {
  void testLoader(){
    def mockLoader = mock()
    mockLoader.load('key').returns('value')
    play {
      assertEquals "value", mockLoader.load('key')
    }
  }
}