asdf/README.md

asdf version manager

for everything that needs a version manager

asdf is an extendable version manager. Feel free to add support for the language you want. There's a simple API for it. Read the ballad.

Table of Contents

• Install
• Manage sources
• Manage packages
• The .versions file
• Creating package sources

Install

Copy-paste the following into command line:

git clone https://github.com/HashNuke/asdf.git ~/.asdf
echo 'export PATH="$HOME/.asdf/bin:$PATH"' >> ~/.bash_profile

That's all ~! You are ready to use asdf

It clones the adsf repo and adds ~/.asdf/bin to $PATH in ~/.bash_profile.

Manage sources

Sources are how asdf understands how to handle packages.

Add a package

# asdf source-add <name> <git-url>
asdf source-add erlang https://github.com/HashNuke/asdf-erlang.git

Remove a source

# asdf source-remove <name>
asdf source-remove erlang

Update sources

# To update all sources
asdf source-update --all

If you want to update a specific package, just say so.

# asdf source-update <name>
asdf source-update erlang

Manage packages

# asdf install <name> <version>
asdf install erlang 17.3

# asdf uninstall <name> <version>
asdf uninstall erlang 17.3

Lists installed versions

# asdf list <name>
asdf list erlang

List all available versions

# asdf list-all <name>
asdf list-all erlang

Use a specific version of a package

# asdf use <name> <version>
asdf use erlang 17.3

It writes the version to the .versions file in the current working directory.

The .versions file

Add a .versions file to your project dir and versions of those packages will be used.

elixir 1.0.2
erlang 17.3

Creating package sources

A package source is a git repo, with the following executable scripts

• bin/list-all - lists all installable versions
• bin/install - installs the specified version
• bin/uninstall - uninstalls the specified version
• bin/use - whatever you want to run when a specific version is used (like set an env var?)

bin/list-all

This script should list stable versions that can be installed

bin/install

This script should install the package. It will be passed the following command-line args (in order).

• install type - "version", "tag", "commit"
• version - this is the version or commit sha or the tag name that should be installed (use the first argument to figure out what to do).
• install path - the dir where the it should be installed

Any other args that comes after this is whatever the user passes to the install command. Feel free to use them in whatever way you think is appropriate.

These scripts are run when list-all, install, uninstall or use commands are run. You can set or unset env vars and do whatever you need.

bin/uninstall

Uninstalls a command. Same args as the bin/install script.

bin/use

Will be passed the following args

• install type
• version

Feel free to set env vars and do what is appropriate to setup the version of the package for use.

Credits

Me (@HashNuke), High-fever, cold, cough

Copyright 2014 to the end of time