Alien-Base-ModuleBuild
view release on metacpan or search on metacpan
Returns a set of key value pairs including stdout, stderr, success and
command.
alien_do_commands
$amb->alien_do_commands($phase);
Executes the commands for the given phase.
alien_interpolate
my $string = $amb->alien_interpolate($string);
Takes the input string and interpolates the results.
alien_install_network
[version 1.16]
my $bool = $amb->alien_install_network;
Returns true if downloading source from the internet is allowed. This
is true unless ALIEN_INSTALL_NETWORK is defined and false.
alien_download_rule
[version 1.16]
my $rule = $amb->alien_download_rule;
This will return one of warn, digest, encrypt, digest_or_encrypt or
digest_and_encrypt. This is based on the ALIEN_DOWNLOAD_RULE
environment variable.
GUIDE TO DOCUMENTATION
The documentation for Module::Build is broken up into sections:
General Usage (Module::Build)
This is the landing document for Alien::Base::ModuleBuild's parent
class. It describes basic usage and background information. Its main
purpose is to assist the user who wants to learn how to invoke and
control Module::Build scripts at the command line.
It also lists the extra documentation for its use. Users and authors
of Alien:: modules should familiarize themselves with these
documents. Module::Build::API is of particular importance to authors.
Alien-Specific Usage (Alien::Base::ModuleBuild)
This is the document you are currently reading.
Authoring Reference (Alien::Base::Authoring)
This document describes the structure and organization of Alien::Base
based projects, beyond that contained in Module::Build::Authoring,
and the relevant concepts needed by authors who are writing Build.PL
scripts for a distribution or controlling Alien::Base::ModuleBuild
processes programmatically.
Note that as it contains information both for the build and use
phases of Alien::Base projects, it is located in the upper namespace.
API Reference (Alien::Base::ModuleBuild::API)
This is a reference to the Alien::Base::ModuleBuild API beyond that
contained in Module::Build::API.
Using the resulting Alien (Alien::Build::Manual::AlienUser)
Once you have an Alien you or your users can review this manual for
how to use it. Generally speaking you should have some useful usage
information in your Alien's POD, but some authors choose to direct
their users to this manual instead.
Using Alien::Build instead (Alien::Build::Manual)
As mentioned at the top, you are encouraged to use the Alien::Build
and alienfile system instead. This manual is a starting point for the
other Alien::Build documentation.
ENVIRONMENT
ALIEN_ARCH
Set to a true value to install to an arch-specific directory.
ALIEN_DOWNLOAD_RULE
This controls security options for fetching alienized packages over
the internet. The legal values are:
warn
Warn if the package is either unencrypted or lacks a digest. This
is currently the default, but will change in the near future.
digest
Fetch will not happen unless there is a digest for the alienized
package.
encrypt
Fetch will not happen unless via an encrypted protocol like https,
or if the package is bundled with the Alien.
digest_or_encrypt
Fetch will only happen if the alienized package has a cryptographic
signature digest, or if an encrypted protocol like https is used,
or if the package is bundled with the Alien. This will be the
default in the near future.
digest_and_encrypt
Fetch will only happen if the alienized package has a cryptographic
signature digest, and is fetched via a secure protocol (like
https). Bundled packages are also considered fetch via a secure
( run in 1.354 second using v1.01-cache-2.11-cpan-df04353d9ac )