1dd1499e50b6defa6e025d4654f41d048ccff8d2
[p5sagit/Config-Any.git] / lib / Config / Any / Perl.pm
1 package Config::Any::Perl;
2
3 use strict;
4 use warnings;
5
6 my %cache;
7
8 =head1 NAME
9
10 Config::Any::Perl - Load Perl config files
11
12 =head1 DESCRIPTION
13
14 Loads Perl files. Example:
15
16     {
17         name => 'TestApp',
18         'Controller::Foo' => {
19             foo => 'bar'
20         },
21         'Model::Baz' => {
22             qux => 'xyzzy'
23         }
24     }
25
26 =head1 METHODS
27
28 =head2 extensions( )
29
30 return an array of valid extensions (C<pl>, C<perl>).
31
32 =cut
33
34 sub extensions {
35     return qw( pl perl );
36 }
37
38 =head2 load( $file )
39
40 Attempts to load C<$file> as a Perl file.
41
42 =cut
43
44 sub load {
45     my $class = shift;
46     my $file  = shift;
47     my $content;
48
49     unless( $content = $cache{ $file } ) {
50         $content = eval { require $file };
51         $cache{ $file } = $content;
52     }
53
54     return $content;
55 }
56
57 =head1 AUTHOR
58
59 =over 4 
60
61 =item * Brian Cassidy E<lt>bricas@cpan.orgE<gt>
62
63 =back
64
65 =head1 COPYRIGHT AND LICENSE
66
67 Copyright 2006 by Brian Cassidy
68
69 This library is free software; you can redistribute it and/or modify
70 it under the same terms as Perl itself. 
71
72 =head1 SEE ALSO
73
74 =over 4 
75
76 =item * L<Catalyst>
77
78 =item * L<Config::Any>
79
80 =back
81
82 =cut
83
84 1;