App::Packager - Abstraction for Packagers
App::Packager provides an abstract interface to a number of common packagers, trying to catch as much common behaviour as possible.
The main purpose is to have uniform access to application specific resources.
Supported packagers are PAR::Packer, Cava::Packager and unpackaged. In the latter case, resources are looked up in @PATH, and the name of the application package must be passed to the first use of App::Packager.
use
For example:
use App::Packager qw(:name My::App); print "My packager is: ", App::Packager::Packager(), "\n"; print getresource("README.txt");
By default, function getresource is exported. It can be exported under a different name by providing an alternative name as follows:
getresource
use App::Packager( ':rsc' => '...alternative name...' );
Returns the name of the actual packager, or App Packager if unpackaged.
App Packager
Returns the version of the packager.
Returns true if the application was packaged.
Note that it is usually easier, and safer, to use $App::Packager::PACKAGED for testing since that will work even if App::Packager is not available.
Returns the path name of the application resources directory.
Returns the file name of the application resource.
Returns the file name of the user specific resource.
Johan Vromans, <JV at CPAN dot org>
<JV at CPAN dot org>
Development of this module takes place on GitHub: https://github.com/sciurius/perl-App-Packager.
You can find documentation for this module with the perldoc command.
perldoc App::Packager
Please report any bugs or feature requests using the issue tracker on GitHub.
This module was inspired by Mark Dootson's Cava packager.
Copyright 2017,2018 Johan Vromans, all rights reserved.
This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
1 POD Error
The following errors were encountered while parsing the POD:
=back without =over
To install App::Packager, copy and paste the appropriate command in to your terminal.
cpanm
cpanm App::Packager
CPAN shell
perl -MCPAN -e shell install App::Packager
For more information on module installation, please visit the detailed CPAN module installation guide.