From 24bd40737ac97ad32226fbd29b50fda05de00364 Mon Sep 17 00:00:00 2001 From: Monty Taylor Date: Tue, 21 May 2013 16:54:51 -0400 Subject: Updated to use OpenStack standards. --- README.rst | 52 ++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 52 insertions(+) create mode 100644 README.rst (limited to 'README.rst') diff --git a/README.rst b/README.rst new file mode 100644 index 0000000..01ca1b8 --- /dev/null +++ b/README.rst @@ -0,0 +1,52 @@ +Mox3 - Mock object framework for Python 3 +========================================= + +Mox3 is an unofficial port of the Google mox framework +(http://code.google.com/p/pymox/) to Python 3. It was meant to be as compatible +with mox as possible, but small enhancements have been made. The library was +tested on Python version 3.2, 2.7 and 2.6. + +Use at your own risk ;) + +To install: + + $ python setup.py install + +Running Tests +------------- +The testing system is based on a combination of tox and testr. The canonical +approach to running tests is to simply run the command `tox`. This will +create virtual environments, populate them with depenedencies and run all of +the tests that OpenStack CI systems run. Behind the scenes, tox is running +`testr run --parallel`, but is set up such that you can supply any additional +testr arguments that are needed to tox. For example, you can run: +`tox -- --analyze-isolation` to cause tox to tell testr to add +--analyze-isolation to its argument list. + +It is also possible to run the tests inside of a virtual environment +you have created, or it is possible that you have all of the dependencies +installed locally already. In this case, you can interact with the testr +command directly. Running `testr run` will run the entire test suite. `testr +run --parallel` will run it in parallel (this is the default incantation tox +uses.) More information about testr can be found at: +http://wiki.openstack.org/testr + +Basic Usage +----------- + +The basic usage of mox3 is the same as with mox, but the initial import should +be made from the mox3 module: + + from mox3 import mox + +To learn how to use mox3 you may check the documentation of the original mox +framework: + + http://code.google.com/p/pymox/wiki/MoxDocumentation + +Original Copyright +------------------ + +Mox is Copyright 2008 Google Inc, and licensed under the Apache +License, Version 2.0; see the file COPYING.txt for details. If you would +like to help us improve Mox, join the group. -- cgit v1.2.1