refactor _load(). fix an issue with use_ext => 0. use_ext now on by default. throw...
[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 Brian Cassidy E<lt>bricas@cpan.orgE<gt>
60
61 =head1 COPYRIGHT AND LICENSE
62
63 Copyright 2007 by Brian Cassidy
64
65 This library is free software; you can redistribute it and/or modify
66 it under the same terms as Perl itself. 
67
68 =head1 SEE ALSO
69
70 =over 4 
71
72 =item * L<Catalyst>
73
74 =item * L<Config::Any>
75
76 =back
77
78 =cut
79
80 1;