view release on metacpan or  search on metacpan

README  view on Meta::CPAN

    exception.

 download

     $build->download;

    Download the source, usually as a tarball, usually from the internet.

    Under a system install this does not do anything.

 fetch

     my $res = $build->fetch;
     my $res = $build->fetch($url, %options);

    Fetch a resource using the fetch hook. Returns the same hash structure
    described below in the fetch hook documentation.

    [version 2.39]

    As of Alien::Build 2.39, these options are supported:

    http_headers

       my $res = $build->fetch($url, http_headers => [ $key1 => $value1, $key2 => $value 2, ... ]);

      Set the HTTP request headers on all outgoing HTTP requests. Note that
      not all protocols or fetch plugins support setting request headers,
      but the ones that do not should issue a warning if you try to set
      request headers and they are not supported.

 check_digest

    [experimental]

     my $bool = $build->check_digest($path);

    Checks any cryptographic signatures for the given file. The file is
    specified by $path which may be one of:

    string

      Containing the path to the file to be checked.

    Path::Tiny

      Containing the path to the file to be checked.

    HASH

      A Hash reference containing information about a file. See the fetch
      hook for details on the format.

    Returns true if the cryptographic signature matches, false if
    cryptographic signatures are disabled. Will throw an exception if the
    signature does not match, or if no plugin provides the correct
    algorithm for checking the signature.

 decode

     my $decoded_res = $build->decode($res);

    Decode the HTML or file listing returned by fetch. Returns the same
    hash structure described below in the decode hook documentation.

 prefer

     my $sorted_res = $build->prefer($res);

    Filter and sort candidates. The preferred candidate will be returned
    first in the list. The worst candidate will be returned last. Returns
    the same hash structure described below in the prefer hook
    documentation.

 extract

     my $dir = $build->extract;
     my $dir = $build->extract($archive);

    Extracts the given archive into a fresh directory. This is normally
    called internally to Alien::Build, and for normal usage is not needed
    from a plugin or alienfile.

 build

     $build->build;

    Run the build step. It is expected that probe and download have already
    been performed. What it actually does depends on the type of install:

    share

      The source is extracted, and built as determined by the alienfile
      recipe. If there is a gather_share that will be executed last.

    system

      The gather_system hook will be executed.

 test

     $build->test;

    Run the test phase

 clean_install

     $build->clean_install

    Clean files from the final install location. The default implementation
    removes all files recursively except for the _alien directory. This is
    helpful when you have an old install with files that may break the new
    build.

    For a non-share install this doesn't do anything.

 system

     $build->system($command);
     $build->system($command, @args);