Skip to main content

A parallel service for tox

Project description


A command line service that runs your tox tests in parallel, using threading and multicore CPUs.

See your tox environments in a dashboard and automatically watch source folders for file changes and re-run tests.

.. image::
:height: 180px
:width: 400px
:align: middle


Linux users may need to install libncurses5-dev before using Tox. If you see an error "ImportError: No module named '_curses'" this is because of the Requirement.


To install, run

.. code-block:: bash

pip install retox

Then from any project that has a `tox.ini` file setup and using tox, you can simply run

.. code-block:: bash


This will start the service, from where you can press (b) to rebuild on demand.

Watching folders

Retox can watch one or many directories for file changes and re-run the tox environments when changes are detected

.. code-block:: bash

retox -w my_project_folder -w my_test_folder

Tox support

Any tox arguments can be given to the command, and using --help to get a full list of commands. Tox arguments will be passed to all virtualenvs

.. code-block:: bash

retox -e py27,py36


2 files will be created - .retox.log, which is a file for all runs of the logs for the virtual environments. This can be handy to tail to see live output
.retox.json - a JSON file with the virtualenv tasks and specific command output.


This was inspired by the detox project, which was created by the tox development team. I worked and then significantly changed the way it works
to support re-running environments with ease.

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 retox, version 1.3.0
Filename, size File type Python version Upload date Hashes
Filename, size retox-1.3.0-py2-none-any.whl (12.0 kB) File type Wheel Python version py2 Upload date Hashes View hashes
Filename, size retox-1.3.0.tar.gz (10.7 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