Metadata-Version: 2.1
Name: virtualenv-pyenv
Version: 0.1.0
Summary: A virtualenv Python discovery plugin using pyenv
Home-page: https://github.com/un-def/virtualenv-pyenv
License: MIT
Keywords: virtualenv,pyenv
Author: un.def
Author-email: me@undef.im
Requires-Python: >=3.7,<4.0
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Software Development :: Testing
Classifier: Topic :: Utilities
Requires-Dist: virtualenv
Project-URL: Repository, https://github.com/un-def/virtualenv-pyenv
Description-Content-Type: text/markdown

# virtualenv-pyenv

A [virtualenv][virtualenv] Python discovery plugin using [pyenv][pyenv]

## Installation

```shell
pip install virtualenv-pyenv
```

## Usage

The Python discovery mechanism can be specified by:

* the CLI option `--discovery`:
  ```shell
  virtualenv --discovery pyenv -p 3.10 testenv
  ```

* the environment variable `VIRTUALENV_DISCOVERY`:
  ```shell
  export VIRTUALENV_DISCOVERY=pyenv
  virtualenv -p 3.10 testenv
  ```

* the [config][virtualenv-docs-config-file] option `discovery`:
  ```ini
  [virtualenv]
  discovery = pyenv
  ```

  ```shell
  virtualenv pyenv -p 3.10 testenv
  ```

The Python version can be expressed using either 2 or 3 version segments:

* `-p 3.9`
* `-p 3.9.3`

In the former case, the latest version found will be used.

## Limitations

Only CPython is supported at the moment.


[virtualenv]: https://virtualenv.pypa.io/
[pyenv]: https://github.com/pyenv/pyenv
[virtualenv-docs-config-file]: https://virtualenv.pypa.io/en/latest/cli_interface.html#configuration-file

