NAME
     DBIx::Wrapper::Config -  Config Module for DBIx::Wrapper

SYNOPSIS
     use DBIx::Wrapper::Config;

     my $dbh = DBIx::Wrapper::Config->connect($db_key, $conf_path, \%dbix_wrapper_attrs);

DESCRIPTION
     This module allows you to create a configuration file in XML
     specifying information required to connect to databases using
     DBIx::Wrapper.  This way you can keep your database connection
     specifications in one place.  Each "db" element specifies a
     key/name for the database connection, which should be passed as
     the $db_key argument to connect() in order to connect to that
     database.  The "db" element's children specify the dsn,
     authentication, and attribute information.

        <?xml version="1.0" encoding="iso-8859-1"?>
        <config>
          <db name="test_db_key">
            <dsn>dbi:mysql:database=test_db;host=example.com;port=3306</dsn>

            <!-- You can also use attributes to specify each part of the
                 dsn separately.
             -->
            <!-- <dsn driver="mysql" database="test_db" host="example.com" port="3306"/> -->

            <user>test_user</user>
            <password>test_pwd</password>

            <!-- attributes to pass to DBIx::Wrapper (and ultimately to DBI) -->
            <attribute name="RaiseError" value="0"/>
            <attribute name="PrintError" value="1"/>
          </db>

          <db name="test_db_key2">
            <dsn driver="mysql" database="test_db" host="test.example.com" port="3306"/>

            <user>test_user</user>
            <password>test_pwd</password>

            <attribute name="RaiseError" value="0"/>
            <attribute name="PrintError" value="1"/>
          </db>

        </config>

  connect($db_key, $conf_path, \%dbix_wrapper_attrs)
     Return a DBIx::Wrapper object connected to the database
     specified by $db_key in the file at $conf_path.
     %dbix_wrapper_attrs is the optional 5th argument to
     DBIx::Wrapper's connect() method, specifying handlers, etc.

     The file specified by $conf_path should be in the format
     specified in the DESCRIPTION section of this document.

EXAMPLES
DEPENDENCIES
    DBIx::Wrapper, XML::Parser::Wrapper

AUTHOR
    Don Owens <don@owensnet.com>

LICENSE AND COPYRIGHT
    Copyright (c) 2005 Don Owens <don@owensnet.com>. All rights reserved.

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

    This program is distributed in the hope that it will be useful, but
    WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

SEE ALSO
     DBIx::Wrapper, DBI

VERSION
     0.01

