oglemock is a mocking framework for the Go programming language with the
An extensive and extensible set of matchers for expressing call expectations (provided by the oglematchers package).
Clean, readable output that tells you exactly what you need to know.
Seamless integration with the ogletest unit testing framework.
It can be integrated into any testing framework (including Go's
package), but out of the box support is built in to ogletest and that is the
easiest place to use it.
First, make sure you have installed Go 1.0.2 or newer. See here for instructions.
Use the following command to install
oglemock and its dependencies, and to
keep them up to date:
go get -u github.com/jacobsa/oglemock go get -u github.com/jacobsa/oglemock/createmock
Those commands will install the
oglemock package itself, along with the
createmock tool that is used to auto-generate mock types.
Generating and using mock types
Automatically generating a mock implementation of an interface is easy. If you
want to mock interfaces
Baz from package
foo, simply run the
createmock foo Bar Baz
That will print source code that can be saved to a file and used in your tests.
For example, to create a
mock_io package containing mock implementations of
mkdir mock_io createmock io Reader Writer > mock_io/mock_io.go
The new package will be named
mock_io, and contain types called
MockWriter, which implement
For each generated mock type, there is a corresponding function for creating an
instance of that type given a
Controller object (see below). For example, to
create a mock reader:
someController := [...] // See next section. someReader := mock_io.NewMockReader(someController, "Mock file reader")
The snippet above creates a mock
io.Reader that reports failures to
someController. The reader can subsequently have expectations set up and be
passed to your code under test that uses an
Getting ahold of a controller
oglemock.Controller is used to create mock objects, and to set
up and verify expectations for them. You can create one by calling
NewController with an
ErrorReporter, which is the basic type used to
oglemock and the testing framework within which it is being
If you are using ogletest you don't need to worry about any of this, since
TestInfo struct provided to your test's
SetUp function already contains
Controller that you can use to create mock object, and you can use
ExpectCall function for setting expectations. (See the
ogletest documentation for more info.) Otherwise, you will need
to implement the simple ErrorReporter interface for your test
For thorough documentation, including information on how to set up expectations, see here.