Install the files
git clone git://github.com/jayferd/ry cd ry PREFIX=$HOME/.local make install
and add the following lines to your bashrc (or zshrc):
# If you're using the default ~/.local prefix, # make sure ~/.local/bin is on your $PATH. export PATH="$HOME/.local/bin:$PATH" eval "$(ry setup)"
or, if you don't like
eval, you can do it manually:
export RY_PREFIX="$HOME/.local" export PATH="$RY_PREFIX/lib/ry/current/bin:$PATH" . "$RY_PREFIX/lib/ry.bash_completion"
For ZSH completion, see this.
If you want to specify a different directory for installing rubies:
# rubies are installed into $RY_PREFIX/lib/ry/rubies # set RY_RUBIES for an alternate location export RY_RUBIES="$HOME/.rubies"
Ry is a bit different from other version managers. The major design goal of ry is to be explicit, unobtrusive, and easy to query. In the vein of the n package manager for node, there are no subshells, and the only thing it needs to add to your environment is a single entry to your
$PATH (also tab completion if you like). For example, here's how you create a new installation:
ry install http://ftp.ruby-lang.org/pub/ruby/1.9/ruby-1.9.3-p125.tar.gz mri-1.9.3
This creates an installation of Ruby called
mri-1.9.3 using the tarball from
ruby-lang.org. To switch to this ruby, use
ry use mri-1.9.3 # or: ry mri-1.9.3
Want to use a custom commit?
ry install https://github.com/ruby/ruby/tarball/<hash> mri-custom
If you have
ruby-build installed, you can use it very easily with ry:
ry install 1.9.3-p125
For more information, see
All of the magic is in the bash script
bin/ry. Here are a couple of bash features I use that aren't common elsewhere:
Poor man's namespacing - the character
:is a perfectly valid character to use in a bash function's name. All of ry's subcommands are implemented as functions looking like
ry::foo. At the bottom of the file is the function
rywhich essentially delegates to
ry::$1- so to add a new subcommand, all you need to do is define the bash function and document it in
Piping from heredocs is awesome. The syntax
cmdwith stdin as the content of
$variable. I use this extensively, and you should too.