Initial import of Config::Any (refactored from Catalyst::Plugin::ConfigLoader), and...

[p5sagit/Config-Any.git] / lib / Config / Any / INI.pm

package Config::Any::INI;\r
\r
use strict;\r
use warnings;\r
\r
=head1 NAME\r
\r
Config::Any::INI - Load INI config files\r
\r
=head1 DESCRIPTION\r
\r
Loads INI files. Example:\r
\r
    name=TestApp\r
    \r
    [Controller::Foo]\r
    foo=bar\r
    \r
    [Model::Baz]\r
    qux=xyzzy\r
\r
=head1 METHODS\r
\r
=head2 extensions( )\r
\r
return an array of valid extensions (C<ini>).\r
\r
=cut\r
\r
sub extensions {\r
    return qw( ini );\r
}\r
\r
=head2 load( $file )\r
\r
Attempts to load C<$file> as an INI file.\r
\r
=cut\r
\r
sub load {\r
    my $class = shift;\r
    my $file  = shift;\r
\r
    require Config::Tiny;\r
    my $config = Config::Tiny->read( $file );\r
    my $main   = delete $config->{ _ };\r
    \r
    $config->{ $_ } = $main->{ $_ } for keys %$main;\r
\r
    return $config;\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<Config::Any>\r
\r
=item * L<Config::Tiny>\r
\r
=back\r
\r
=cut\r
\r
1;