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

package Config::Any;

use strict;
use warnings;

use Carp;
use Module::Pluggable::Object ();

our $VERSION = '0.10';

=head1 NAME

Config::Any - Load configuration from different file formats, transparently

=head1 VERSION

This document describes Config::Any version 0.09_02

=head1 SYNOPSIS

    use Config::Any;

    my $cfg = Config::Any->load_stems({stems => \@filepath_stems, ... });
    # or
    my $cfg = Config::Any->load_files({files => \@filepaths, ... });

    for (@$cfg) {
        my ($filename, $config) = %$_;
        $class->config($config);
        warn "loaded config from file: $filename";
    }

=head1 DESCRIPTION

L<Config::Any|Config::Any> provides a facility for Perl applications and libraries
to load configuration data from multiple different file formats. It supports XML, YAML,
JSON, Apache-style configuration, Windows INI files, and even Perl code.

The rationale for this module is as follows: Perl programs are deployed on many different
platforms and integrated with many different systems. Systems administrators and end 
users may prefer different configuration formats than the developers. The flexibility
inherent in a multiple format configuration loader allows different users to make 
different choices, without generating extra work for the developers. As a developer
you only need to learn a single interface to be able to use the power of different
configuration formats.

=head1 INTERFACE 

=cut

=head2 load_files( \%args )

    Config::Any->load_files( { files => \@files } );
    Config::Any->load_files( { files => \@files, filter  => \&filter } );
    Config::Any->load_files( { files => \@files, use_ext => 1 } );

C<load_files()> attempts to load configuration from the list of files passed in
the C<files> parameter, if the file exists.

If the C<filter> parameter is set, it is used as a callback to modify the configuration 
data before it is returned. It will be passed a single hash-reference parameter which 
it should modify in-place.

If the C<use_ext> parameter is defined, the loader will attempt to parse the file
extension from each filename and will skip the file unless it matches a standard
extension for the loading plugins. Only plugins whose standard extensions match the
file extension will be used. For efficiency reasons, its use is encouraged, but
be aware that you will lose flexibility -- for example, a file called C<myapp.cfg> 
containing YAML data will not be offered to the YAML plugin, whereas C<myapp.yml>
or C<myapp.yaml> would be.

C<load_files()> also supports a 'force_plugins' parameter, whose value should be an
arrayref of plugin names like C<Config::Any::INI>. Its intended use is to allow the use 
of a non-standard file extension while forcing it to be offered to a particular parser.
It is not compatible with 'use_ext'. 

