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       <http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Catalyst-Plugin-
70       Setenv>.  I will be notified, and then you'll automatically be notified
71       of progress on your bug as I make changes.
72

SUPPORT

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

ACKNOWLEDGEMENTS

105       Thanks to Bill Moseley's message to the mailing list that prompted me
106       to write this.
107

109       Copyright 2006 Jonathan Rockway, all rights reserved.
110
111       This program is free software; you can redistribute it and/or modify it
112       under the same terms as Perl itself.
113
114
115
116perl v5.12.0                      2010-05-08       Catalyst::Plugin::Setenv(3)
Impressum