2016-04-24 10:28:48 +01:00
# asdf-python
2016-06-12 08:59:01 +01:00
[![Build Status ](https://travis-ci.org/tuvistavie/asdf-python.svg?branch=master )](https://travis-ci.org/tuvistavie/asdf-python)
2016-04-24 10:28:48 +01:00
Python plugin for [asdf ](https://github.com/asdf-vm/asdf ) version manager
## Install
```
asdf plugin-add python https://github.com/tuvistavie/asdf-python.git
```
## Use
Check [asdf ](https://github.com/asdf-vm/asdf ) readme for instructions on how to install & manage versions of Python.
2017-09-16 11:49:22 +01:00
Please make sure you have the required [system dependencies ](https://github.com/pyenv/pyenv/wiki#suggested-build-environment ) installed before trying to install Python.
2016-04-24 10:28:48 +01:00
2016-08-30 07:25:56 +01:00
Under the hood, asdf-python uses [python-build ](https://github.com/yyuu/pyenv/tree/master/plugins/python-build )
to build and install Python, check its [README ](https://github.com/yyuu/pyenv/tree/master/plugins/python-build )
2017-10-22 18:28:22 +01:00
for more information about build options and the [common build problems ](https://github.com/pyenv/pyenv/wiki/Common-build-problems ) wiki page for any issues encountered during installation of python versions.
2018-07-14 03:24:11 +01:00
## Using multiple versions of Python
A common request for Python is being able to use the `python2` and `python3` commands without needing to switch version.
This can be achieved by setting multiple versions of Python, for example with
```
2018-11-30 14:37:47 +00:00
asdf global python 3.6.2 2.7.13
2018-07-14 03:24:11 +01:00
```
This feature is experimental but should be working well enough for most use cases.
2018-08-30 19:02:56 +01:00
## Pip installed modules and binaries
If you use pip to install a module like ipython that has a binaries. You will need to run `asdf reshim python` for the binary to be in your path.