NAME

Ruby::VersionManager

WARNING!

This is an unstable development release not ready for production!

VERSION

Version 0.004004

SYNOPSIS

The Ruby::VersionManager Module will provide a subset of the bash rvm.

Ruby::VersionManager comes with a script rvm.pl. See the perldoc of rvm.pl for a list of actions and options.

ATTRIBUTES

rootdir

Root directory for Ruby::VersionManager file structure.

ruby_version

The ruby version to install, check or remove. Any String matching one of the major ruby versions is valid. Ruby::VersionManager will guess a version based on available versions matching the string. If multiple versions match the latest stable release will be used. Preview and RC versions will never be installed automatically. You have to provide the full matching version string as shown with the list method.

gemset

Name your gemset. More sophisticated support for gemsets needs to be implemented.

gemsets

Returns an array of the created gemsets.

gem

Uses Ruby::VersionManager::Gem to pass arguments to the 'gem' command. Additionally you can resemble gemsets from other users or machines by using reinstall with a file containing the output of 'gem list'. When omiting the file name the currently installed gemset will be completely reinstalled without pulling in any additional dependencies.

        $rvm->gem('reinstall', ($filename)); # install all gems given in the file
        $rvm->gem('reinstall');              # reinstall all gems from the currently used gemset

        $rvm->gem('install', ('unicorn', '-v=4.0.1));   # install unicorn. Same as 'gem install unicorn -v=4.0.1' on the command line

agent_string

The user agent used when downloading ruby. Defaults to Ruby::VersionManager/0.004004.

archive_type

Type of the ruby archive to download. Defaults to .tar.bz2, valid are also .tar.gz and .zip.

major_version

Will be automatically set.

rubygems_version

Not yet in use.

CONSTRUCTION

All attributes are optional at creation. Note that rootdir should be set at construction if you want another directory than default because Ruby::VersionManager->new will bootstrap the needed directories.

        my $rvm = Ruby:VersionManager->new;

Or

        my $rvm = Ruby:VersionManager->new(
                rootdir => '/path/to/root',
                ruby_version => '1.8',
                gemset => 'name_of_the_set',
        );

METHODS

available_rubies

Returns a hashref of the available ruby versions.

installed_rubies

Returns a hashref of the installed ruby versions.

list

Print a list of available and installed ruby versions to STDOUT.

        $rvm->list;

updatedb

Update database of available ruby versions.

        $rvm->updatedb;

install

Install a ruby version. If no version is given the latest stable release will be installed. The program tries to guess the correct version from the provided string. It should at least match the major release. If you need to install a preview or rc version you will have to provide the full exact version.

Latest ruby

        $rvm->ruby_version('1.9');
        $rvm->install;

Latest ruby-1.8

        $rvm->ruby_version('1.8');
        $rvm->install;

Install preview

        $rvm->ruby_version('ruby-1.9.3-preview1');
        $rvm->install;

uninstall

Remove a ruby version and the source dir including the downloaded archive. You have to provide the full exact version of the ruby you want to remove as shown with list.

        $rvm->ruby_version('ruby-1.9.3-preview1');
        $rvm->uninstall;

switch_gemset

Update the environment to use another gem set for the corrently active ruby.

        $rvm->switch_gemset('another_set')

version

Returns the numerical version of the distribution.

        my $version = $rvm->version

LIMITATIONS

Currently Ruby::VersionManager is only tested to be running on Linux.

AUTHOR

Matthias Krull, <m.krull at uninets.eu>

BUGS

Report bugs at:

SUPPORT

  • Technical support

    <m.krull at uninets.eu>