NAME

Perl::Build - perl builder

SYNOPSIS

CLI interface without dependencies

# perl-build command is FatPacker ready
% curl https://raw.github.com/tokuhirom/Perl-Build/master/perl-build | perl - 5.16.2 /opt/perl-5.16/

CLI interface

% cpanm Perl::Build
% perl-build 5.16.2 /opt/perl-5.16/

Programmable interface

# install perl from CPAN
Perl::Build->install_from_cpan(
    '5.16.2' => (
        dst_path          => '/path/to/perl-5.16.2/',
        configure_options => ['-des'],
    )
);

# install perl from tar ball
Perl::Build->install_from_cpan(
    'path/to/perl-5.16.2.tar.gz' => (
        dst_path          => '/path/to/perl-5.16.2/',
        configure_options => ['-des'],
    )
);

DESCRIPTION

This is yet another perl builder module.

THIS IS A DEVELOPMENT RELEASE. API MAY CHANGE WITHOUT NOTICE.

METHODS

• Perl::Build->install_from_cpan($version, %args)

  Install $version perl from CPAN. This method fetches tar ball from CPAN, build, and install it.

  You can pass following options in %args.

  • dst_path

    Destination directory to install perl.

  • configure_options : ArrayRef(Optional)

    Command line arguments for ./Configure.

    (Default: ['-de'])

  • tarball_dir(Optional)

    Temporary directory to put tar ball.

  • build_dir(Optional)

    Temporary directory to build binary.

• Perl::Build->install_from_tarball($dist_tarball_path, %args)

  Install perl from tar ball. This method extracts tar ball, build, and install.

  You can pass following options in %args.

  • dst_path(Required)

    Destination directory to install perl.

  • configure_options : ArrayRef(Optional)

    Command line arguments for ./Configure.

    (Default: ['-de'])

  • build_dir(Optional)

    Temporary directory to build binary.

• Perl::Build->install(%args)

  Build and install Perl5 from extracted source directory.

  • src_path(Required)

    Source code directory to build. That contains extracted Perl5 source code.

  • dst_path(Required)

    Destination directory to install perl.

  • configure_options : ArrayRef(Optional)

    Command line arguments for ./Configure.

    (Default: ['-de'])

  • test: Bool(Optional)

    If you set this value as true, Perl::Build runs make test after building.

    (Default: 0)

• Perl::Build->symlink_devel_executables($bin_dir:Str)

  Perl5 binary generated with -Dusedevel, is "perl-5.12.2" form. This method symlinks "perl-5.12.2" to "perl".

FAQ

• How can I use patchperl plugins?

  If you want to use patchperl plugins, please google "PERL5_PATCHPERL_PLUGIN".

THANKS TO

Most of the code was taken from App::perlbrew.

TYPESTER - suggests --patches option

Thanks

AUTHOR

Tokuhiro Matsuno tokuhirom@gmail.com

LICENSE

This software takes most of the code from App::perlbrew.

Perl::Build uses same license with perlbrew.