File Coverage

blib/lib/Config/Apple/Profile/Config.pm
Criterion Covered Total %
statement 12 12 100.0
branch n/a
condition n/a
subroutine 4 4 100.0
pod n/a
total 16 16 100.0


line stmt bran cond sub pod time code
1             package Config::Apple::Profile::Config;
2              
3 4     4   1303 use 5.10.1;
  4         10  
  4         142  
4 4     4   17 use strict;
  4         5  
  4         105  
5 4     4   16 use warnings FATAL => 'all';
  4         5  
  4         231  
6              
7             our $VERSION = '0.87.1';
8              
9             use Exporter::Easy (
10 4         28 OK => [qw(
11             $ACP_OPENSSL_PATH $ACP_OPENSSL_CAN_CMS
12             )],
13             TAGS => [
14             'all' => [qw(
15             $ACP_OPENSSL_PATH $ACP_OPENSSL_CAN_CMS
16             )],
17             'openssl' => [qw($ACP_OPENSSL_PATH $ACP_OPENSSL_CAN_CMS)],
18             ],
19 4     4   456 );
  4         1164  
20              
21              
22             =encoding utf8
23              
24             =head1 NAME
25              
26             Config::Apple::Profile::Config - External programs and modules only used
27             occasionally (or even less).
28              
29             =head1 SYNOPSIS
30              
31             use Config::Apple::Profile::Config;
32              
33             if (defined $Config::Apple::Profile::Config::ACP_OPENSSL_PATH) {
34             # Do something with OpenSSL...
35             }
36              
37             # ... or ...
38              
39             use Config::Apple::Profile::Config qw($ACP_OPENSSL_PATH);
40              
41             if (defined $ACP_OPENSSL_PATH) {
42             # Do something with OpenSSL...
43             }
44              
45             =head1 DESCRIPTION
46              
47             From time to time, the C classes would like to use an
48             executable or a module that is not absolutely required. For example, if you
49             are creating a certificate payload, it would be nice to verify that you are
50             actually providing a certificate.
51              
52             Although such functionality is nice to have, it is not required. Also, there
53             may be more than one way to do certain things (for example, there may be more
54             than one way to examine a PNG file). This package is created when the software
55             is installed, and the variables in this package are not read-only. If you like,
56             your code can change the variables at runtime.
57              
58             All of the package variables can be exported to the local namespace
59             individually, or in groups. The C<:all> group can be used to import all
60             package variables, and additional packages are defined below.
61              
62             =head1 PACKAGE VARIABLES
63              
64             =head2 OpenSSL (group C<:openssl>)
65              
66             =head3 C<$ACP_OPENSSL_PATH>
67              
68             The path to the OpenSSL binary. This may be undefined.
69              
70             =head3 C<$ACP_OPENSSL_CAN_CMS>
71              
72             If true, the OpenSSL executable at C<$ACP_OPENSSL_PATH> supports the `cms`
73             command.
74              
75             =cut
76              
77             our $ACP_OPENSSL_PATH = '/usr/bin/openssl';
78             our $ACP_OPENSSL_CAN_CMS = 1;
79              
80              
81             =head1 ACKNOWLEDGEMENTS
82              
83             Refer to the L for acknowledgements.
84              
85             =head1 AUTHOR
86              
87             A. Karl Kornel, C<< >>
88              
89             =head1 COPYRIGHT AND LICENSE
90              
91             Copyright © 2014 A. Karl Kornel.
92              
93             This program is free software; you can redistribute it and/or modify it
94             under the terms of either: the GNU General Public License as published
95             by the Free Software Foundation; or the Artistic License.
96              
97             See L for more information.
98              
99             =cut
100              
101             1;