/usr/share/perl5/Catalyst/Plugin/Setenv.pm is in libcatalyst-modules-extra-perl 8.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 | package Catalyst::Plugin::Setenv;
use warnings;
use strict;
use MRO::Compat;
=head1 NAME
Catalyst::Plugin::Setenv - Allows you to set up the environment from Catalyst's config file.
=head1 VERSION
Version 0.03
=cut
our $VERSION = '0.03';
=head1 SYNOPSIS
In your application:
use Catalyst qw/Setenv/;
In your config file:
environment:
FOO: bar
BAR: baz
When your app starts, C<$ENV{FOO}> will be "bar", and C<$ENV{BAR}> will be
"baz".
You can also append and prepend to existing environment variables.
For example, if C<$PATH> is C</bin:/usr/bin>, you can append
C</myapp/bin> by writing:
environment:
PATH: "::/myapp/bin"
After that, C<$PATH> will be set to C</bin:/usr/bin:/myapp/bin>. You
can prepend, too:
environment:
PATH: "/myapp/bin::"
which yields C</myapp/bin:/bin:/usr/bin>.
If you want a literal colon at the beginning or end of the environment
variable, escape it with a C<\>, like C<\:foo> or C<foo\:>. Note that
slashes aren't meaningful elsewhere, they're inserted verbatim into
the relevant environment variable.
=head1 EXPORT
A list of functions that can be exported. You can delete this section
if you don't export anything, such as for a purely object-oriented module.
=head1 FUNCTIONS
=head2 setup
Calls the other setup methods, and then sets the environment variables.
=cut
sub setup {
my $c = shift;
$c->next::method(@_);
my $env = $c->config->{environment};
return unless ref $env eq 'HASH';
foreach my $key (keys %$env){
my $value = $env->{$key};
if($value =~ /^:(.+)$/){
$ENV{$key} .= $1;
}
elsif($value =~ /^(.+[^\\]):$/){
$ENV{$key} = $1. $ENV{$key};
}
else {
$value =~ s/(^\\:|\\:$)/:/;
$value =~ s/(^\\\\:|\\\\:$)/\\:/;
$ENV{$key} = $value;
}
}
return;
}
=head1 AUTHOR
Jonathan Rockway, C<< <jrockway at cpan.org> >>
=head1 BUGS
=head2 Escaping
Things like "\:foo" can't be literally inserted into an environment
variable, due to my simplistic escaping scheme. Patches to fix this
(but not interpert C<\>s anywhere else) are welcome.
=head2 REPORTING
Please report any bugs or feature requests to
C<bug-catalyst-plugin-setenv at rt.cpan.org>, or through the web interface at
L<http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Catalyst-Plugin-Setenv>.
I will be notified, and then you'll automatically be notified of progress on
your bug as I make changes.
=head1 SUPPORT
You can find documentation for this module with the perldoc command.
perldoc Catalyst::Plugin::Setenv
You can also look for information at:
=over 4
=item * The Catalyst Website
L<http://www.catalystframework.org/>
=item * AnnoCPAN: Annotated CPAN documentation
L<http://annocpan.org/dist/Catalyst-Plugin-Setenv>
=item * CPAN Ratings
L<http://cpanratings.perl.org/d/Catalyst-Plugin-Setenv>
=item * RT: CPAN's request tracker
L<http://rt.cpan.org/NoAuth/Bugs.html?Dist=Catalyst-Plugin-Setenv>
=item * Search CPAN
L<http://search.cpan.org/dist/Catalyst-Plugin-Setenv>
=back
=head1 ACKNOWLEDGEMENTS
Thanks to Bill Moseley's message to the mailing list that prompted me
to write this.
=head1 COPYRIGHT & LICENSE
Copyright 2006 Jonathan Rockway, all rights reserved.
This program is free software; you can redistribute it and/or modify it
under the same terms as Perl itself.
=cut
1; # End of Catalyst::Plugin::Setenv
|