/ 
Alien-Ruby-0.02
River stage zero No dependents
/ Alien::Ruby

NAME

Alien::Ruby - Find or install Ruby

SYNOPSIS

use Alien::Ruby;

use Env qw( @PATH );

unshift @PATH, Alien::Ruby->bin_dir;

system(q(ruby -e 'puts "Hello from Ruby!"'));

system('gem install pry');

DESCRIPTION

This distribution provides the Ruby programming language so that it can be used by other Perl distributions. It does this by first trying to detect an existing install of Ruby on your system. If found it will use that. If it cannot be found, the Ruby source code will be downloaded from the internet and it will be compiled and installed to a private share location for the use of other Perl modules.

GEM / BUNDLER

Because RubyGems (since Ruby 1.9) and Bundler (since Ruby 2.6) are included with Ruby, and the gem and bundle executables are installed into the same directory as the ruby executable, you can use Alien::Ruby as if it were Alien::Gem or Alien::Bundler.

Please be mindful of the $ENV{GEM_HOME} and $ENV{GEM_PATH} environment variables. These variables will change the default locations where Gem's can be found, and where Gem's will be installed.

SPECIFY RUBY VERSION

To specify the version of Ruby you want, set the ALIEN_RUBY_VERSION environment variable before installing Alien::Ruby:

$ ALIEN_RUBY_VERSION=2.7.7 cpanm Alien::Ruby

The minimum supported Ruby version is 2.1.0.

HELPERS

ruby

%{ruby}

Returns the name of the ruby command which is just 'ruby'.

gem

%{gem}

Returns the name of the gem command which is just 'gem'.

bundle

%{bundle}

Returns the name of the bundle command which is just 'bundle'.

WINDOWS

Windows is not currently supported. Patches welcome.

SEE ALSO

Alien

Documentation on the Alien concept itself.

Alien::Base

The base class for this Alien.

Alien::Build::Manual::AlienUser

Detailed manual for users of Alien classes.

AUTHOR

Nicholas Hubbard <nicholashubbard@posteo.net>

CONTRIBUTORS

  • William N. Braswell, Jr.

  • Zakariyya Mughal