RETIRED, Port of mox library to python 3
Go to file
Doug Hellmann c919d92bb9 Fixes to allow a new release
Version 0.7.0 has a conflicting pbr requirement, so we need to update
the requirements and produce a new release. Making our tools work after
importing into gerrit required several updates simultaneously:

1. Update requirements based on our global-requirements list.
2. Fix tox.ini so tests pass for 2.7 and 3.4.
3. Skip a test that is failing for 3.4 until we have more time to debug.
4. Fix the .gitreview settings to point to the right repository.
5. Add skeleton documentation structure.
6. Add links to the README in a format understood by our release tools.

Related-bug: #1403214
Change-Id: I28213fb1dbb76a8640d7aa7dc844a7b593d1c6da
2015-06-11 17:22:23 +00:00
doc/source Fixes to allow a new release 2015-06-11 17:22:23 +00:00
mox3 Fixes to allow a new release 2015-06-11 17:22:23 +00:00
.gitignore Cleaed up AUTHORS/ChangeLog file. 2013-05-21 19:28:18 -04:00
.gitreview Fixes to allow a new release 2015-06-11 17:22:23 +00:00
.mailmap Cleaed up AUTHORS/ChangeLog file. 2013-05-21 19:28:18 -04:00
.testr.conf Updated to use OpenStack standards. 2013-05-21 16:59:38 -04:00
CONTRIBUTING.rst Add CONTRIBUTING file. 2013-05-21 19:29:25 -04:00
COPYING.txt Applied some changes according to http://getpython3.com/diveintopython3/packaging.html 2012-04-29 00:56:00 +02:00
MANIFEST.in Updated to use OpenStack standards. 2013-05-21 16:59:38 -04:00
README.rst Fixes to allow a new release 2015-06-11 17:22:23 +00:00
requirements.txt Fixes to allow a new release 2015-06-11 17:22:23 +00:00
setup.cfg Updated to use OpenStack standards. 2013-05-21 16:59:38 -04:00
setup.py Fixes to allow a new release 2015-06-11 17:22:23 +00:00
test-requirements.txt Fixes to allow a new release 2015-06-11 17:22:23 +00:00
tox.ini Fixes to allow a new release 2015-06-11 17:22:23 +00:00

README.rst

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

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.

OpenStack Fork