Skip to main content

Remote tox test runner

Project description

https://travis-ci.org/pycontribs/rtox.svg?branch=master

rtox

This project represents an experimental development workflow with the following considerations in mind:

  • tox is an excellent tool for managing test activities in a virtualenv.

  • Servers in the cloud are faster and far more powerful than my local development environment (usually a laptop).

  • Latency introduced to the command line by a remote connection, especially on bad WiFi, is painful.

  • Running huge test suites on a cloud server doesn’t drain my laptop’s battery (or spin up my desktop’s fans) like running them locally would.

  • Your local development platform might not actually have the binary dependencies available that your project requires from your target platform (developing a Linux application on OS X, for example).

  • Running tests with tox is easy. Running tests with rtox on a remote host against the local codebase should be just as easy.

This project currently makes a few assumptions that you’d have to meet for it to be useful to you:

  • You’re a Python developer (that’s why you’re interested in tox, right?).

  • You’re using git.

  • You’re working on a publicly available repository (I’d like to break this assumption).

Usage

Configure rtox with an .rtox.cfg file like the following:

[ssh]
user = root
hostname = localhost
port = 22

rtox will look for config file in current folder or its parents and use ~/.rtox.cfg as fallback. This allows user to have different configs for different projects or groups of projects.

rtox simply needs to be pointed at an SSH host with git, tox and virtualenv installed.

Once it’s configured, just use rtox in place of tox. For example:

$ rtox -e py27 -e pep8

The state of your local codebase will be mirrored to the remote host, and tox will be executed there.

untox

Untox is a small script that obliterates any tox.ini commands that are installing python packages inside the virtualenv, removing sepctions like deps, pip install ..., truncating requirements.txt files and enabling sitepackages = True on all tox environments.

Its purpose is to enable testing of python code with only system packages, something that may be desired by those that are planning to ship these modules as RPMs, DEBs.

untox script is installed as a command alongside rtox and once called it expectes to find a tox.ini in current folder. Be warned that changes are made in-place without any backup.

You also have the option to call rtox --untox ... which will run untox on the remote system after doing the rsync and before running tox. This option is handy as it keeps the local repository untoched.

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

rtox-0.0.9.tar.gz (16.7 kB view details)

Uploaded Source

Built Distribution

rtox-0.0.9-py2.py3-none-any.whl (8.5 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file rtox-0.0.9.tar.gz.

File metadata

  • Download URL: rtox-0.0.9.tar.gz
  • Upload date:
  • Size: 16.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for rtox-0.0.9.tar.gz
Algorithm Hash digest
SHA256 ba52132949cf94a8a9ae7769ae2be60f96b488a14ea98c7c1d6a86fed39a8d75
MD5 fc6419bc5d0b2cb450077dc425311140
BLAKE2b-256 9e41d8f52a28337155fbf3031f915c6bece029c5e1208baa3848e2343c5f287e

See more details on using hashes here.

File details

Details for the file rtox-0.0.9-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for rtox-0.0.9-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 568d45801ff9010e276246dd8916e5581dbdb260e2e2afcb20fe1e9773de9056
MD5 851a339b034f8efa97b431685452cf77
BLAKE2b-256 b815c692dd58fbe679fbc43fbc822715feae51932fa5b8b6e551784946a77218

See more details on using hashes here.

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