Skip to main content

Select PIP version to use with tox

Project description

Build Status

Overview

This is a tox plugin that preinstalls a specific version of pip in each tox environment.

pip install tox-pip-version

This works around the default behavior of tox/virtualenv that always installs the latest version pip. It is an improvment over the VIRTUALENV_NO_DOWNLOAD=1 option that does not install the latest version, but could result in usage of an outdated version of pip.

Recommendation: Do not pin the pip version long term. You get more stable repeatable builds, but at the cost of using an outdated (possibly vulnerable) package. This should be used as a temporary fix for breakages in upstream pip, or in conjunction with a regular process to update the version pin.

Note: This relies on an unstable tox plugin interface. You may experience breakage with new tox versions. If you do, please feel free to report the issue on Github.

Usage

Install the package and include pip_version in your tox.ini

[testenv]
pip_version = 19.0.1

Or, set the TOX_PIP_VERSION environment variable,

export TOX_PIP_VERSION=18.1
tox

The plugin will install that specific pip into the tox-created virtualenv, just after tox creates the virtualenv, but before dependencies are installed.

The pip_version within tox.ini, if present, is always used over the environment variable.

If neither pip_version or TOX_PIP_VERSION is present, the plugin does nothing.

Tests

Use make test to run the tests, which includes linting and functional tests.

Each of the tests/* directories is a "feature" that needs testing. Each feature sub-directory contains a tox.ini file that sets pip version in a particular way, and then uses a tox command to check the correct pip version was installed.

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-pip-version-0.0.4.tar.gz (5.4 kB view details)

Uploaded Source

File details

Details for the file tox-pip-version-0.0.4.tar.gz.

File metadata

  • Download URL: tox-pip-version-0.0.4.tar.gz
  • Upload date:
  • Size: 5.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.21.0 setuptools/40.9.0 requests-toolbelt/0.9.1 tqdm/4.31.1 CPython/3.6.2

File hashes

Hashes for tox-pip-version-0.0.4.tar.gz
Algorithm Hash digest
SHA256 b10c405082bc229b20a5fc083c9e7aeecf32c2727f27ad39bcc529708f12a743
MD5 56e08358e4e10d0f59a7f678b3694e83
BLAKE2b-256 6a58d9ce4856f5362b0b089a0e2bf575443a0312e974ec85626821c8c1412bb3

See more details on using hashes here.

Supported by

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