NAME

       Jifty::Handle -- A database handle class for Jifty

DESCRIPTION

       A wrapper around Jifty::DBI::Handle which is aware of versions in the database

METHODS

   new PARAMHASH
       This class method instantiates a new Jifty::Handle object. This object deals with database
       handles for the system.  After it is created, it will be a subclass of Jifty::DBI::Handle.

   canonical_database_name
       Returns the canonical name of the application's database (the actual name that will be
       given to the database driver).  This name is a lower-case version of the "Database"
       argument in the "Database" section of the framework config.

       For SQLite databases (where the database name is actually a filename), this also converts
       a relative path into an absolute path based at the application root.

   connect ARGS
       Like Jifty::DBI's connect method but pulls the name of the database from the current
       Jifty::Config.

   check_schema_version [pretend => 0|1]
       Make sure that we have a recent enough database schema.  If we don't, then error out.

       If "pretend =" 1> is passed, then any auto-upgrade action this might take is dry-run only.

   create_database MODE
       "MODE" is either "print" or "execute".

       This method either prints the commands necessary to create the database or actually
       creates it, depending on the value of MODE.  Returns undef on failure.

   drop_database MODE
       "MODE" is either "print" or "execute".

       This method either prints the commands necessary to drop the database or actually drops
       it, depending on the value of MODE.  Returns undef on failure.

AUTHOR

       Various folks at BestPractical Solutions, LLC.