You can supply a C<driver_args> hashref to pass special options to a particular
parser object. Example:

    Config::Any->load_files( { files => \@files, driver_args => {
        General => { -LowerCaseNames => 1 }
    } )

=cut

sub load_files {
    my ( $class, $args ) = @_;

    unless ( $args && exists $args->{ files } ) {
        warn "No files specified!";
        return;
    }

    return $class->_load( $args );
}

=head2 load_stems( \%args )

    Config::Any->load_stems( { stems => \@stems } );
    Config::Any->load_stems( { stems => \@stems, filter  => \&filter } );
    Config::Any->load_stems( { stems => \@stems, use_ext => 1 } );

C<load_stems()> attempts to load configuration from a list of files which it generates
by combining the filename stems list passed in the C<stems> parameter with the 
potential filename extensions from each loader, which you can check with the
C<extensions()> classmethod described below. Once this list of possible filenames is
built it is treated exactly as in C<load_files()> above, as which it takes the same
parameters. Please read the C<load_files()> documentation before using this method.

=cut

sub load_stems {
    my ( $class, $args ) = @_;

    unless ( $args && exists $args->{ stems } ) {
        warn "No stems specified!";
        return;
    }

    my $stems = delete $args->{ stems };
    my @files;
    for my $s ( @$stems ) {
        for my $ext ( $class->extensions ) {
            push @files, "$s.$ext";
        }
    }

    $args->{ files } = \@files;
    return $class->_load( $args );
}

sub _load {
    my ( $class, $args ) = @_;
    croak "_load requires a arrayref of file paths" unless $args->{ files };

    my $force = defined $args->{ force_plugins };
    if ( !$force and !defined $args->{ use_ext } ) {
        warn
            "use_ext argument was not explicitly set, as of 0.09, this is true by default";
        $args->{ use_ext } = 1;
    }

    # figure out what plugins we're using
    my @plugins = $force ? @{ $args->{ force_plugins } } : $class->plugins;

    # map extensions if we have to
    my ( %extension_lut, $extension_re );
    my $use_ext_lut = !$force && $args->{ use_ext };
    if ( $use_ext_lut ) {
        for my $plugin ( @plugins ) {
            $extension_lut{ $_ } = $plugin for $plugin->extensions;
        }

        $extension_re = join( '|', keys %extension_lut );
    }

    # map args to plugins
    my $base_class = __PACKAGE__;
    my %loader_args;
    for my $plugin ( @plugins ) {
        $plugin =~ m{^$base_class\::(.+)};
        $loader_args{ $plugin } = $args->{ driver_args }->{ $1 } || {};
    }

    my @results;

    for my $filename ( @{ $args->{ files } } ) {

        # don't even bother if it's not there
        next unless -f $filename;

        my @try_plugins = @plugins;

        if ( $use_ext_lut ) {
            $filename =~ m{\.($extension_re)\z};
            next unless $1;
            @try_plugins = $extension_lut{ $1 };
        }

        for my $loader ( @try_plugins ) {
            next unless $loader->is_supported;
            my @configs
                = eval { $loader->load( $filename, $loader_args{ $loader } ); };

            # fatal error if we used extension matching
            croak "Error parsing file: $filename" if $@ and $use_ext_lut;
            next if $@ or !@configs;

            # post-process config with a filter callback
            if ( $args->{ filter } ) {
                $args->{ filter }->( $_ ) for @configs;
            }

            push @results,
                { $filename => @configs == 1 ? $configs[ 0 ] : \@configs };
            last;
        }
    }

    return \@results;
}

=head2 finder( )

The C<finder()> classmethod returns the 
L<Module::Pluggable::Object|Module::Pluggable::Object>
object which is used to load the plugins. See the documentation for that module for
more information.

=cut

sub finder {
    my $class  = shift;
    my $finder = Module::Pluggable::Object->new(
        search_path => [ __PACKAGE__ ],
        require     => 1
    );
    return $finder;
}

=head2 plugins( )

The C<plugins()> classmethod returns the names of configuration loading plugins as 
found by L<Module::Pluggable::Object|Module::Pluggable::Object>.

=cut

sub plugins {
    my $class = shift;
    return $class->finder->plugins;
}

=head2 extensions( )

The C<extensions()> classmethod returns the possible file extensions which can be loaded
by C<load_stems()> and C<load_files()>. This may be useful if you set the C<use_ext>
parameter to those methods.

=cut

sub extensions {
    my $class = shift;
    my @ext = map { $_->extensions } $class->plugins;
    return wantarray ? @ext : \@ext;
}

=head1 DIAGNOSTICS

=over

=item C<No files specified!> or C<No stems specified!>

The C<load_files()> and C<load_stems()> methods will issue this warning if
called with an empty list of files/stems to load.

=item C<_load requires a arrayref of file paths>

This fatal error will be thrown by the internal C<_load> method. It should not occur
but is specified here for completeness. If your code dies with this error, please
email a failing test case to the authors below.

=back

=head1 CONFIGURATION AND ENVIRONMENT

Config::Any requires no configuration files or environment variables.

=head1 DEPENDENCIES

L<Module::Pluggable|Module::Pluggable>

And at least one of the following:
L<Config::General|Config::General>
L<Config::Tiny|Config::Tiny>
L<JSON|JSON>
L<YAML|YAML>
L<JSON::Syck|JSON::Syck>
L<YAML::Syck|YAML::Syck>
L<XML::Simple|XML::Simple>

=head1 INCOMPATIBILITIES

None reported.

=head1 BUGS AND LIMITATIONS

No bugs have been reported.

Please report any bugs or feature requests to
C<bug-config-any@rt.cpan.org>, or through the web interface at
L<http://rt.cpan.org>.

=head1 AUTHOR

Joel Bernstein  E<lt>rataxis@cpan.orgE<gt>

=head1 CONTRIBUTORS

This module was based on the original 
L<Catalyst::Plugin::ConfigLoader|Catalyst::Plugin::ConfigLoader>
module by Brian Cassidy C<< <bricas@cpan.org> >>.

With ideas and support from Matt S Trout C<< <mst@shadowcatsystems.co.uk> >>.

Further enhancements suggested by Evan Kaufman C<< <evank@cpan.org> >>.

=head1 LICENCE AND COPYRIGHT

Copyright (c) 2006, Portugal Telecom C<< http://www.sapo.pt/ >>. All rights reserved.
Portions copyright 2007, Joel Bernstein C<< <rataxis@cpan.org> >>.

This module is free software; you can redistribute it and/or
modify it under the same terms as Perl itself. See L<perlartistic>.

=head1 DISCLAIMER OF WARRANTY

BECAUSE THIS SOFTWARE IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
FOR THE SOFTWARE, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN
OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
PROVIDE THE SOFTWARE "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER
EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE
ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE SOFTWARE IS WITH
YOU. SHOULD THE SOFTWARE PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL
NECESSARY SERVICING, REPAIR, OR CORRECTION.

IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR
REDISTRIBUTE THE SOFTWARE AS PERMITTED BY THE ABOVE LICENCE, BE
LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL,
OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE
THE SOFTWARE (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING
RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A
FAILURE OF THE SOFTWARE TO OPERATE WITH ANY OTHER SOFTWARE), EVEN IF
SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF
SUCH DAMAGES.

=head1 SEE ALSO

L<Catalyst::Plugin::ConfigLoader|Catalyst::Plugin::ConfigLoader> 
-- now a wrapper around this module.

=cut

"Drink more beer";
Commit	Line	Data
c80a0905	1	package Config::Any;
92a04e78	2
c80a0905	3	use strict;
92a04e78	4	use warnings;
92a04e78	5
c80a0905	6	use Carp;
c80a0905	7	use Module::Pluggable::Object ();
59a80452	8
af9773e2	9	our $VERSION = '0.10';
c80a0905	10
59a80452	11	=head1 NAME
	12
	13	Config::Any - Load configuration from different file formats, transparently
	14
	15	=head1 VERSION
	16
48e4a267	17	This document describes Config::Any version 0.09_02
59a80452	18
	19	=head1 SYNOPSIS
	20
	21	use Config::Any;
	22
f0e3c221	23	my $cfg = Config::Any->load_stems({stems => \@filepath_stems, ... });
	24	# or
	25	my $cfg = Config::Any->load_files({files => \@filepaths, ... });
59a80452	26
f0e3c221	27	for (@$cfg) {
0c6989c6	28	my ($filename, $config) = %$_;
f0e3c221	29	$class->config($config);
	30	warn "loaded config from file: $filename";
	31	}
59a80452	32
	33	=head1 DESCRIPTION
	34
	35	L<Config::Any\|Config::Any> provides a facility for Perl applications and libraries
	36	to load configuration data from multiple different file formats. It supports XML, YAML,
	37	JSON, Apache-style configuration, Windows INI files, and even Perl code.
	38
	39	The rationale for this module is as follows: Perl programs are deployed on many different
	40	platforms and integrated with many different systems. Systems administrators and end
	41	users may prefer different configuration formats than the developers. The flexibility
	42	inherent in a multiple format configuration loader allows different users to make
	43	different choices, without generating extra work for the developers. As a developer
	44	you only need to learn a single interface to be able to use the power of different
	45	configuration formats.
	46
	47	=head1 INTERFACE
	48
	49	=cut
	50
7c218182	51	=head2 load_files( \%args )
59a80452	52
4efab558	53	Config::Any->load_files( { files => \@files } );
	54	Config::Any->load_files( { files => \@files, filter => \&filter } );
	55	Config::Any->load_files( { files => \@files, use_ext => 1 } );
59a80452	56
	57	C<load_files()> attempts to load configuration from the list of files passed in
	58	the C<files> parameter, if the file exists.
	59
	60	If the C<filter> parameter is set, it is used as a callback to modify the configuration
	61	data before it is returned. It will be passed a single hash-reference parameter which
	62	it should modify in-place.
	63
	64	If the C<use_ext> parameter is defined, the loader will attempt to parse the file
	65	extension from each filename and will skip the file unless it matches a standard
	66	extension for the loading plugins. Only plugins whose standard extensions match the
	67	file extension will be used. For efficiency reasons, its use is encouraged, but
	68	be aware that you will lose flexibility -- for example, a file called C<myapp.cfg>
	69	containing YAML data will not be offered to the YAML plugin, whereas C<myapp.yml>
	70	or C<myapp.yaml> would be.
	71
41f47406	72	C<load_files()> also supports a 'force_plugins' parameter, whose value should be an
	73	arrayref of plugin names like C<Config::Any::INI>. Its intended use is to allow the use
	74	of a non-standard file extension while forcing it to be offered to a particular parser.
	75	It is not compatible with 'use_ext'.
	76
ef87b7dc	77	You can supply a C<driver_args> hashref to pass special options to a particular
	78	parser object. Example:
	79
	80	Config::Any->load_files( { files => \@files, driver_args => {
	81	General => { -LowerCaseNames => 1 }
	82	} )
	83
59a80452	84	=cut
59a80452	85
c80a0905	86	sub load_files {
92a04e78	87	my ( $class, $args ) = @_;
4efab558	88
	89	unless ( $args && exists $args->{ files } ) {
	90	warn "No files specified!";
59a80452	91	return;
	92	}
	93
4efab558	94	return $class->_load( $args );
c80a0905	95	}
c80a0905	96
7c218182	97	=head2 load_stems( \%args )
59a80452	98
bef9e9a5	99	Config::Any->load_stems( { stems => \@stems } );
	100	Config::Any->load_stems( { stems => \@stems, filter => \&filter } );
	101	Config::Any->load_stems( { stems => \@stems, use_ext => 1 } );
59a80452	102
	103	C<load_stems()> attempts to load configuration from a list of files which it generates
	104	by combining the filename stems list passed in the C<stems> parameter with the
	105	potential filename extensions from each loader, which you can check with the
	106	C<extensions()> classmethod described below. Once this list of possible filenames is
	107	built it is treated exactly as in C<load_files()> above, as which it takes the same
	108	parameters. Please read the C<load_files()> documentation before using this method.
	109
	110	=cut
	111
c80a0905	112	sub load_stems {
92a04e78	113	my ( $class, $args ) = @_;
bef9e9a5	114
	115	unless ( $args && exists $args->{ stems } ) {
	116	warn "No stems specified!";
59a80452	117	return;
59a80452	118	}
92a04e78	119
bef9e9a5	120	my $stems = delete $args->{ stems };
c80a0905	121	my @files;
92a04e78	122	for my $s ( @$stems ) {
92a04e78	123	for my $ext ( $class->extensions ) {
4efab558	124	push @files, "$s.$ext";
c80a0905	125	}
c80a0905	126	}
c80a0905	127
bef9e9a5	128	$args->{ files } = \@files;
	129	return $class->_load( $args );
	130	}
41f47406	131
c80a0905	132	sub _load {
92a04e78	133	my ( $class, $args ) = @_;
a918b0b8	134	croak "_load requires a arrayref of file paths" unless $args->{ files };
a918b0b8	135
c84f1613	136	my $force = defined $args->{ force_plugins };
c84f1613	137	if ( !$force and !defined $args->{ use_ext } ) {
72628dc7	138	warn
72628dc7	139	"use_ext argument was not explicitly set, as of 0.09, this is true by default";
a918b0b8	140	$args->{ use_ext } = 1;
	141	}
	142
	143	# figure out what plugins we're using
ade8c46e	144	my @plugins = $force ? @{ $args->{ force_plugins } } : $class->plugins;
a918b0b8	145
a918b0b8	146	# map extensions if we have to
72628dc7	147	my ( %extension_lut, $extension_re );
a918b0b8	148	my $use_ext_lut = !$force && $args->{ use_ext };
72628dc7	149	if ( $use_ext_lut ) {
a918b0b8	150	for my $plugin ( @plugins ) {
	151	$extension_lut{ $_ } = $plugin for $plugin->extensions;
	152	}
	153
	154	$extension_re = join( '\|', keys %extension_lut );
	155	}
59a80452	156
a918b0b8	157	# map args to plugins
	158	my $base_class = __PACKAGE__;
	159	my %loader_args;
	160	for my $plugin ( @plugins ) {
	161	$plugin =~ m{^$base_class\::(.+)};
	162	$loader_args{ $plugin } = $args->{ driver_args }->{ $1 } \|\| {};
	163	}
	164
	165	my @results;
	166
	167	for my $filename ( @{ $args->{ files } } ) {
72628dc7	168
a918b0b8	169	# don't even bother if it's not there
	170	next unless -f $filename;
	171
	172	my @try_plugins = @plugins;
41f47406	173
72628dc7	174	if ( $use_ext_lut ) {
a918b0b8	175	$filename =~ m{\.($extension_re)\z};
	176	next unless $1;
	177	@try_plugins = $extension_lut{ $1 };
	178	}
	179
	180	for my $loader ( @try_plugins ) {
ade8c46e	181	next unless $loader->is_supported;
72628dc7	182	my @configs
72628dc7	183	= eval { $loader->load( $filename, $loader_args{ $loader } ); };
41f47406	184
a918b0b8	185	# fatal error if we used extension matching
	186	croak "Error parsing file: $filename" if $@ and $use_ext_lut;
	187	next if $@ or !@configs;
	188
	189	# post-process config with a filter callback
	190	if ( $args->{ filter } ) {
	191	$args->{ filter }->( $_ ) for @configs;
	192	}
41f47406	193
72628dc7	194	push @results,
72628dc7	195	{ $filename => @configs == 1 ? $configs[ 0 ] : \@configs };
a918b0b8	196	last;
c80a0905	197	}
c80a0905	198	}
7c218182	199
a918b0b8	200	return \@results;
c80a0905	201	}
c80a0905	202
59a80452	203	=head2 finder( )
	204
	205	The C<finder()> classmethod returns the
	206	L<Module::Pluggable::Object\|Module::Pluggable::Object>
	207	object which is used to load the plugins. See the documentation for that module for
	208	more information.
	209
	210	=cut
	211
c80a0905	212	sub finder {
92a04e78	213	my $class = shift;
c80a0905	214	my $finder = Module::Pluggable::Object->new(
	215	search_path => [ __PACKAGE__ ],
	216	require => 1
	217	);
bef9e9a5	218	return $finder;
c80a0905	219	}
c80a0905	220
59a80452	221	=head2 plugins( )
	222
	223	The C<plugins()> classmethod returns the names of configuration loading plugins as
	224	found by L<Module::Pluggable::Object\|Module::Pluggable::Object>.
	225
	226	=cut
	227
c80a0905	228	sub plugins {
	229	my $class = shift;
	230	return $class->finder->plugins;
	231	}
	232
59a80452	233	=head2 extensions( )
c80a0905	234
59a80452	235	The C<extensions()> classmethod returns the possible file extensions which can be loaded
	236	by C<load_stems()> and C<load_files()>. This may be useful if you set the C<use_ext>
	237	parameter to those methods.
c80a0905	238
59a80452	239	=cut
c80a0905	240
59a80452	241	sub extensions {
	242	my $class = shift;
	243	my @ext = map { $_->extensions } $class->plugins;
4efab558	244	return wantarray ? @ext : \@ext;
59a80452	245	}
c80a0905	246
	247	=head1 DIAGNOSTICS
	248
c80a0905	249	=over
c80a0905	250
7c218182	251	=item C<No files specified!> or C<No stems specified!>
c80a0905	252
59a80452	253	The C<load_files()> and C<load_stems()> methods will issue this warning if
59a80452	254	called with an empty list of files/stems to load.
c80a0905	255
59a80452	256	=item C<_load requires a arrayref of file paths>
c80a0905	257
59a80452	258	This fatal error will be thrown by the internal C<_load> method. It should not occur
	259	but is specified here for completeness. If your code dies with this error, please
	260	email a failing test case to the authors below.
c80a0905	261
	262	=back
	263
c80a0905	264	=head1 CONFIGURATION AND ENVIRONMENT
c80a0905	265
c80a0905	266	Config::Any requires no configuration files or environment variables.
c80a0905	267
c80a0905	268	=head1 DEPENDENCIES
c80a0905	269
59a80452	270	L<Module::Pluggable\|Module::Pluggable>
c80a0905	271
59a80452	272	And at least one of the following:
	273	L<Config::General\|Config::General>
	274	L<Config::Tiny\|Config::Tiny>
	275	L<JSON\|JSON>
	276	L<YAML\|YAML>
	277	L<JSON::Syck\|JSON::Syck>
	278	L<YAML::Syck\|YAML::Syck>
	279	L<XML::Simple\|XML::Simple>
c80a0905	280
	281	=head1 INCOMPATIBILITIES
	282
c80a0905	283	None reported.
c80a0905	284
c80a0905	285	=head1 BUGS AND LIMITATIONS
c80a0905	286
c80a0905	287	No bugs have been reported.
	288
	289	Please report any bugs or feature requests to
	290	C<bug-config-any@rt.cpan.org>, or through the web interface at
	291	L<http://rt.cpan.org>.
	292
c80a0905	293	=head1 AUTHOR
c80a0905	294
f0e3c221	295	Joel Bernstein E<lt>rataxis@cpan.orgE<gt>
c80a0905	296
59a80452	297	=head1 CONTRIBUTORS
	298
	299	This module was based on the original
	300	L<Catalyst::Plugin::ConfigLoader\|Catalyst::Plugin::ConfigLoader>
	301	module by Brian Cassidy C<< <bricas@cpan.org> >>.
	302
	303	With ideas and support from Matt S Trout C<< <mst@shadowcatsystems.co.uk> >>.
c80a0905	304
41f47406	305	Further enhancements suggested by Evan Kaufman C<< <evank@cpan.org> >>.
41f47406	306
c80a0905	307	=head1 LICENCE AND COPYRIGHT
	308
	309	Copyright (c) 2006, Portugal Telecom C<< http://www.sapo.pt/ >>. All rights reserved.
41f47406	310	Portions copyright 2007, Joel Bernstein C<< <rataxis@cpan.org> >>.
c80a0905	311
	312	This module is free software; you can redistribute it and/or
	313	modify it under the same terms as Perl itself. See L<perlartistic>.
	314
c80a0905	315	=head1 DISCLAIMER OF WARRANTY
	316
	317	BECAUSE THIS SOFTWARE IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
	318	FOR THE SOFTWARE, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN
	319	OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
	320	PROVIDE THE SOFTWARE "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER
	321	EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
	322	WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE
	323	ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE SOFTWARE IS WITH
	324	YOU. SHOULD THE SOFTWARE PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL
	325	NECESSARY SERVICING, REPAIR, OR CORRECTION.
	326
	327	IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
	328	WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR
	329	REDISTRIBUTE THE SOFTWARE AS PERMITTED BY THE ABOVE LICENCE, BE
	330	LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL,
	331	OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE
	332	THE SOFTWARE (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING
	333	RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A
	334	FAILURE OF THE SOFTWARE TO OPERATE WITH ANY OTHER SOFTWARE), EVEN IF
	335	SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF
	336	SUCH DAMAGES.
59a80452	337
	338	=head1 SEE ALSO
	339
	340	L<Catalyst::Plugin::ConfigLoader\|Catalyst::Plugin::ConfigLoader>
	341	-- now a wrapper around this module.
	342
	343	=cut
	344
41f47406	345	"Drink more beer";