Metadata-Version: 2.1
Name: tox-virtualenv-no-download
Version: 1.1.0
Summary: Disable virtualenv's download-by-default in tox
Home-page: https://github.com/asottile/tox-virtualenv-no-download
Author: Anthony Sottile
Author-email: asottile@umich.edu
License: MIT
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
Requires-Python: !=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*,>=2.7
Description-Content-Type: text/markdown
License-File: LICENSE

[![Build Status](https://travis-ci.org/asottile/tox-virtualenv-no-download.svg?branch=master)](https://travis-ci.org/asottile/tox-virtualenv-no-download)

tox-virtualenv-no-download
==========================

Disable virtualenv (>=14)'s downloading behaviour when running through tox.


## Wait, why?

A few goals for test suites are *repeatability* and *speed*.  In modern
versions of virtualenv (>=14), `virtualenv` will reach out to pypi to download
the latest version of `pip`, `setuptools`, and `wheel` even when it has a
perfectly good copy of the wheeled packages on disk.

A few reasons why downloading is problematic:
- Reaching out to the network is slow.
- pypi goes down quite often
- You may work in a situation where installation should not come from public
  pypi.
- If you don't have a network connection, `virtualenv` will outright *fail*.
- Hurts repeatability as you may suddenly get a new version of `setuptools` /
  `pip`
- `setuptools` has been unstable in the past, breaking their latest version
   and compatibility.

## How it works

The downloading behaviour of `virtualenv` can be disabled either by calling
`virtualenv --no-download` or by setting the environment variable
`VIRTUALENV_NO_DOWNLOAD`.  This tox plugin sets that environment variable
during the virtualenv creation.

## Usage

```
$ pip install tox-virtualenv-no-download
# just use tox as you usually would
$ tox ...
```
