Revision history for Perl extension DBIx::Connector.

0.52  2012-05-29T18:32:42Z
      - The DBI params are now encapsulated in a code reference, rather than
        stored as the passed array, so that the password is less likely to be
        displayed in a dump. Idea borrowed from Rose::DB. Patch from Brad
        Bowman.
      - Eliminated warning about the non-portability of a v-string on older
        Perls. Thanks to Mark Lawrence for the report (Issue #17).
      - Removed a couple of leftover examples of the `catch` feature removed
        in v0.50. Thanks to Randy Stauner for the patch!
      - Eliminated more "Use of qw(...) as parentheses" syntax errors in tests
        when running on Perl 5.17.
      - Add mention of DBI Callbacks parameter to the docs, as folks often ask
        for this functionality, not realizing that the DBI already provides
        it. Randy Stauner.

0.51  2012-02-18T00:14:48Z
      - Fixed internal exception handling on Perls less than 5.14, where some
        exceptions woult not be propagated to the caller.

0.50  2012-02-14T18:25:07Z
      - The `catch` functionality has been completely removed. Any `catch`
        block passed to `run()`, `txn()`, or `svp()` will be ignored. Errors
        will trigger fatal exceptions.
      - Removed the `with` method, which was deprecated in 0.34. Use `mode()`
        instead.
      - Fixed bad method call attempted when an `svp()` block failed. Thanks
        to Ricardo SIGNES for the regression test and the fix.
      - Fixed creation of the SQLite driver savepoint methods so that they
        exist and work even if the driver is loaded before DBD::SQLite. Thanks
        to Ricardo SIGNES for the regression test and the fix.

0.47  2011-09-26T17:12:07Z
      - Use of the deprecated `catch` functionality now warns on every call,
        rather than just the first call from a given caller.

0.46  2011-07-17T00:47:49
      - Eliminated "Use of qw(...) as parentheses is deprecated" warning in
        test when running on Perl 5.14.
      - Properly `local`ing `$$` in the `t/base.t` test so that it doesn't die
        on Perl 5.15. Thanks to Andreas J. Koenig for the report and diagnosis
        and to Nicholas Clark for the fix.
      - Duplicate paragraphs removed from `README.md` thanks to Ask Bjørn
        Hansen.
      - The `catch` functionality is deprecated. It will warn once for each
        caller to keep log verbosity down. In the next release, it will warn
        for every call. The release after that, it will be removed altogether.

0.45  2011-05-10T21:44:08
      - Fixed crash when `in_txn()` was called before an actual connection
        was established.
      - Strongly recommend setting `AutoCommit` to true in the documentation.
        Setting `AutoCommit` to false defeats the scoping behavior of `txn()`
        and therefore should not be used.
      - Nested exception handling now works properly in nested calls to
        `run()` in fixup mode and in nested calls to `txn()` in all modes.
        Thanks to Mark Lawrence for the report (RT #66974).

0.44  2011-03-20T01:04:59
      - Fixed bug with the MySQL driver introduced by the auto-reconnection
        fix in 0.43. Sorry for the lame mistake. [Lee Aylward]

0.43  2011-03-17T20:03:16
      - DBIx::Connector now sets the DBI `RaiseError` parameter to true in
        `new()` if neither it nor `HandleError` has been specified. This is to
        increase the likelihood that exception handling will be properly
        triggered in `run()`, `txn()`, and `svp()`. Documentation has also
        been added to emphasize the importance of setting `RaiseError` or
        `HandleError` appropriately.
      - Documented that `AutoInactiveDestroy` is set to true in `new()` if it
        is not specified. It's important tht this attribute be true in forking
        environments.
      - After connecting to the database, the MySQL driver,
        DBIx::Connector::Driver::mysql, now always sets the
        `mysql_auto_reconnect` attribute to false. This is to prevent MySQL's
        auto-reconnection feature from interfering with DBIx::Connector's
        auto-reconnection functionality in `fixup` mode. Thanks to Karen
        Etheridge and Peter Rabbitson for the report.
      - Removed mention of the use of the `catch` function from Try::Tiny,
        since it is no longer compatible to use passing the exception-handling
        function. Just using `catch =>` instead, which is cleaner-looking
        anyway (RT #65196).

0.42  2010-12-17T18:35:54
      - If a catch block died, the exception was not being propagated. That
        is, if a catch block threw an exception, DBIx::Connector ate it, and
        any calling code would not be able to catch it. This was a pretty
        serious bug; upgrading is strongly recommended for anyone using catch
        blocks.
      - When `run()`, `txn()`, or `svp()` was called recursively from within a
        second fixup execution, it was not respecting the fact that it was
        recursive and could try to start a transaction again. This happened
        *only* when a fixup run found that the database was disconnected and
        successfully re-connected, so it's a pretty rare condition.

0.41  2010-12-08T21:02:32
      - `connect()` no longer returns a disconnected database handle. Thanks
        to John Siracusa for the spot (Issue #6).
      - Added `disconnect_on_destroy()`, which can be used to disable
        disconnecting the database handle when the connector object is
        destroyed. Suggested by John Siracusa.

0.40  2010-09-17T18:44:01
      - The code refs passed to `run()`, `txn()`, and `svp()` now know their
        contexts, so that `wantarray` can be used to decide what to return.
        Patch from Yaroslav Korshak.
      - Set `AutoInactiveDestroy` on connect with DBI 1.614 and higher, unless
        it is explicitly set in the attributes. This makes things even safer
        in a forking environment, preventing a parent process from getting
        disconnected when a child exits without using the connection. The
        reports from Peter Rabbitson and Aran Deltac and subsequent discussion
        with Tim Bunce led to the addition of this attribute in DBI 1.614,
        which is now the recommended version of DBI.
      - `DESTROY()` no longer pings the database or rolls back transactions.
        It now simply calls `disconnect`. This avoids warnings during global
        destruction, and doesn't seem necessary anyway, as the DBI does these
        things during global destruction (and always has). Thanks to Matt
        Trout for the heads-up.
      - `DESTROY()` now clears `CachedKids`, following the precedent of
        DBIx::Class. May not be needed for recent-ish drivers, but seems
        harmless and it's nice to avoid warnings were possible. Reported by
        Matt Trout.
      - The `connected()` method no longer `local`ly sets `RaiseError`. It
        instead leaves that to the drivers (currenly only Driver::Oracle).
      - The exception classes `DBIx::Connector::TxnRollbackError` and
        `DBIx::Connector::SvpRollbackError` now use `our @ISA =` instead of
        `use base` to inherit from `DBIx::Connector::RollbackError. This is to
        avoid failures from mod_perl restarts. Suggested by Matt Trout.
      - Require Test::Pod 1.41 for POD tests so that `L<text|url>` is
        considered valid.

0.35 2010-06-04T00:32:02
      - Added a scoping block around the execution of the blocks passed to
        `run()`, `txn()`, and `svp()`. This prevents an app from exiting when
        a user returns from the block via the `next` or `last` keyword, which
        in turn prevented transaction management code from running. Thanks to
        Aran Deltac for the suggestion.
      - Added exception object for rollback failures. This is to keep rollback
        failures from completely swallowing up the underlying transaction
        failures.

0.34 2010-05-03T03:15:40
      - Added `mode()` attribute to control the default mode used by `run()`,
        `txn()`, and `svp()`.
      - Deprecated `with()`. Its use triggers a warning and it will be removed
        in a future version. Use `mode()` instead.

0.33  2010-03-31T22:56:07
      - A few useful documentation improvements, thanks to Quinn Weaver.
      - Added `in_txn()`, which returns true when the connection is in a
        transaction and false when it's not.

0.32  2010-02-22T20:15:50
      - Switched to using `FETCH()` and `STORE()` to get and set DBI
        attributes where possible. The primary reason is to avoid death during
        global destruction, when the DBI's `tie`d interface can sometimes be
        pulled out from under us. Switched to the OO interface througout to be
        consistent.

0.31  2009-11-09T01:54:52
      - Added missing version numbers to DBIx::Connector::Driver::SQLite
        and the proxy class used by `with()`.
      - Fixed orphaned references to DBIx::Connection to properly be
        DBIx::Connector.
      - Removed methods deprecated in 0.20: `do()`, `txn_do()`, `svp_do()`,
        and `clear_cache()`.
      - Some refactoring and code cleanup.
      - Some doc typos corrected by Robert Buels.
      - Fixed test failure on Win32.

0.30  2009-10-29T21:31:02
      - Compatibility change: Additional arguments to `run()`, `txn()`, and
        `svp()` are no longer passed on to the execution of the block, since
        they are immediately available to the closure, anyway. This simplifies
        things for integrated exception handling (next item).
      - Added integrated exception-handling support to `run()`, `txn()`, and
        `svp()`. Thanks to Mark Lawrence for the suggestion.
      - Removed the undocumented `savepoint()`, `release()`, and
        `rollback_to()` methods from DBIx::Connector, since those methods are
        in the drivers, and so were redundant.
      - Fixed the `author` section of `META.yml`.
      - `svp()` no longer throws an exception whe used with an RDBMS that
        doesn't support savepoints. In such situations, savepoints are treated
        as a no-op, and thus the transactional behavior of `svp()` becomes the
        same as `txn()`.
      - Moved up the discussion of calling `svp()` outside of a transaction in
        the documentation.

0.20  2009-10-20T22:33:00
      - Compatibility changes:
        + Added `run()`, `txn()`, and `svp()` as replacements for `do()`,
          `txn_do()`, and `svp_do()`. The latter will issue a warning when
          called, and be removed in two releases.
        + Eliminated caching and mod_perl special-casing.
      - Fixed the GitHub links for realz.
      - Updated minimum required Test::More to 0.88 so that testing classes
        with `isa_ok()` will work as expected. Thanks to mlawren for the spot.
      - Fixed bug passing arguments on retry in `txn()`. Thanks to [Mark
        Lawrence](http://github.com/mlawren) for the pull request.
      - Fixed a bug in `txn()` where it would fail to notify other blocks that
        it was running the block when the user started a transaction.
      - Changed `dbh()` so that it does not call `ping()` when it is called
        from within a code reference passed to a `run*()` method.
      - Made the docs with regard to the re-execution of a code reference
        passed to `run()` and friends in fixup mode more accurate, thanks to
        Tim Bunce.
      - Fetching a cached database handle now always checks its `Active`
        attribute as well as different process and thread IDs. The only thing
        not always done is `ping`ing the database.
      - Added `with()`.

0.12  2009-10-06T16:29:16
      - Fixed the GitHub links, which were still using the old name.
      - Removed `use feature` and `use utf8` from `t/pod-coverage.t` -- those
        were pastos from another project.
      - Removed `use DBD::SQLite` from DBix::Connector::Driver::SQLite. It
        will already have been loaded by the time that code loads.

0.11  2009-10-05T22:05:29
      - Filled in the important details in the README.
      - Changed name from DBIx::Connection to DBIx::Connector, as there is
        already a module called DBIx::Connection on the CPAN.

0.10  2009-10-05T21:16:03
      - Initial version, with code borrowed from DBIx::Class, Apache::DBI,
        Catalyst::Model::DBI, and various other locales.
