asdf-python/README.md

# asdf-python

[![Build Status](https://travis-ci.org/danhper/asdf-python.svg?branch=master)](https://travis-ci.org/danhper/asdf-python)

Python plugin for [asdf](https://github.com/asdf-vm/asdf) version manager

## Install

```
asdf plugin-add python https://github.com/danhper/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.
Initial commit. 2016-04-24 10:28:48 +01:00			`# asdf-python`

fix travis by catering for the renamed github repo https://github.com/tuvistavie/asdf-python -> https://github.com/danhper/asdf-python 2018-12-02 22:48:05 +00:00			`[![Build Status](https://travis-ci.org/danhper/asdf-python.svg?branch=master)](https://travis-ci.org/danhper/asdf-python)`
Add badge to README 2016-06-12 08:59:01 +01:00
Initial commit. 2016-04-24 10:28:48 +01:00			`Python plugin for [asdf](https://github.com/asdf-vm/asdf) version manager`

			`## Install`

			```
fix travis by catering for the renamed github repo https://github.com/tuvistavie/asdf-python -> https://github.com/danhper/asdf-python 2018-12-02 22:48:05 +00:00			`asdf plugin-add python https://github.com/danhper/asdf-python.git`
Initial commit. 2016-04-24 10:28:48 +01:00			```

			`## Use`

			`Check [asdf](https://github.com/asdf-vm/asdf) readme for instructions on how to install & manage versions of Python.`
Adds link to required system dependencies in README 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.`
Initial commit. 2016-04-24 10:28:48 +01:00
Make asdf-python a wrapper of python-build 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)`
Add link to pyenv common build problems in README 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.`

Add note about multiple versions to README 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`

			```
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 14:37:47 +00:00			`asdf global python 3.6.2 2.7.13`
Add note about multiple versions to README 2018-07-14 03:24:11 +01:00			```

			`This feature is experimental but should be working well enough for most use cases.`
Add section about pip and reshimming after module with binaries is installed. 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.