NAME

       Test::Database::Handle - A class for Test::Database handles

SYNOPSIS

           use Test::Database;

           my $handle = Test::Database->handle(@requests);
           my $dbh    = $handle->dbh();

DESCRIPTION

       "Test::Database::Handle" is a very simple class for encapsulating the information about a test database
       handle.

       "Test::Database::Handle" objects are used within a test script to obtain the necessary information about
       a test database handle.  Handles are obtained through the "Test::Database->handles()" or
       "Test::Database->handle()" methods.

METHODS

       "Test::Database::Handle" provides the following methods:

       new( %args )
           Return a new "Test::Database::Handle" with the given parameters ("dsn", "username", "password").

           The only mandatory argument is "dsn".

       The following accessors are available.

       dsn()
           Return the Data Source Name.

       username()
           Return the connection username.

       password()
           Return the connection password.

       connection_info()
           Return the connection information triplet ("dsn", "username", "password").

       dbh( [ $attr ] )
           Return  the  DBI  database  handle  obtained  when connecting with the connection triplet returned by
           "connection_info()".

           The optional parameter $attr is a reference to a hash of connection attributes,  passed  directly  to
           DBI's "connect()" method.

       name()
           Return the database name attached to the handle.

       dbd()
           Return the DBI driver name, as computed from the "dsn".

       driver()
           Return the "Test::Database::Driver" object attached to the handle.

AUTHOR

       Philippe Bruhat (BooK), "<book@cpan.org>"

COPYRIGHT

       Copyright 2008-2010 Philippe Bruhat (BooK), all rights reserved.

LICENSE

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

perl v5.14.2                                       2013-06-16                        Test::Database::Handle(3pm)