lots of Config::Any fixes, brought in C::Any testsuite (refactored, partly, from...

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

package Config::Any::XML;\r
\r
use strict;\r
use warnings;\r
\r
=head1 NAME\r
\r
Config::Any::XML - Load XML config files\r
\r
=head1 DESCRIPTION\r
\r
Loads XML files. Example:\r
\r
    <config>\r
        <name>TestApp</name>\r
        <component name="Controller::Foo">\r
            <foo>bar</foo>\r
        </component>\r
        <model name="Baz">\r
            <qux>xyzzy</qux>\r
        </model>\r
    </config>\r
\r
=head1 METHODS\r
\r
=head2 extensions( )\r
\r
return an array of valid extensions (C<xml>).\r
\r
=cut\r
\r
sub extensions {\r
    return qw( xml );\r
}\r
\r
=head2 load( $file )\r
\r
Attempts to load C<$file> as an XML file.\r
\r
=cut\r
\r
sub load {\r
    my $class = shift;\r
    my $file  = shift;\r
\r
    require XML::Simple;\r
    XML::Simple->import;\r
    my $config = XMLin( \r
		$file, \r
		ForceArray => [ qw( component model view controller ) ],\r
	);\r
\r
	return $class->_coerce($config);\r
}\r
\r
sub _coerce {\r
	# coerce the XML-parsed config into the correct format\r
	my $class = shift;\r
	my $config = shift;\r
	my $out;\r
	for my $k (keys %$config) {\r
		my $ref = $config->{$k};\r
		my $name = ref $ref ? delete $ref->{name} : undef;\r
		if (defined $name) {\r
			$out->{$k}->{$name} = $ref;	\r
		} else {\r
			$out->{$k} = $ref;\r
		}\r
	}\r
	$out;\r
}\r
\r
=head1 AUTHOR\r
\r
=over 4 \r
\r
=item * Brian Cassidy E<lt>bricas@cpan.orgE<gt>\r
\r
=item * Joel Bernstein E<lt>rataxis@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<XML::Simple>\r
\r
=back\r
\r
=cut\r
\r
1;\r