https://github.com/apihackers/tox-asdf

A Tox plugin using asdf to find python executables.
https://github.com/apihackers/tox-asdf

asdf asdf-plugin plugin python tox

Last synced: 5 months ago
JSON representation

A Tox plugin using asdf to find python executables.

• Host: GitHub
• URL: https://github.com/apihackers/tox-asdf
• Owner: apihackers
• License: mit
• Created: 2018-12-31T18:54:31.000Z (over 7 years ago)
• Default Branch: main
• Last Pushed: 2025-11-03T20:22:14.000Z (7 months ago)
• Last Synced: 2025-11-28T06:59:58.115Z (7 months ago)
• Topics: asdf, asdf-plugin, plugin, python, tox
• Language: Python
• Homepage:
• Size: 57.6 KB
• Stars: 16
• Watchers: 1
• Forks: 3
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# tox-asdf

[![Tests](https://github.com/apihackers/tox-asdf/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/apihackers/tox-asdf/actions/workflows/ci.yml)

[![pre-commit.ci status](https://results.pre-commit.ci/badge/github/apihackers/tox-asdf/main.svg)](https://results.pre-commit.ci/latest/github/apihackers/tox-asdf/main)

[![codecov](https://codecov.io/gh/apihackers/tox-asdf/branch/main/graph/badge.svg)](https://codecov.io/gh/apihackers/tox-asdf)

[![Last version](https://img.shields.io/pypi/v/tox-asdf.svg)](https://pypi.org/project/tox-asdf)

[![License](https://img.shields.io/pypi/l/tox-asdf.svg?style=flat)](https://pypi.org/project/tox-asdf)

[![Supported Python versions](https://img.shields.io/pypi/pyversions/tox-asdf.svg)](https://pypi.org/project/tox-asdf)

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

## Prerequisites

This plugin is made exclusively to support [asdf] so obviously you will need a functional [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