NAME

Config::MySQL::Reader - Read MySQL-style configuration files

VERSION

Version 0.01

SYNOPSIS

If my.cnf contains

    [mysqld]
    datadir=/var/lib/mysql
    skip-locking
    [mysqldump]
    quick
    max_allowed_packet = 16M
    !include /etc/my_other.cnf
    !include /etc/my_extra.cnf

Then when your program contains

    my $config = Config::MySQL::Reader->read_file('my.cnf');

$config will contain

    {
        '_' => {
            '!include' => [
                '/etc/my_other.cnf',
                '/etc/my_extra.cnf',
            ],
        },
        'mysqld' => {
            'datadir'      => '/var/lib/mysql',
            'skip-locking' => undef,
        },
        'mysqldump' => {
            'quick'              => undef,
            'max_allowed_packet' => '16M',
        },
    }

DECSRIPTION

This module extends Config::INI::Reader to support reading MySQL-style configuration files. Although deceptively similar to standard ".INI" files, they can include bare boolean options with no value assignment and additional features like "!include" and "!includedir".

"Config::MySQL::Reader" does not read files included by the "!include" and "!includedir" directives, but does preserve the directives so that you can safely read, modify, and re-write configuration files without losing them. If you need to read the contents of included files, you may want to look at Config::Extend::MySQL which handles this automatically (but does not handle roundtripping).

METHODS FOR READING CONFIG

OVERRIDDEN METHODS

SEE ALSO

Config::INI

MySQL::Config

Config::Extend::MySQL

AUTHOR

Iain Arnell, "<iarnell at gmail.com>"

BUGS

Please report any bugs or feature requests to "bug-config-ini-mysql at rt.cpan.org", or through the web interface at <http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Config-MySQL>. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

SUPPORT

You can find documentation for this module with the perldoc command.

    perldoc Config::MySQL::Reader

You can also look for information at:

• RT: CPAN's request tracker

  <http://rt.cpan.org/NoAuth/Bugs.html?Dist=Config-MySQL>

• AnnoCPAN: Annotated CPAN documentation

  <http://annocpan.org/dist/Config-MySQL>

• CPAN Ratings

  <http://cpanratings.perl.org/d/Config-MySQL>

• Search CPAN

  <http://search.cpan.org/dist/Config-MySQL/>

ACKNOWLEDGEMENTS

Thanks to Ricardo Signes for Config-INI.

COPYRIGHT & LICENSE

Copyright 2010 Iain Arnell.

This program is free software; you can redistribute it and/or modify it under the terms of either: the GNU General Public License as published by the Free Software Foundation; or the Artistic License.

See http://dev.perl.org/licenses/ for more information.