1Catalyst::Plugin::SetenUvs(e3r)Contributed Perl DocumentCaattiaolnyst::Plugin::Setenv(3)
2
3
4

NAME

6       Catalyst::Plugin::Setenv - Allows you to set up the environment from
7       Catalyst's config file.
8

VERSION

10       Version 0.03
11

SYNOPSIS

13       In your application:
14
15           use Catalyst qw/Setenv/;
16
17       In your config file:
18
19           environment:
20             FOO: bar
21             BAR: baz
22
23       When your app starts, $ENV{FOO} will be "bar", and $ENV{BAR} will be
24       "baz".
25
26       You can also append and prepend to existing environment variables.  For
27       example, if $PATH is "/bin:/usr/bin", you can append "/myapp/bin" by
28       writing:
29
30          environment:
31            PATH: "::/myapp/bin"
32
33       After that, $PATH will be set to "/bin:/usr/bin:/myapp/bin".  You can
34       prepend, too:
35
36          environment:
37            PATH: "/myapp/bin::"
38
39       which yields "/myapp/bin:/bin:/usr/bin".
40
41       If you want a literal colon at the beginning or end of the environment
42       variable, escape it with a "\", like "\:foo" or "foo\:".  Note that
43       slashes aren't meaningful elsewhere, they're inserted verbatim into the
44       relevant environment variable.
45

EXPORT

47       A list of functions that can be exported.  You can delete this section
48       if you don't export anything, such as for a purely object-oriented
49       module.
50

FUNCTIONS

52   setup
53       Calls the other setup methods, and then sets the environment variables.
54

AUTHOR

56       Jonathan Rockway, "<jrockway at cpan.org>"
57

BUGS

59   Escaping
60       Things like "\:foo" can't be literally inserted into an environment
61       variable, due to my simplistic escaping scheme.  Patches to fix this
62       (but not interpert "\"s anywhere else) are welcome.
63
64   REPORTING
65       Please report any bugs or feature requests to
66       "bug-catalyst-plugin-setenv at rt.cpan.org", or through the web
67       interface at
68       <http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Catalyst-Plugin-Setenv>.
69       I will be notified, and then you'll automatically be notified of
70       progress on your bug as I make changes.
71

SUPPORT

73       You can find documentation for this module with the perldoc command.
74
75           perldoc Catalyst::Plugin::Setenv
76
77       You can also look for information at:
78
79       •   The Catalyst Website
80
81           <http://www.catalystframework.org/>
82
83       •   AnnoCPAN: Annotated CPAN documentation
84
85           <http://annocpan.org/dist/Catalyst-Plugin-Setenv>
86
87       •   CPAN Ratings
88
89           <http://cpanratings.perl.org/d/Catalyst-Plugin-Setenv>
90
91       •   RT: CPAN's request tracker
92
93           <http://rt.cpan.org/NoAuth/Bugs.html?Dist=Catalyst-Plugin-Setenv>
94
95       •   Search CPAN
96
97           <http://search.cpan.org/dist/Catalyst-Plugin-Setenv>
98

ACKNOWLEDGEMENTS

100       Thanks to Bill Moseley's message to the mailing list that prompted me
101       to write this.
102
104       Copyright 2006 Jonathan Rockway, all rights reserved.
105
106       This program is free software; you can redistribute it and/or modify it
107       under the same terms as Perl itself.
108
109
110
111perl v5.34.0                      2022-01-21       Catalyst::Plugin::Setenv(3)
Impressum