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