NAME
App::MechaCPAN::Perl - Mechanize the installation of Perl.
SYNOPSIS
# Install 5.24 into local/
user@host:~$ mechacpan perl 5.24DESCRIPTION
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.
shared-lib
By default, perl will generate a libperl.a file. If you need libperl.so, then use this argument.
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.
smart-tests
As an alternative to telling App::MechaCPAN::Perl to use tests or not, App::MechaCPAN::Perl can try to be clever and guess if it needs to run tests. If there is a .perl-version file and it is the same version that is being installed, then tests will be skips. The thinking is that if there is a .perl-version file, then it is likely that perl has been installed and tested before.
smart-tests are off by default, but are enabled by App::MechaCPAN::Deploy when there is a cpanfile.snapshot file. See "smart-tests" in App::MechaCPAN::Install.
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 suppress 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.
devel
By default, perl will not compile a development version without -Dusedevel passed to configure. This adds that flag to the configure step so that perl will install unstable development versions. This is NOT recommended except for testing.
WIN32 LIMITATION
Building perl from scratch on Win32 is nothing like building it on other platforms. At this point, the perl command does not work on Win32.
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.