Mox is an open source mock object framework for Python, inspired by

the Java library EasyMock.

To install:

  $ python setup.py install

To run Mox's internal tests:

  $ python mox_test.py

Basic usage:

  import unittest

  import mox

  class PersonTest(mox.MoxTestBase):

    def testUsingMox(self):

      # Create a mock Person

      mock_person = self.mox.CreateMock(Person)

      test_person = ...

      test_primary_key = ...

      unknown_person = ...

      # Expect InsertPerson to be called with test_person; return

      # test_primary_key at that point

      mock_person.InsertPerson(test_person).AndReturn(test_primary_key)

      # Raise an exception when this is called

      mock_person.DeletePerson(unknown_person).AndRaise(UnknownPersonError())

      # Switch from record mode to replay mode

      self.mox.ReplayAll()

      # Run the test

      ret_pk = mock_person.InsertPerson(test_person)

      self.assertEquals(test_primary_key, ret_pk)

      self.assertRaises(UnknownPersonError, mock_person, unknown_person)

For more documentation, see:

  http://code.google.com/p/pymox/wiki/MoxDocumentation

For more information, see:

  http://code.google.com/p/pymox/

Our user and developer discussion group is:

  http://groups.google.com/group/mox-discuss

Mox is Copyright 2008 Google Inc, and licensed under the Apache

License, Version 2.0; see the file COPYING for details.  If you would

like to help us improve Mox, join the group.