Skip to main content

A mini tox server for calling tox in a loop

Project description

Tox Server

PyPI version Tests

tox-server is a command line tool which runs tox in a loop and calls it with commands from a remote CLI. It responds to commands via ZeroMQ. It isn't super useful on its own (as it doesn't eliminate the startup time for tox, just runs it repeatedly) but it is helpful if your tests have to be run inside another environment with some setup cost, such as a docker container.


You can use pip to install tox-server:

$ pip install tox-server

Run the server

On the remote host:

$ tox-server serve

The server binds to (i.e. it will only accept connections from localhost) because it is not secured. If you are running it on an isolated network (like via docker), you can bind it to another host with tox-server -b serve.

Run a tox command remotely

On your local host, you can run a tox command:

$ tox-server run -e py37

This will run tox -e py37 on the remote host.

A note on security

Basically, security is hard. This program doesn't provide any authentication mechanism, and I'm not tempted to add one. Before you expose ports from tox-server to the world wide web, I'd advise using something like SSH tunneling to provide security and authentication.

Project details

Download files

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

Source Distribution

tox_server-0.6.0.tar.gz (20.2 kB view hashes)

Uploaded Source

Built Distribution

tox_server-0.6.0-py2.py3-none-any.whl (24.4 kB view hashes)

Uploaded Python 2 Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page