Metadata-Version: 2.1
Name: tox-pip-version
Version: 0.0.4
Summary: Select PIP version to use with tox
Home-page: https://github.com/pglass/tox-pip-version
Author: Paul Glass
Author-email: pnglass@gmail.com
License: MIT
Description: [![Build Status](https://travis-ci.com/pglass/tox-pip-version.svg?branch=master)](https://travis-ci.com/pglass/tox-pip-version)
        ![](https://img.shields.io/pypi/v/tox-pip-version.svg)
        ![](https://img.shields.io/pypi/pyversions/tox-pip-version.svg)
        
        Overview
        --------
        
        This is a tox plugin that preinstalls a specific version of pip in each tox
        environment.
        
        ```bash
        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](
        https://tox.readthedocs.io/en/latest/plugins.html#tox.hookspecs.tox_testenv_create).
        You may experience breakage with new tox versions. If you do, please feel
        free to [report the issue](https://github.com/pglass/tox-pip-version/issues/new)
        on Github.
        
        ### Usage
        
        Install the package and include `pip_version` in your tox.ini
        
        ```tox
        [testenv]
        pip_version = 19.0.1
        ```
        
        Or, set the `TOX_PIP_VERSION` environment variable,
        
        ```bash
        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.
        
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Framework :: tox
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Description-Content-Type: text/markdown
