Python plugin for the asdf version manager Forked from https://github.com/asdf-community/asdf-python Adds PYTHON_CONFIGURE_OPTS="--enable-shared" when building to create a shared python library.
This repository has been archived on 2024-12-07. You can view files and clone it, but cannot push or open issues or pull requests.
Find a file
Jeremy Fleischman e3ada52ca4
Don't complain if a patch file doesn't exist for a particular version of python
I hope this isn't too controversial: I personally have this
`ASDF_PYTHON_PATCHES_DIRECTORY` globally set up on my machine, which is
super useful when I install/reinstall random versions of Python, but is
kind of annoying when I try to install versions of python that don't
actually need a patch: I have to create an empty file just to get it to
install.

With this change, I don't have to do that: instead I only have to create
`.patch` files for the versions of Python that need it.
2022-03-22 14:28:22 -07:00
bin Don't complain if a patch file doesn't exist for a particular version of python 2022-03-22 14:28:22 -07:00
.gitignore add .DS_Store to .gitignore 2021-02-10 11:58:23 +07:00
.travis.yml fix travis by catering for the renamed github repo 2018-12-02 23:48:05 +01:00
LICENSE Add LICENSE 2017-03-27 09:04:39 -07:00
README.md enable install with patch URL 2021-02-10 11:59:05 +07:00

asdf-python

Build Status

Python plugin for asdf version manager

Install

asdf plugin-add python

Install with --patch

Enable to fix macOS 11 issues

You can use environment variable ASDF_PYTHON_PATCH_URL to install with --patch like that:

export ASDF_PYTHON_PATCH_URL="https://github.com/python/cpython/commit/8ea6353.patch?full_index=1"
asdf install python 3.6.12

or use environment variable ASDF_PYTHON_PATCHES_DIRECTORY.

Use

Check asdf readme for instructions on how to install & manage versions of Python. Please make sure you have the required system dependencies installed before trying to install Python.

Under the hood, asdf-python uses python-build to build and install Python, check its README for more information about build options and the 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

Executables in the first version will take priority over the executables in the next one. Note that you can use an arbitrary number over versions, if needed. With the above example, python will therefore use the python executable found in version 3.6.2. However, as the python2 does not exist in Python 3.6.2, python2 will use the python2 executable found in version 2.7.13.

python -V
Python 3.6.2

python3 -V
Python 3.6.2

python2 -V
Python 2.7.13

Pip installed modules and binaries

If you use pip to install a module like ipython that has binaries. You will need to run asdf reshim python for the binary to be in your path.

Default Python packages

asdf-python can automatically install a default set of Python packages with pip right after installing a Python version. To enable this feature, provide a $HOME/.default-python-packages file that lists one package per line, for example:

ansible
pipenv

You can specify a non-default location of this file by setting a ASDF_PYTHON_DEFAULT_PACKAGES_FILE variable.