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