Perl::Dist::Asset::Binary - "Binary Package" asset for a Win32 Perl
my $binary = Perl::Dist::Asset::Binary->new( name => 'dmake', license => { 'dmake/COPYING' => 'dmake/COPYING', 'dmake/readme/license.txt' => 'dmake/license.txt', }, install_to => { 'dmake/dmake.exe' => 'c/bin/dmake.exe', 'dmake/startup' => 'c/bin/startup', }, );
Perl::Dist::Asset::Binary is a data class that provides encapsulation and error checking for a "binary package" to be installed in a Perl::Dist-based Perl distribution.
It is normally created on the fly by the <Perl::Dist::Inno> install_binary method (and other things that call it).
install_binary
These packages will be simple zip or tar.gz files that are local files, installed in a CPAN distribution's 'share' directory, or retrieved from the internet via a URI.
The specification of the location to retrieve the package is done via the standard mechanism implemented in Perl::Dist::Asset.
This class inherits from Perl::Dist::Asset and shares its API.
The new constructor takes a series of parameters, validates then and returns a new Perl::Dist::Asset::Binary object.
new
It inherits all the params described in the Perl::Dist::Asset new method documentation, and adds some additional params.
The required name param is the logical (arbitrary) name of the package for the purposes of identification.
name
During the installation build process, licenses files are pulled from the various source packages and written to a single dedicated directory.
The optional license param should be a reference to a HASH, where the keys are the location of license files within the package, and the values are locations within the "licenses" subdirectory of the final installation.
license
The required install_to param describes the location that the package will be installed to.
install_to
If the install_to param is a single string, such as "c" or "perl\foo" the entire binary package will be installed, with the root of the package archive being placed in the directory specified.
If the install_to param is a reference to a HASH, it is taken to mean that only some parts of the original binary package are required in the final install. In this case, the keys should be the file or directories desired, and the values are the names of the file or directory in the final Perl installation.
Although this param does not default when called directly, in practice the Perl::Dist::Inno install_binary method will default this value to "c", as most binary installations are for C toolchain tools or pre-compiled C libraries.
The new constructor returns a Perl::Dist::Asset::Binary object, or throws an exception (dies) if an invalid param is provided.
Bugs should be reported via the CPAN bug tracker at
http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Perl-Dist
For other issues, contact the author.
Adam Kennedy <adamk@cpan.org>
Perl::Dist, Perl::Dist::Inno, Perl::Dist::Asset
Copyright 2007 - 2009 Adam Kennedy.
This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
The full text of the license can be found in the LICENSE file included with this module.
To install Perl::Dist, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Perl::Dist
CPAN shell
perl -MCPAN -e shell install Perl::Dist
For more information on module installation, please visit the detailed CPAN module installation guide.