The Perl Toolchain Summit 2025 Needs You: You can help 🙏 Learn more

use strict;
use autodie;
use Config;
use File::Fetch qw//;
use App::MechaCPAN qw/:go/;
our @args = (
'threads!',
'skip-tests!',
'skip-local!',
'skip-lib!',
);
sub go
{
my $class = shift;
my $opts = shift;
my $src = shift;
my @argv = shift;
if ($^O eq 'MSWin32')
{
info 'Cannot build perl on Win32';
return 0;
}
my $orig_dir = &dest_dir;
my @orig_dir = File::Spec->splitdir("$orig_dir");
my $orig_len = $#orig_dir;
my $dest_dir = "$orig_dir/perl";
my ( $src_tz, $version ) = _get_targz($src);
if ( -e -x "$dest_dir/bin/perl" )
{
unless ( $opts->{is_restarted_process} )
{
# If it exists, we're probably running it by now.
if ( $version && $^V ne "v$version" )
{
info(
$version,
"perl has already been installed ($^V, not $version)"
);
}
else
{
success( $version, "perl has already been installed" );
}
}
return 0;
}
$version = "perl $version";
info $version, "Fetching $version";
my $src_dir = inflate_archive($src_tz);
chdir $src_dir;
if ( !-e 'Configure' )
{
my @files = glob('*');
if ( @files > 1 )
{
die 'Could not find perl to configure';
}
chdir $files[0];
}
my $local_dir = [ @orig_dir, qw/lib perl5/ ];
my $lib_dir = [ @orig_dir[ 0 .. $orig_len - 1 ], qw/lib perl5/ ];
my @otherlib = (
!$opts->{skip_local} ? () : $local_dir,
!$opts->{skip_lib} && -d $lib_dir ? $lib_dir : (),
);
@otherlib = map { File::Spec->catdir(@$_) } @otherlib;
my @config = (
q[-des],
qq[-Dprefix=$dest_dir],
q[-Accflags=-DAPPLLIB_EXP=\"] . join( ":", @otherlib ) . q[\"],
qq[-A'eval:scriptdir=$dest_dir/bin'],
);
my @make = ( $Config{make} );
if ( $opts->{threads} )
{
push @config, '-Dusethreads';
}
delete @ENV{qw(PERL5LIB PERL5OPT)};
# Make sure no tomfoolery is happening with perl, like plenv shims
$ENV{PATH} = $Config{binexp} . ":$ENV{PATH}";
eval {
info $version, "Patching $version";
Devel::PatchPerl->patch_source();
};
info $version, "Configuring $version";
run qw[sh Configure], @config;
info $version, "Building $version";
run @make;
if ( !$opts->{'skip-tests'} )
{
info $version, "Testing $version";
run @make, 'test_harness';
}
info $version, "Installing $version";
run @make, 'install';
success "Installed $version";
chdir $orig_dir;
&restart_script();
return 0;
}
my $perl5_re = qr/^ v? 5 [.] (\d{1,2}) (?: [.] (\d{1,2}) )? $/xms;
sub _dnld_url
{
my $version = shift;
my $minor = shift;
return "$mirror/perl-5.$version.$minor.tar.bz2";
}
sub _get_targz
{
my $src = shift;
local $File::Fetch::WARN;
# Attempt to find the perl version if none was given
if ( !defined $src && -f '.perl-version' )
{
open my $pvFH, '<', '.perl-version';
my $pv = do { local $/; <$pvFH> };
#($src) = $pv =~ m[($perl5_re)]xms;
}
# If there's no src, find the newest version.
if ( !defined $src )
{
# Do a terrible job of guessing what the current version is
use Time::localtime;
my $year = localtime->year() + 1900;
# 5.12 was released in 2010, and approximatly every May, a new even
# version was released
my $major = ( $year - 2010 ) * 2 + ( localtime->mon < 4 ? 10 : 12 );
# Verify our guess
{
my $dnld = _dnld_url( $major, 0 ) . ".md5.txt";
my $ff = File::Fetch->new( uri => $dnld );
my $contents = '';
my $where = $ff->fetch( to => \$contents );
if ( !defined $where && $major > 12 )
{
$major -= 2;
redo;
}
}
$src = "5.$major";
}
# file
if ( -e $src )
{
return ( $src, '' );
}
my $url;
# URL
if ( $src =~ url_re )
{
return ( $src, '' );
}
# CPAN
if ( $src =~ $perl5_re )
{
my $version = $1;
my $minor = $2;
# They probably want the latest if minor wasn't given
if ( !defined $minor )
{
# 11 is the highest minor version seen as of this writing
my @possible = ( 0 .. 15 );
while ( @possible > 1 )
{
my $i = int( @possible / 2 );
$minor = $possible[$i];
my $dnld = _dnld_url( $version, $minor ) . ".md5.txt";
my $ff = File::Fetch->new( uri => $dnld );
my $contents = '';
my $where = $ff->fetch( to => \$contents );
if ( defined $where )
{
# The version exists, which means it's higher still
@possible = @possible[ $i .. $#possible ];
}
else
{
# The version doesn't exit. That means higher versions don't either
@possible = @possible[ 0 .. $i - 1 ];
}
}
$minor = $possible[0];
}
return ( _dnld_url( $version, $minor ), "5.$version.$minor" );
}
die "Cannot find $src\n";
}
1;
__END__
=encoding utf-8
=head1 NAME
App::MechaCPAN::Perl - Mechanize the installation of Perl.
=head1 SYNOPSIS
# Install 5.24 into local/
user@host:~$ mechacpan perl 5.24
=head1 DESCRIPTION
The C<perl> command is used to install L<perl> into C<local/>. This removes the packages dependency on the operating system perl.
=head2 Methods
=head3 go( \%opts, $version )
There is only a single public function that should be called. This will install the version of perl given in C<$version> using the options in C<\%opts>. The options available are listed in the L<arguments|/Arguments> section below.
C<$version> is either 0 or 1 parameter:
=over
=item If 0 parameters are given and there is a .perl-version file, it will try and use that as the version to install.
=item Otherwise, if 0 parameters are given, it will attempt to find and install the newest, stable version of perl.
=item If the parameter is a major version (5.XX), it will attempt to find and install the newest minor version of that major version.
=item If the parameter is a minor version (5.XX.X), it will attempt to download and install that exact version.
=item If the parameter is a file, it will try to use that file as a perl source tarball.
=item If the parameter looks like a URL, it will fetch that URL and try to use it as a perl source tarball.
=back
=head2 Arguments
=head3 threads
By default, perl is compiled without threads. If you'd like to enable threads, use this argument.
=head3 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.
=head3 skip-local
Since perl and modules will be installed by L<App::MechaCPAN> into C<local/>, by default C<local/> will be added to C<@INC>. This means that if you use the C<local/> installed perl you do not need to use L<local::lib> or other C<@INC> tricks. If you want to suppress this behavior, use this flag.
=head3 skip-lib
If a C<lib/> directory exists in the same directory as the C<local/> directory, then C<lib/> will also bee added to C<@INC>. This is helpful if you're installing to run an application that includes a C<lib/> directory. If you do not want this to be added, use this flag.
=head1 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.
=head1 AUTHOR
Jon Gentle E<lt>cpan@atrodo.orgE<gt>
=head1 COPYRIGHT
Copyright 2017- Jon Gentle
=head1 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.
=head1 SEE ALSO
=over
=item L<App::perlbrew>
=back
=cut