Changes

Release history for DBIx-Connector

0.60  Mon 21 Oct 2024
      - MariaDB support (Issue #50)
      - Fix for leaking $@ from driver constructor (Issue #51)
      - Fix for swallowing driver compile errors

0.59  Sun 02 Jul 2023
      - Fix for Windows t/load.t failures

0.58  Mon 29 Aug 2022
      - No functional changes
      - Updated packaging and package metadata

0.57  Mon 27 Sep 2021
      - `$conn->dsn` and `$conn->driver_name` accessors
      - Use of ExtUtils::MakeMaker instead of Module::Build
      - Corrected, reduced, properly declared prerequisites
      - POD tests in `xt/`
      - Simplified SQLite version check
      - Doc typo fix. Thanks to Michael R. Davis

0.56  Wed 16 Mar 2016
      - Added Firebird support, thanks to Stefan Suciu.
      - Fixed SQLite savepoint support to properly detect SQlite versions 3.9
        and higher.
      - Restored MySQL savepoint testing when the DBICTEST_* environment
        variables are set.

0.55  Fri 05 Feb 2016
      - Added versions to the RollbackError exception classes to make PAUSE
        happy.

0.54  Fri 05 Feb 2016
      - Removeed the Pod tests from the distribution.
      - Fixed the example code for handling `rollback_error` exceptions in the
        documentation to properly wrap the transaction in an exception
        handler. Patch from Perlover (issue #32).
      - Improved handling of connection failures when RaiseError (or
        HandleError) is not set. Thanks to Andreas Huber for the report and
        fix.
      - Document that `$_` is set locally, not globally, in the methods that
        set it. Suggested by William Lindley.
      - The disconnect method no longer longer remove entries from the DBI
        handle's CachedKids attribute. That behavior appears to be a
        workaround for a database we don't (yet) support.
      - Fixed a test failure where the test system has the `$DBI_DSN` or
        `$DBI_DRIVER` environment variable set. Thanks to Erik Rijkers for the
        patch.
      - Added recommendation to use DBD::Pg 3.5.0 or later to the Pg driver.
        Earlier versions had an incorrect implementation of the `ping()`
        method (Issue #41).

0.53  Wed 20 Mar 2013
      - Fixed some documentation typos, thanks to Mike O'Regan (Issue #22).
      - Fixed issue where an connection failure caused an unhelpful error
        (Issue #26).

0.52  Tue 29 May 2012
      - 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  Sat 18 Feb 2012
      - Fixed internal exception handling on Perls less than 5.14, where some
        exceptions woult not be propagated to the caller.

0.50  Tue 14 Feb 2012
      - 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  Mon 26 Sep 2011
      - Use of the deprecated `catch` functionality now warns on every call,
        rather than just the first call from a given caller.

0.46  Sun 17 Jul 2011
      - 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  Tue 10 May 2011
      - 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  Sun 20 Mar 2011
      - Fixed bug with the MySQL driver introduced by the auto-reconnection
        fix in 0.43. Sorry for the lame mistake. [Lee Aylward]

0.43  Thu 17 Mar 2011
      - 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  Fri 17 Dec 2010
      - 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  Wed 08 Dec 2010
      - `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  Fri 17 Sep 2010
      - 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  Fri 04 Jun 2010
      - 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  Mon 03 May 2010
      - 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  Wed 31 Mar 2010
      - 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  Mon 22 Feb 2010
      - 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  Mon 09 Nov 2009
      - 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  Thu 29 Oct 2009
      - 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  Tue 20 Oct 2009
      - 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  Tue 06 Oct 2009
      - 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  Mon 05 Oct 2009
      - 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  Mon 05 Oct 2009
      - Initial version, with code borrowed from DBIx::Class, Apache::DBI,
        Catalyst::Model::DBI, and various other locales.