updated pod + tests

[catagits/Catalyst-Plugin-ConfigLoader.git] / lib / Catalyst / Plugin / ConfigLoader / JSON.pm

package Catalyst::Plugin::ConfigLoader::JSON;\r
\r
use strict;\r
use warnings;\r
\r
=head1 NAME\r
\r
Catalyst::Plugin::ConfigLoader::JSON - Load JSON config files\r
\r
=head1 DESCRIPTION\r
\r
Loads JSON files. Example:\r
\r
    {\r
        "name": "TestApp",\r
        "Controller::Foo": {\r
            "foo": "bar"\r
        },\r
        "Model::Baz": {\r
            "qux": "xyzzy"\r
        }\r
    }\r
\r
=head1 METHODS\r
\r
=head2 extensions( )\r
\r
return an array of valid extensions (C<json>, C<jsn>).\r
\r
=cut\r
\r
sub extensions {\r
    return qw( json jsn );\r
}\r
\r
=head2 load( $file )\r
\r
Attempts to load C<$file> as a JSON file.\r
\r
=cut\r
\r
sub load {\r
    my $class = shift;\r
    my $file  = shift;\r
\r
    open( my $fh, $file ) or die $!;\r
    my $content = do { local $/; <$fh> };\r
    close $fh;\r
\r
    eval { require JSON::Syck; };\r
    if( $@ ) {\r
        require JSON;\r
        JSON->import;\r
        return jsonToObj( $content );\r
    }\r
    else {\r
        return JSON::Syck::Load( $content );\r
    }\r
}\r
\r
=head1 AUTHOR\r
\r
=over 4 \r
\r
=item * Brian Cassidy E<lt>bricas@cpan.orgE<gt>\r
\r
=back\r
\r
=head1 COPYRIGHT AND LICENSE\r
\r
Copyright 2006 by Brian Cassidy\r
\r
This library is free software; you can redistribute it and/or modify\r
it under the same terms as Perl itself. \r
\r
=head1 SEE ALSO\r
\r
=over 4 \r
\r
=item * L<Catalyst>\r
\r
=item * L<Catalyst::Plugin::ConfigLoader>\r
\r
=item * L<JSON>\r
\r
=item * L<JSON::Syck>\r
\r
=back\r
\r
=cut\r
\r
1;