61 lines
2.1 KiB
ReStructuredText
61 lines
2.1 KiB
ReStructuredText
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.
|
|
|
|
OpenStack Fork
|
|
--------------
|
|
|
|
* Free software: Apache license
|
|
* Documentation: http://docs.openstack.org/developer/mox3
|
|
* Source: http://git.openstack.org/cgit/openstack/mox3
|
|
* Bugs: http://bugs.launchpad.net/python-mox3
|