Metadata-Version: 2.1
Name: tox-asdf
Version: 0.1.1.dev0
Summary: A plugin telling tox to use asdf to find python executables
Home-page: https://github.com/apihackers/tox-asdf
Author: API Hackers
Author-email: pypi+tox-asdf@apihackers.com
License: MIT
Keywords: tox asdf
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
Classifier: Programming Language :: Python
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Software Development
Description-Content-Type: text/markdown
Provides-Extra: test
License-File: LICENSE

# tox-asdf







A Tox plugin using [asdf] to find python executables.


## Prerequisites

This plugin is made exclusevly to support [asdf] so obviously you will need a functionnal [asdf] installation as well as the [`asdf-python`][asdf-python] plugin.


## Installation

Simply install `tox-asdf` in addition to `tox` to get ready:

```shell
pip install tox tox-asdf
```

That's it, you can now run `tox` as usual but using [asdf] Python installations.

## Options

### No fallback on system pythons

By default this plugin won't fail if a required Python version is missing from `æsdf`, tox will fallback on its classic way of finding Python binaries from `$PATH`.
You can override this behavior and force `tox` to only use `asdf` by using the `--asdf-no-fallback` option:

```shell
tox --asdf-no-fallback
```

### Automatically install pythons

By default, `tox-asdf` won't try to install missing Python version, but you can force this by using the `--asdf-install` option.

```shell
tox --asdf-install
```

Obviously this will only useful on the first run.


[asdf]: https://github.com/asdf-vm/asdf
[asdf-python]: https://github.com/asdf-vm/asdf-python

# Changelog

## Current (in progress)

- Nothing yet

## 0.1.0 (2019-01-05)

Initial release

