slobo/rakudobrew

Perl 6 installation manager

Put this in ~/.rakudobrew, and add aliases for convenience.

It's quick and dirty, may be broken on your system. Please report any breakages.

Installing rakudobrew

On *nix do:

git clone https://github.com/tadzik/rakudobrew ~/.rakudobrew
export PATH=~/.rakudobrew/bin:$PATH
rakudobrew init # Instructions for permanent installation.

On Windows CMD do:

git clone https://github.com/tadzik/rakudobrew %USERPROFILE%\rakudobrew
SET PATH "%USERPROFILE%\rakudobrew\bin;%PATH%"
rakudobrew init # Instructions for permanent installation.

On Windws PowerShell do:

git clone https://github.com/tadzik/rakudobrew $Env:USERPROFILE\rakudobrew
$Env:PATH = "$Env:USERPROFILE\rakudobrew\bin;$Env:PATH"
rakudobrew init # Instructions for permanent installation.

Windows specialities

If you want to use the Microsoft compiler cl you have to make sure the compiler is on your PATH and you have the environment variables cl requires set. This happens automatically when using the Native Tools Command Prompt but has to be done manually when using a normal terminal (or PowerShell). The script vcvars32.bat in the same folder as cl itself sets these variables up automatically. On PowerShell this requires some additional trickery as described on StackOverflow: http://stackoverflow.com/q/6140864

It might be necessary to use an Administrative console to work around a problem with permissions that go wrong during the build process.

Bootstrapping a Perl 6 implementation

Run something like:

$ rakudobrew build moar

to build the latest Rakudo (in this case, on the MoarVM backend), which should then be available as perl6. Then, to get the Panda module management tool, do:

$ rakudobrew build-panda

Upgrading your Perl 6 implementation

$ rakudobrew build moar

Upgrading rakudobrew itself

$ rakudobrew self-upgrade

Uninstall rakudobrew and its Perl 6(s)

To remove rakudobrew and any Perl 6 implementations it's installed on your system, just remove or rename the ~/.rakudobrew directory.

Specifying custom git path

In case git is not in any standard PATH on your system, you can specify a custom path to the git binary using a GIT_BINARY environment variable:

$ GIT_BINARY="%USERPROFILE%\Local Settings\Application Data\GitHub\PORTAB~1\bin\git.exe" rakudobrew build all

Command-line switches

Run rakudobrew