--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/tests/pymox/README	Mon Jan 26 16:04:19 2009 +0000
@@ -0,0 +1,56 @@
+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.