| 1 |
Release history for DBIx-Connector |
| 2 |
|
| 3 |
0.60 Mon 21 Oct 2024 |
| 4 |
- MariaDB support (Issue #50) |
| 5 |
- Fix for leaking $@ from driver constructor (Issue #51) |
| 6 |
- Fix for swallowing driver compile errors |
| 7 |
|
| 8 |
0.59 Sun 02 Jul 2023 |
| 9 |
- Fix for Windows t/load.t failures |
| 10 |
|
| 11 |
0.58 Mon 29 Aug 2022 |
| 12 |
- No functional changes |
| 13 |
- Updated packaging and package metadata |
| 14 |
|
| 15 |
0.57 Mon 27 Sep 2021 |
| 16 |
- `$conn->dsn` and `$conn->driver_name` accessors |
| 17 |
- Use of ExtUtils::MakeMaker instead of Module::Build |
| 18 |
- Corrected, reduced, properly declared prerequisites |
| 19 |
- POD tests in `xt/` |
| 20 |
- Simplified SQLite version check |
| 21 |
- Doc typo fix. Thanks to Michael R. Davis |
| 22 |
|
| 23 |
0.56 Wed 16 Mar 2016 |
| 24 |
- Added Firebird support, thanks to Stefan Suciu. |
| 25 |
- Fixed SQLite savepoint support to properly detect SQlite versions 3.9 |
| 26 |
and higher. |
| 27 |
- Restored MySQL savepoint testing when the DBICTEST_* environment |
| 28 |
variables are set. |
| 29 |
|
| 30 |
0.55 Fri 05 Feb 2016 |
| 31 |
- Added versions to the RollbackError exception classes to make PAUSE |
| 32 |
happy. |
| 33 |
|
| 34 |
0.54 Fri 05 Feb 2016 |
| 35 |
- Removeed the Pod tests from the distribution. |
| 36 |
- Fixed the example code for handling `rollback_error` exceptions in the |
| 37 |
documentation to properly wrap the transaction in an exception |
| 38 |
handler. Patch from Perlover (issue #32). |
| 39 |
- Improved handling of connection failures when RaiseError (or |
| 40 |
HandleError) is not set. Thanks to Andreas Huber for the report and |
| 41 |
fix. |
| 42 |
- Document that `$_` is set locally, not globally, in the methods that |
| 43 |
set it. Suggested by William Lindley. |
| 44 |
- The disconnect method no longer longer remove entries from the DBI |
| 45 |
handle's CachedKids attribute. That behavior appears to be a |
| 46 |
workaround for a database we don't (yet) support. |
| 47 |
- Fixed a test failure where the test system has the `$DBI_DSN` or |
| 48 |
`$DBI_DRIVER` environment variable set. Thanks to Erik Rijkers for the |
| 49 |
patch. |
| 50 |
- Added recommendation to use DBD::Pg 3.5.0 or later to the Pg driver. |
| 51 |
Earlier versions had an incorrect implementation of the `ping()` |
| 52 |
method (Issue #41). |
| 53 |
|
| 54 |
0.53 Wed 20 Mar 2013 |
| 55 |
- Fixed some documentation typos, thanks to Mike O'Regan (Issue #22). |
| 56 |
- Fixed issue where an connection failure caused an unhelpful error |
| 57 |
(Issue #26). |
| 58 |
|
| 59 |
0.52 Tue 29 May 2012 |
| 60 |
- The DBI params are now encapsulated in a code reference, rather than |
| 61 |
stored as the passed array, so that the password is less likely to be |
| 62 |
displayed in a dump. Idea borrowed from Rose::DB. Patch from Brad |
| 63 |
Bowman. |
| 64 |
- Eliminated warning about the non-portability of a v-string on older |
| 65 |
Perls. Thanks to Mark Lawrence for the report (Issue #17). |
| 66 |
- Removed a couple of leftover examples of the `catch` feature removed |
| 67 |
in v0.50. Thanks to Randy Stauner for the patch! |
| 68 |
- Eliminated more "Use of qw(...) as parentheses" syntax errors in tests |
| 69 |
when running on Perl 5.17. |
| 70 |
- Add mention of DBI Callbacks parameter to the docs, as folks often ask |
| 71 |
for this functionality, not realizing that the DBI already provides |
| 72 |
it. Randy Stauner. |
| 73 |
|
| 74 |
0.51 Sat 18 Feb 2012 |
| 75 |
- Fixed internal exception handling on Perls less than 5.14, where some |
| 76 |
exceptions woult not be propagated to the caller. |
| 77 |
|
| 78 |
0.50 Tue 14 Feb 2012 |
| 79 |
- The `catch` functionality has been completely removed. Any `catch` |
| 80 |
block passed to `run()`, `txn()`, or `svp()` will be ignored. Errors |
| 81 |
will trigger fatal exceptions. |
| 82 |
- Removed the `with` method, which was deprecated in 0.34. Use `mode()` |
| 83 |
instead. |
| 84 |
- Fixed bad method call attempted when an `svp()` block failed. Thanks |
| 85 |
to Ricardo SIGNES for the regression test and the fix. |
| 86 |
- Fixed creation of the SQLite driver savepoint methods so that they |
| 87 |
exist and work even if the driver is loaded before DBD::SQLite. Thanks |
| 88 |
to Ricardo SIGNES for the regression test and the fix. |
| 89 |
|
| 90 |
0.47 Mon 26 Sep 2011 |
| 91 |
- Use of the deprecated `catch` functionality now warns on every call, |
| 92 |
rather than just the first call from a given caller. |
| 93 |
|
| 94 |
0.46 Sun 17 Jul 2011 |
| 95 |
- Eliminated "Use of qw(...) as parentheses is deprecated" warning in |
| 96 |
test when running on Perl 5.14. |
| 97 |
- Properly `local`ing `$$` in the `t/base.t` test so that it doesn't die |
| 98 |
on Perl 5.15. Thanks to Andreas J. Koenig for the report and diagnosis |
| 99 |
and to Nicholas Clark for the fix. |
| 100 |
- Duplicate paragraphs removed from `README.md` thanks to Ask Bjørn |
| 101 |
Hansen. |
| 102 |
- The `catch` functionality is deprecated. It will warn once for each |
| 103 |
caller to keep log verbosity down. In the next release, it will warn |
| 104 |
for every call. The release after that, it will be removed altogether. |
| 105 |
|
| 106 |
0.45 Tue 10 May 2011 |
| 107 |
- Fixed crash when `in_txn()` was called before an actual connection |
| 108 |
was established. |
| 109 |
- Strongly recommend setting `AutoCommit` to true in the documentation. |
| 110 |
Setting `AutoCommit` to false defeats the scoping behavior of `txn()` |
| 111 |
and therefore should not be used. |
| 112 |
- Nested exception handling now works properly in nested calls to |
| 113 |
`run()` in fixup mode and in nested calls to `txn()` in all modes. |
| 114 |
Thanks to Mark Lawrence for the report (RT #66974). |
| 115 |
|
| 116 |
0.44 Sun 20 Mar 2011 |
| 117 |
- Fixed bug with the MySQL driver introduced by the auto-reconnection |
| 118 |
fix in 0.43. Sorry for the lame mistake. [Lee Aylward] |
| 119 |
|
| 120 |
0.43 Thu 17 Mar 2011 |
| 121 |
- DBIx::Connector now sets the DBI `RaiseError` parameter to true in |
| 122 |
`new()` if neither it nor `HandleError` has been specified. This is to |
| 123 |
increase the likelihood that exception handling will be properly |
| 124 |
triggered in `run()`, `txn()`, and `svp()`. Documentation has also |
| 125 |
been added to emphasize the importance of setting `RaiseError` or |
| 126 |
`HandleError` appropriately. |
| 127 |
- Documented that `AutoInactiveDestroy` is set to true in `new()` if it |
| 128 |
is not specified. It's important tht this attribute be true in forking |
| 129 |
environments. |
| 130 |
- After connecting to the database, the MySQL driver, |
| 131 |
DBIx::Connector::Driver::mysql, now always sets the |
| 132 |
`mysql_auto_reconnect` attribute to false. This is to prevent MySQL's |
| 133 |
auto-reconnection feature from interfering with DBIx::Connector's |
| 134 |
auto-reconnection functionality in `fixup` mode. Thanks to Karen |
| 135 |
Etheridge and Peter Rabbitson for the report. |
| 136 |
- Removed mention of the use of the `catch` function from Try::Tiny, |
| 137 |
since it is no longer compatible to use passing the exception-handling |
| 138 |
function. Just using `catch =>` instead, which is cleaner-looking |
| 139 |
anyway (RT #65196). |
| 140 |
|
| 141 |
0.42 Fri 17 Dec 2010 |
| 142 |
- If a catch block died, the exception was not being propagated. That |
| 143 |
is, if a catch block threw an exception, DBIx::Connector ate it, and |
| 144 |
any calling code would not be able to catch it. This was a pretty |
| 145 |
serious bug; upgrading is strongly recommended for anyone using catch |
| 146 |
blocks. |
| 147 |
- When `run()`, `txn()`, or `svp()` was called recursively from within a |
| 148 |
second fixup execution, it was not respecting the fact that it was |
| 149 |
recursive and could try to start a transaction again. This happened |
| 150 |
*only* when a fixup run found that the database was disconnected and |
| 151 |
successfully re-connected, so it's a pretty rare condition. |
| 152 |
|
| 153 |
0.41 Wed 08 Dec 2010 |
| 154 |
- `connect()` no longer returns a disconnected database handle. Thanks |
| 155 |
to John Siracusa for the spot (Issue #6). |
| 156 |
- Added `disconnect_on_destroy()`, which can be used to disable |
| 157 |
disconnecting the database handle when the connector object is |
| 158 |
destroyed. Suggested by John Siracusa. |
| 159 |
|
| 160 |
0.40 Fri 17 Sep 2010 |
| 161 |
- The code refs passed to `run()`, `txn()`, and `svp()` now know their |
| 162 |
contexts, so that `wantarray` can be used to decide what to return. |
| 163 |
Patch from Yaroslav Korshak. |
| 164 |
- Set `AutoInactiveDestroy` on connect with DBI 1.614 and higher, unless |
| 165 |
it is explicitly set in the attributes. This makes things even safer |
| 166 |
in a forking environment, preventing a parent process from getting |
| 167 |
disconnected when a child exits without using the connection. The |
| 168 |
reports from Peter Rabbitson and Aran Deltac and subsequent discussion |
| 169 |
with Tim Bunce led to the addition of this attribute in DBI 1.614, |
| 170 |
which is now the recommended version of DBI. |
| 171 |
- `DESTROY()` no longer pings the database or rolls back transactions. |
| 172 |
It now simply calls `disconnect`. This avoids warnings during global |
| 173 |
destruction, and doesn't seem necessary anyway, as the DBI does these |
| 174 |
things during global destruction (and always has). Thanks to Matt |
| 175 |
Trout for the heads-up. |
| 176 |
- `DESTROY()` now clears `CachedKids`, following the precedent of |
| 177 |
DBIx::Class. May not be needed for recent-ish drivers, but seems |
| 178 |
harmless and it's nice to avoid warnings were possible. Reported by |
| 179 |
Matt Trout. |
| 180 |
- The `connected()` method no longer `local`ly sets `RaiseError`. It |
| 181 |
instead leaves that to the drivers (currenly only Driver::Oracle). |
| 182 |
- The exception classes `DBIx::Connector::TxnRollbackError` and |
| 183 |
`DBIx::Connector::SvpRollbackError` now use `our @ISA =` instead of |
| 184 |
`use base` to inherit from `DBIx::Connector::RollbackError. This is to |
| 185 |
avoid failures from mod_perl restarts. Suggested by Matt Trout. |
| 186 |
- Require Test::Pod 1.41 for POD tests so that `L<text|url>` is |
| 187 |
considered valid. |
| 188 |
|
| 189 |
0.35 Fri 04 Jun 2010 |
| 190 |
- Added a scoping block around the execution of the blocks passed to |
| 191 |
`run()`, `txn()`, and `svp()`. This prevents an app from exiting when |
| 192 |
a user returns from the block via the `next` or `last` keyword, which |
| 193 |
in turn prevented transaction management code from running. Thanks to |
| 194 |
Aran Deltac for the suggestion. |
| 195 |
- Added exception object for rollback failures. This is to keep rollback |
| 196 |
failures from completely swallowing up the underlying transaction |
| 197 |
failures. |
| 198 |
|
| 199 |
0.34 Mon 03 May 2010 |
| 200 |
- Added `mode()` attribute to control the default mode used by `run()`, |
| 201 |
`txn()`, and `svp()`. |
| 202 |
- Deprecated `with()`. Its use triggers a warning and it will be removed |
| 203 |
in a future version. Use `mode()` instead. |
| 204 |
|
| 205 |
0.33 Wed 31 Mar 2010 |
| 206 |
- A few useful documentation improvements, thanks to Quinn Weaver. |
| 207 |
- Added `in_txn()`, which returns true when the connection is in a |
| 208 |
transaction and false when it's not. |
| 209 |
|
| 210 |
0.32 Mon 22 Feb 2010 |
| 211 |
- Switched to using `FETCH()` and `STORE()` to get and set DBI |
| 212 |
attributes where possible. The primary reason is to avoid death during |
| 213 |
global destruction, when the DBI's `tie`d interface can sometimes be |
| 214 |
pulled out from under us. Switched to the OO interface througout to be |
| 215 |
consistent. |
| 216 |
|
| 217 |
0.31 Mon 09 Nov 2009 |
| 218 |
- Added missing version numbers to DBIx::Connector::Driver::SQLite |
| 219 |
and the proxy class used by `with()`. |
| 220 |
- Fixed orphaned references to DBIx::Connection to properly be |
| 221 |
DBIx::Connector. |
| 222 |
- Removed methods deprecated in 0.20: `do()`, `txn_do()`, `svp_do()`, |
| 223 |
and `clear_cache()`. |
| 224 |
- Some refactoring and code cleanup. |
| 225 |
- Some doc typos corrected by Robert Buels. |
| 226 |
- Fixed test failure on Win32. |
| 227 |
|
| 228 |
0.30 Thu 29 Oct 2009 |
| 229 |
- Compatibility change: Additional arguments to `run()`, `txn()`, and |
| 230 |
`svp()` are no longer passed on to the execution of the block, since |
| 231 |
they are immediately available to the closure, anyway. This simplifies |
| 232 |
things for integrated exception handling (next item). |
| 233 |
- Added integrated exception-handling support to `run()`, `txn()`, and |
| 234 |
`svp()`. Thanks to Mark Lawrence for the suggestion. |
| 235 |
- Removed the undocumented `savepoint()`, `release()`, and |
| 236 |
`rollback_to()` methods from DBIx::Connector, since those methods are |
| 237 |
in the drivers, and so were redundant. |
| 238 |
- Fixed the `author` section of `META.yml`. |
| 239 |
- `svp()` no longer throws an exception whe used with an RDBMS that |
| 240 |
doesn't support savepoints. In such situations, savepoints are treated |
| 241 |
as a no-op, and thus the transactional behavior of `svp()` becomes the |
| 242 |
same as `txn()`. |
| 243 |
- Moved up the discussion of calling `svp()` outside of a transaction in |
| 244 |
the documentation. |
| 245 |
|
| 246 |
0.20 Tue 20 Oct 2009 |
| 247 |
- Compatibility changes: |
| 248 |
+ Added `run()`, `txn()`, and `svp()` as replacements for `do()`, |
| 249 |
`txn_do()`, and `svp_do()`. The latter will issue a warning when |
| 250 |
called, and be removed in two releases. |
| 251 |
+ Eliminated caching and mod_perl special-casing. |
| 252 |
- Fixed the GitHub links for realz. |
| 253 |
- Updated minimum required Test::More to 0.88 so that testing classes |
| 254 |
with `isa_ok()` will work as expected. Thanks to mlawren for the spot. |
| 255 |
- Fixed bug passing arguments on retry in `txn()`. Thanks to [Mark |
| 256 |
Lawrence](http://github.com/mlawren) for the pull request. |
| 257 |
- Fixed a bug in `txn()` where it would fail to notify other blocks that |
| 258 |
it was running the block when the user started a transaction. |
| 259 |
- Changed `dbh()` so that it does not call `ping()` when it is called |
| 260 |
from within a code reference passed to a `run*()` method. |
| 261 |
- Made the docs with regard to the re-execution of a code reference |
| 262 |
passed to `run()` and friends in fixup mode more accurate, thanks to |
| 263 |
Tim Bunce. |
| 264 |
- Fetching a cached database handle now always checks its `Active` |
| 265 |
attribute as well as different process and thread IDs. The only thing |
| 266 |
not always done is `ping`ing the database. |
| 267 |
- Added `with()`. |
| 268 |
|
| 269 |
0.12 Tue 06 Oct 2009 |
| 270 |
- Fixed the GitHub links, which were still using the old name. |
| 271 |
- Removed `use feature` and `use utf8` from `t/pod-coverage.t` -- those |
| 272 |
were pastos from another project. |
| 273 |
- Removed `use DBD::SQLite` from DBix::Connector::Driver::SQLite. It |
| 274 |
will already have been loaded by the time that code loads. |
| 275 |
|
| 276 |
0.11 Mon 05 Oct 2009 |
| 277 |
- Filled in the important details in the README. |
| 278 |
- Changed name from DBIx::Connection to DBIx::Connector, as there is |
| 279 |
already a module called DBIx::Connection on the CPAN. |
| 280 |
|
| 281 |
0.10 Mon 05 Oct 2009 |
| 282 |
- Initial version, with code borrowed from DBIx::Class, Apache::DBI, |
| 283 |
Catalyst::Model::DBI, and various other locales. |