Awesome

asdf-copier <!-- omit in toc -->

copier plugin for the asdf version manager.

Contents

• Contents
• Dependencies
• Install
  • add the plugin
  • install copier
• Note
• Contributing
• License

Dependencies

• bash, curl, and POSIX utilities.
• a python 3 runtime (provided through asdf-python or not)
• optional: uv

Install

add the plugin

When asdf-vm/asdf-plugins#1034 will be merged

asdf plugin add copier

Or:

asdf plugin add copier https://github.com/looztra/asdf-copier.git

install copier

• If uv is found, the virtual environment that hosts the copier package will be created with it. The plugin will fallback to python -m venvif uv is not available.
• Similarly to asdf-pyapp (KUDOS to the maintainers!), the python 3 version used will be one provided by asdf if the asdf-python plugin is installed. The asdf-copier plugin will fallback to a system python3 installation if no python3 version is available through asdf.
• You can override the detection mechanism by providing the ASDF_PYAPP_DEFAULT_PYTHON_PATH environment variable when installing a copier version (we decided to use the same env var name as pyapp to avoid having to define one more env var if possible)

# Show all installable versions
asdf list all copier

# Install latest version
asdf install copier latest

# Set a version globally (on your ~/.tool-versions file)
asdf global copier latest

# Now copier commands are available
copier --help

Check asdf readme for more instructions on how to install & manage versions.

Note

• As copier is installed in a virtual environment, if the installation of python used to install copier does not exist anymore (if it comes from asdf or brew for instance), copier will fail to launch. You will need to uninstall/reinstall the copier version.

Contributing

Contributions of any kind welcome! See the contributing guide.

Thanks goes to these contributors!

License

See LICENSE © Christophe Furmaniak