asdf/README.md
2015-05-10 22:21:33 +05:30

2.3 KiB

asdf

extendable version manager

Feel free to add support for the language you want. There is a simple API for it. For now, I've added support for the following languages:

-- @HashNuke

Support via Gratipay


Install

Copy-paste the following into command line:

git clone https://github.com/HashNuke/asdf.git ~/.asdf

# For Ubuntu or other linux distros
echo 'source $HOME/.asdf/asdf.sh' >> ~/.bashrc

# OR for Max OSX
echo 'source $HOME/.asdf/asdf.sh' >> ~/.bash_profile

If you use zsh or any other shell, replace .bashrc with the config file for the respective shell.

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

Manage sources

Sources are how asdf understands how to handle packages.

Add a package

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

Remove a source

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

Update sources

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

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

# asdf source-update <name>
asdf update-source 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

Credits

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

Copyright 2014 to the end of time


Read the ballad.