1App::Packager(3)      User Contributed Perl Documentation     App::Packager(3)
2
3
4

NAME

6       App::Packager - Abstraction for Packagers
7

SYNOPSIS

9       App::Packager provides an abstract interface to a number of common
10       packagers, trying to catch as much common behaviour as possible.
11
12       The main purpose is to have uniform access to application specific
13       resources.
14
15       Supported packagers are PAR::Packer, Cava::Packager and unpackaged. In
16       the latter case, resources are looked up in @PATH, and the name of the
17       application package must be passed to the first "use" of App::Packager.
18
19       For example:
20
21           use App::Packager qw(:name My::App);
22           print "My packager is: ", App::Packager::Packager(), "\n";
23           print getresource("README.txt");
24

EXPORT

26       By default, function "getresource" is exported. It can be exported
27       under a different name by providing an alternative name as follows:
28
29           use App::Packager( ':rsc' => '...alternative name...' );
30

FUNCTIONS

32   App::Packager::Packager
33       Returns the name of the actual packager, or "App Packager" if
34       unpackaged.
35
36   App::Packager::Version
37       Returns the version of the packager.
38
39   App::Packager::IsPackaged
40       Returns true if the application was packaged.
41
42       Note that it is usually easier, and safer, to use
43       $App::Packager::PACKAGED for testing since that will work even if
44       App::Packager is not available.
45

App::Packager::GetResourcePath

47       Returns the path name of the application resources directory.
48

App::Packager::GetResource($rsc)

50       Returns the file name of the application resource.
51

App::Packager::GetUserFile($rsc)

53       Returns the file name of the user specific resource.
54

AUTHOR

56       Johan Vromans, "<JV at CPAN dot org>"
57

SUPPORT

59       Development of this module takes place on GitHub:
60       <https://github.com/sciurius/perl-App-Packager>.
61
62       You can find documentation for this module with the perldoc command.
63
64           perldoc App::Packager
65
66       Please report any bugs or feature requests using the issue tracker on
67       GitHub.
68

ACKNOWLEDGEMENTS

70       This module was inspired by Mark Dootson's Cava packager.
71

73       Copyright 2017,2018 Johan Vromans, all rights reserved.
74
75       This program is free software; you can redistribute it and/or modify it
76       under the same terms as Perl itself.
77

POD ERRORS

79       Hey! The above document had some coding errors, which are explained
80       below:
81
82       Around line 253:
83           =back without =over
84
85
86
87perl v5.36.0                      2022-07-22                  App::Packager(3)
Impressum