Poser Box helps starting and stopping a sandboxed Poser instance
from within a Python process. The Poser instance will choose a free port on
It is primarily expected to be used in tests.
A typical use of a Poser Box:
from poserbox import PoserBox
box = PoserBox(scenes_file="test.yaml", proxy="http://example.com")
real = requests.get("http://localhost:%s" % box.port)
fake = requests.get("http://localhost:%s" % box.port)
assert real.content == fake.content
Poser Box comes with a Nose plugin which is automatically installed.
If used as a plugin, port of the running instance will be exported
in environment variable `POSERBOX_PORT`. This name can be overridden
The plugin exposes several configuration options. To see them, run:
The options you are interested in start with `--poserbox-`.
Get it from PyPi:
pip install poserbox
Get it from GitHub:
pip install https://github.com/ziadsawalha/poserbox.git
PoserBox is based on mongobox by Roman Kalyakin.
For a list of contributors see `AUTHORS.md`.
TODO: Brief introduction on what you do with files - including link to relevant help section.