asdf-python/README.md
zfletch ea9c41e9be update asdf command in readme
When I run the command `asdf global 3.6.2 2.7.13`, I get the error
message `No such plugin: 3.6.2`.

I think it's missing `python` after `global`. The command
`asdf global python 3.6.2 2.7.13` works for me.
2018-11-30 09:39:33 -05:00

36 lines
1.5 KiB
Markdown

# asdf-python
[![Build Status](https://travis-ci.org/tuvistavie/asdf-python.svg?branch=master)](https://travis-ci.org/tuvistavie/asdf-python)
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.
Please make sure you have the required [system dependencies](https://github.com/pyenv/pyenv/wiki#suggested-build-environment) installed before trying to install Python.
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)
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.
## 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
```
asdf global python 3.6.2 2.7.13
```
This feature is experimental but should be working well enough for most use cases.
## 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.