NAME
    Jifty::DBI - An object-relational mapper

DESCRIPTION

    This module provides an object-oriented mechanism for retrieving and
    updating data in a DBI-accesible database. 
    
    This module is the direct descendent of DBIx::SearchBuilder. If you're familiar
    with SearchBuilder, Jifty::DBI should be quite familiar to you.

    Jifty::DBI was forked from SearchBuilder to give us the opportunity to seriously
    clean up the API and internals without breaking existing applications.

INSTALLATION

    $ perl Makefile.PL
    $ make
    $ make test   # but see below for how to actually test against a test database
    # make install

TESTING

    In order to test most of the features of Jifty::DBI, you need
    to provide "make test" with a test database. For each DBI driver that
    you would like to test, set the environment variables "JDBI_TEST_FOO",
    "JDBI_TEST_FOO_USER", and "JDBI_TEST_FOO_PASS" to a database name, database
    username, and database password, where "FOO" is the driver name in all
    uppercase. You can test as many drivers as you like. (The appropriate
    "DBD::" module needs to be installed in order for the test to work.)
    Note that the "SQLite" driver will automatically be tested if
    "DBD::Sqlite" is installed, using a temporary file as the database. For
    example:

      JDBI_TEST_MYSQL=test JDBI_TEST_MYSQL_USER=root JDBI_TEST_MYSQL_PASS=foo \
        JDBI_TEST_PG=test JDBI_TEST_PG_USER=postgres  make test

AUTHOR
    Copyright (c) 2001-2005 Jesse Vincent, jesse@fsck.com.

    All rights reserved.

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