Skip to main content

Run tox on a date in the past

Project description


To install:

pip install tox-timemachine


This plugin provides a --time-travel command-line option that takes either a date in YYYY-MM-DD format or a date and time in YYYY-MM-DDTHH-MM-SS format, and will internally use a proxy PyPI server that does not include packages released after this date (using the pypi-timemachine package). For instance:

tox --time-travel=2018-02-03T12:33:02-e py37-test

will run tox as if it was being run on that date as far as PyPI is concerned.

Bisection (experimental)

This package also provides a command to automatically bisect between two dates to pinpoint when a tox build started failing:

tox-timemachine-bisect 2021-01-01 2021-08-10 -r -e py38-test -- -k test_coadd_solar_map

The format is:

tox-timemachine-bisect start_date end_date <tox arguments>

This is still very experimental and does not yet explicitly say which package update caused the issue (for now one needs to diff the log files) but this should be made more user-friendly in future.


This plugin will not work properly if you use the -i/--index-url option manually when calling tox. In addition, this will only work with pip-based installs, and will not work with e.g. tox-conda.

Project details

Release history Release notifications | RSS feed

This version


Download files

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

Source Distribution

tox-timemachine-0.1.tar.gz (4.8 kB view hashes)

Uploaded source

Built Distribution

tox_timemachine-0.1-py3-none-any.whl (5.1 kB view hashes)

Uploaded py3

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