Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

buildout recipe to create scripts to run testrepository.

Project Description

testr recipe

This allows you to easily add a testrepository script to your buildout
project. This really only means that the user doesn't have to have
testr on their path, and they can just use ./bin/test or simlar.

This works very similarly to zc.recipe.testrunner, and in fact borrows
most of its code from there.

A sample buildout configuration would be::

develop = .
parts = test

recipe = testr_recipe
script = test

which will have ./bin/test run using the .testr.conf in your root

These are the options you can use:

* script: define the name of the script to create, if not passed
then the name of the section will be used.
* working-directory: if somewhere other than the root of the project
should be used.
* environment: the name of a section containing pairs of values to
put in the environment for the test run, e.g.


recipe = testr_recipe
enironment = testenv

foo = bar
zap = zang

* initialization: a string containing python code to put in the test
script before testr is run.
* executable: the python executable to put in the #! of the script.
* defaults: a list of options to prepend sys.argv for testr.
These are specified as Python source for an expression yielding a list,
typically a list literal. One thing you can do with this is::

parts = test testr

recipe = testr_recipe

recipe = testr_recipe
defaults = ["run"]

which will make ./bin/test run the tests, and allow you to use
./bin/testr to access all the features of testr.

Creating the .testr.conf automatically

Given that buildout knows most things about your project you can
have it create the .testr.conf for you.

recipe = testr_recipe
test-packages = mypackage
interpreter = python

Future enhancments:

* Maybe automatically doing "testr init" when setting up the project, so that
./bin/test works straight away.

Release History

This version
History Node


History Node


History Node


Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, Size & Hash SHA256 Hash Help File Type Python Version Upload Date
(4.0 kB) Copy SHA256 Hash SHA256
Source None Jul 29, 2010

Supported By

Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Google Google Cloud Servers