Skip to main content

tox plugin to run an arbitrary commands in a virtualenv

Project description

A tox plugin to run an arbitrary command in a tox managed virtualenv.

tox -e py27 --run-command "server --port 8080"

In the example tox will will run server --port 8080 inside of the py27 virualenv.


  • Any env defined in your tox.ini will work
  • The env will be created if it doesn’t exist (just like tox normally does)
  • The commands from your tox.ini will not be run and instead the command you wanted to run is run
  • tox substitutions will also work. (e.g. tox -e py27 --run-command "server --config={homedir}/server.conf")


Almost all of the projects I work on use tox for test automation. Many of those projects, one such example is Keystone, carry custom Python and/or shell scripts to create virtualenvs to run server processes for manual testing. Other projects advise the developer to create a tox virtualenv by running tox -e py27 --notest and then running the server from within that virtualenv like .tox/py27/bin/server --port 8080.

Both of those options suck. Since I couldn’t find a tool that already existed to do this, I created one using the new tox plugin API.

Project details

Download files

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

Files for tox-run-command, version 0.2
Filename, size File type Python version Upload date Hashes
Filename, size tox-run-command-0.2.tar.gz (2.2 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page