NAME

App::MechaCPAN::Perl - Mechanize the installation of Perl.

SYNOPSIS

  # Install 5.24 into local/
  user@host:~$ mechacpan perl 5.24

DESCRIPTION

The perl command is used to install perl into local/. This removes the packages dependency on the operating system perl.

Methods

go( \%opts, $version )

There is only a single public function that should be called. This will install the version of perl given in $version using the options in \%opts. The options available are listed in the arguments section below.

$version is either 0 or 1 parameter:

If 0 parameters are given and there is a .perl-version file, it will try and use that as the version to install.

Otherwise, if 0 parameters are given, it will attempt to find and install the newest, stable version of perl.

If the parameter is a major version (5.XX), it will attempt to find and install the newest minor version of that major version.

If the parameter is a minor version (5.XX.X), it will attempt to download and install that exact version.

If the parameter is a file, it will try to use that file as a perl source tarball.

If the parameter looks like a URL, it will fetch that URL and try to use it as a perl source tarball.

Arguments

threads

By default, perl is compiled without threads. If you'd like to enable threads, use this argument.

jobs

How many make jobs to use when running make. Defaults to 2.

skip-tests

Test for perl are ran by default. If you are sure that the tests will pass and you want to save some time, you can skip the testing phase with this option.

skip-local

Since perl and modules will be installed by App::MechaCPAN into local/, by default local/ will be added to @INC. This means that if you use the local/ installed perl you do not need to use local::lib or other @INC tricks. If you want to supress this behavior, use this flag.

skip-lib

If a lib/ directory exists in the same directory as the local/ directory, then lib/ will also bee added to @INC. This is helpful if you're installing to run an application that includes a lib/ directory. If you do not want this to be added, use this flag.

AUTHOR

Jon Gentle <cpan@atrodo.org>

COPYRIGHT

Copyright 2017- Jon Gentle

LICENSE

This is free software. You may redistribute copies of it under the terms of the Artistic License 2 as published by The Perl Foundation.

SEE ALSO

plenv

App::perlbrew