54128dce6f0024cc7464911f4ff1a174eb72c58b
[dbsrgits/DBM-Deep.git] / Changes
1 Revision history for DBM::Deep.
2
3 1.0002 Sep ?? ??:??:?? 2007 EDT
4     - Expanded _throw_error() so that it provides better information.
5       (Thanks brian d foy!)
6
7 1.0001 Mar 12 16:15:00 2007 EDT
8     - (This version is compatible with 1.0000)
9     - Added a missing dependency on IO::Scalar (RT #25387)
10     - Fixed how t/44_upgrade_db.t and utils/upgrade_db.pl worked
11       - utils/upgrade_db.pl now uses #!perl, not #!/usr/bin/perl
12       - t/44_upgrade_db.t now explicitly calls $^X
13         (Thanks merlyn!)
14
15 1.0000 Feb 26 22:30:00 2007 EST
16     - THIS VERSION IS INCOMPATIBLE WITH FILES FROM ALL OTHER PRIOR VERSIONS.
17       - To aid in this form of upgrades, DBM::Deep now checks the file format
18         version to make sure that it knows how to read it.
19       - db_upgrade.pl was added to utils/. This will -NOT- install onto
20         your system. This is deliberate.
21       - db_upgrade.pl will not handle developer release file formats. This
22         is due to the fact that all developer releases in preparation for a
23         given release share the same file version, even though the file
24         format may change. This is deliberate.
25     - Importing no longer takes place within a transaction
26     - The following parameters were added:
27       - data_sector_size - this determines the default size of a data sector.
28     - Correctly handle opening readonly files
29
30 0.99_04 Jan 24 22:30:00 2007 EST
31     - Added the missing lib/DBM/Deep.pod file to the MANIFEST
32     - Fixed a poorly-designed test that was failing depending on what Clone::Any
33       was using.
34     - All "use 5.6.0;" lines are now "use 5.006_000;" to avoid warnings about
35       unsupported vstrings in 5.9.x
36
37 0.99_03 Jan 23 22:30:00 2007 EST
38     - THIS VERSION IS INCOMPATIBLE WITH FILES FROM ALL OTHER PRIOR VERSIONS.
39       - The fileformat changed completely. I will be writing a converter, but
40         it's not there right now. Do NOT expect that this module will
41         correctly detect older versions and handle them sanely. Sanity will be
42         there for 1.00, but we're not there yet, are we?
43     - Converted to use FileHandle::Fmode to handle filehandle status checks
44     - Fixed bug with deleting already-deleted items on Win32 (reported by Nigel Sandever)
45     - The guts of how transactions work has been rewritten to better handle
46       some edgecases. This required a complete rewrite of the engine.
47     - Freespace management is now in place. It's not perfect, but it's there.
48     - The rewrite of the engine required a rewrite of how first_key/next_key
49       was implemented. This should result in significant speed improvements.
50     - Self-reference has been removed. This means you cannot do:
51           $db->{foo} = { x => 'y' };
52           $db->{bar} = $db->{foo};
53       I hope to be able to return this functionality by 1.00, but I cannot
54       promise anything. To do this properly, it requires refcounting in order
55       to correctly handle deletions and transactions. Once you move away from
56       a simple tree, everything becomes really hard.
57
58 0.99_02 Apr 28 05:00:00 2006 Pacific
59     - Added missing file to the MANIFEST
60
61 0.99_01 Apr 27 18:00:00 2006 Pacific
62     - Added explicit dependency on Perl 5.6.0
63       - Digest::MD5 requires 5.6.0
64       - Sub::Uplevel (dep of Test::Exception) requires 5.6.0
65     - Removed error()/clear_error()
66       - All error-handling is done with die()
67     - Broke out DBM::Deep's code into DBM::Deep::Engine
68     - Tied variables can no longer be assigned to a DBM::Deep object.
69       - This includes cross-file assignments.
70     - Autovivification now works
71       - This is a consequence of the fact that all assignments are tied.
72     - set_pack() and set_digest() have been removed.
73       - Instead, you will now pass the appropriate values into new()
74       - A pack_size parameter has been added to make 64-bit files easier
75     - Transactions now work
76
77 0.983 Apr 10 20:00:00 2006 Pacific
78     - Added patch inspired by Jeff Janes (Thanks!)
79       - Autovivification now works correctly
80       - The following now works correctly
81         my %hash = ( a => 1 );
82         $db->{hash} = \%hash;
83         $hash{b} = 2;
84         cmp_ok( $db->{hash}{b}, '==', 2 );
85     - (RT#18530) - DBM::Deep now plays nicely with -l
86
87 0.982 Mar 08 11:00:00 2006 Pacific
88     - Fixed smoketests that were failing on Win32
89     - Added restriction for Perl 5.6.0 or higher.
90       - Digest::MD5 and Sub::Uplevel (dep of Test::Exception) require 5.6+
91
92 0.981 Mar 06 11:00:00 2006 Pacific
93     - (RT#17947) - Fixed test that was failing on older Perls
94
95 0.98  Feb 28 11:00:00 2006 Pacific
96     - Added in patch by David Cantrell to allow use of DATA filehandle
97     - Fixed bug where attempting to export() a structure that used autobless would die
98     - Fixed arraytest slowness by localizing $SIG{__DIE__} to prevent Test::Builder's
99       $SIG{__DIE__} from being called. (q.v. http://perldoc.perl.org/functions/eval.html)
100     - More methods have been made private:
101         - root() is now _root()
102         - base_offset() is now _base_offset()
103         - fh() is now _fh()
104         - type() is now _type()
105         - precalc_sizes() is now _precalc_sizes()
106
107 0.97  Feb 24 10:00:00 2006 Pacific
108     - Reorganization of distribution to a more standard layout
109     - Migration to Module::Build with EU::MM backwards compatibility
110     - Migration of all tests to use Test::More and Test::Exception
111     - Added Devel::Cover report to DBM::Deep POD
112       - Test coverage improved to 89.6% (and climbing)
113     - The following methods have been renamed to reflect their private nature:
114         - init() is now _init()
115         - open() is now _open()
116         - close() is now _close()
117         - load_tag() is now _load_tag()
118         - index_lookup() is now _index_lookup()
119         - add_bucket() is now _add_bucket()
120         - get_bucket_value() is now _get_bucket_value()
121         - delete_bucket() is now _delete_bucket()
122         - bucket_exists() is now _bucket_exists()
123         - find_bucket_list() is now _find_bucket_list()
124         - traverse_index() is now _traverse_index()
125         - get_next_key() is now _get_next_key()
126         - copy_node() is now _copy_node()
127         - throw_error() is now _throw_error()
128     - The various tied classes have been broken out. This means that testing
129         "ref( $obj ) eq 'DBM::Deep'" will now fail. The correct test is
130         "eval { $obj->isa( 'DBM::Deep' ) }".
131     - The various methods like push and delete now have the same return values as
132       the standard builtins.
133     - TIEARRAY and TIEHASH now check their parameters more thoroughly
134     - Negative indices for arrays works as expected, including throwing the appropriate
135       errors.
136     - RT #16877 is fixed (DBM::Deep broken with Perl 5.9.3+).
137     - RT #14893 is fixed (tie() and new() use different parameter lists).
138     - A bug with optimize and threading is fixed.
139     - autobless has received some attention, resulting in a number of bugs fixed.
140     - Removed mode option as it just caused confusion.
141     - Removed volatile option as it is pretty useless (use locking instead)
142     - Locking now implicitly enables autoflush
143
144 0.96  Oct 14 09:55:00 2005 Pacific
145     - Fixed build (OS X hidden files killed it)
146     - You can now pass in an optional filehandle to the constructor
147
148 0.95  Oct 12 13:58:00 2005 Pacific
149     - Added optional autobless flag to preserve and restore blessed hashes
150     - Fixed bug where 0 could not be fetched using get_next_key
151     - Fixed bug where tie() constructor didn't accept a hash ref for args
152     - optimize() now preserves user/group/permissions
153     - Errors are now FATAL (meaning it calls die()), unless you set debug flag
154
155 0.94  Apr 13 19:00:26 2004 Pacific
156     - Fixed bug reported by John Cardenas (corruption at key level when
157          replace of less data was done on bucket)
158
159 0.93  Feb 15 19:53:17 2004 Pacific
160     - Fixed optmize() on Win32 where orig file couldn't be overwritten unless
161          filehandle was closed first.  This change introduces a potential race
162          condition when using locking and optmize() on Win32, but it can be 
163          fixed in the future using a soft copy instead of Perl's rename().
164
165 0.92  Feb 12 19:10:22 2004 Pacific
166     - Fixed bug where passing a reference to a different DBM::Deep object
167          would still result in an internal reference.
168     - Added export() method for recursively extracting hashes/arrays into
169          standard in-memory Perl structures.
170     - Added import() method for recursively importing existing Perl hash/
171          array structures
172     - Fixed bug where optimize() wouldn't work if base level of DB was
173          an array instead of a hash.
174
175 0.91  Feb 12 02:30:22 2004 Pacific
176     - Fixed bug with splice() when length of removed section was 0
177     - Updated POD re: circular refs and optimize()
178     - Had to jump version numbers to 0.91 because in previous releases
179          I used only a single digit after the decimal which was confusing
180          the CPAN indexer.
181
182 0.10  Feb 11 08:58:35 2004 Pacific
183     - Fixed bug where default file mode was CLEARING files (Thanks Rich!)
184     - Added experimental support for circular references
185     - Fixed bugs in shift(), unshift() and splice() where nested objects
186         in array would be recursively re-stored as basic hashes/arrays
187     - Fixed typos in POD docs
188
189 0.9   Feb 10 03:25:48 2004 Pacific
190     - Added Filters for storing/fetching keys/values
191     - Added hook for supplying own hashing algorithm
192     - FIxed some typos in POD docs, added new sections
193
194 0.8   Feb 8 02:38:22 2004 Pacific
195     - Renamed to DBM::Deep for CPAN
196     - Added optimize() method for rekindling unused space
197     - Now returning hybrid tie()/OO object from new()
198     - Basic error handling introduced
199     - Added debug mode for printing errors to STDERR
200     - Added TYPE_HASH and TYPE_ARRAY constants for "type" param
201     - Added clone() method for safe copying of objects
202     - Wrote POD documentation
203     - Added set_pack() function for manipulating LONG_SIZE / LONG_PACK
204     - Added aliases for most tied functions for public use
205     - Now setting binmode() on FileHandle for Win32
206     - Added 45 unit tests
207
208 0.7   Jan 4 11:31:50 2003 UTC
209     - Renamed to DeepDB
210     - Changed file signature to DPDB (not compatible with older versions)
211     - Converted array length to packed long instead of sprintf()ed string
212
213 0.6   Dec 31 15:12:03 2002 UTC
214     - Some misc optimizations for speed
215
216 0.5   Oct 18 08:55:29 2002 UTC
217     - support for force_return_next parameter in traverse_index() method for 
218       ultra-fast combined key search/removal
219
220 0.4   Oct 15 20:07:47 2002 UTC
221     - now making sure filehandle is open for all DB calls
222
223 0.3   Oct 3 19:04:13 2002 UTC
224     - fixed bug that could cause corrupted data when using locking
225
226 0.2   Aug 6 16:37:32 2002 UTC
227     - Removed base index caching, as it can cause problems when two processes 
228       are populating the db at the same time (even with locking)
229
230 0.1   Jun 3 08:06:26 2002 UTC
231     - initial release