Do not replace the literal string '0' with ''
[scpubgit/Q-Branch.git] / Changes
1 Revision history for SQL::Abstract
2
3     - Remove obsolete documentation about arrayrefref as the $source
4       argument for ->select (removed in version 1.74)
5     - Factor out the field list part of SELECT for subclassability (GH#13)
6
7 1.85 - 2018-01-27
8     - Restore perl version requirement missed in the Distar port
9     - Factor out the SET ... part of UPDATE for subclassability (GH#12)
10
11 1.84 - 2017-04-03
12     - Restore 'dynamic_config => 0' missed in the Distar port
13
14 1.83 - 2017-04-03
15     - Support for DELETE ... RETURNING (GH#9)
16     - Port to Distar
17
18 revision 1.82  2017-03-20
19 -------------------------
20     - Add explicit dependency on Sub::Quote (GH#8)
21     - Fix syntax errors in ORDER BY docs (GH#7)
22
23 revision 1.81_01  2017-02-28
24 ----------------------------
25     - Fix order clauses with bind parameters in ->where
26     - Fix ->insert($table, \@values) with >26 values (RT#112684)
27     - Teach ::Tree that ILIKE (PostgreSQL) and REGEXP (MySQL) are binary ops
28     - Support for UPDATE ... RETURNING
29     - Documentation improvements for ORDER BY
30
31 revision 1.81  2014-10-25
32 ----------------------------
33     - Fix overly-enthusiastic parenthesis unroller (RT#99503)
34
35 revision 1.80  2014-10-05
36 ----------------------------
37     - Fix erroneous behavior of is_literal_value($) wrt { -ident => ... }
38     - Explicitly croak on top-level special ops (they didn't work anyway)
39
40 revision 1.79  2014-09-25
41 ----------------------------
42     - New exportable functions: is_literal_value($) and is_plain_value($)
43     - New attribute 'escape_char' allowing for proper escape of quote_chars
44       present in an identifier
45     - Deprecate { "" => \... } constructs
46     - Treat { -value => undef } as plain undef in all cases
47     - Explicitly throw on { -ident => undef }
48
49 revision 1.78  2014-05-28
50 ----------------------------
51     - Fix parsing of binary ops to correctly take up only a single LHS
52       element, instead of gobbling up the entire parse-to-date
53     - Explicitly handle ROW_NUMBER() OVER as the snowflake-operator it is
54     - Improve signatures/documentation of is_same_sql_bind / eq_sql_bind
55     - Retire script/format-sql - the utility needs more work to be truly
56       end-user convenient
57
58 revision 1.77  2014-01-17
59 ----------------------------
60     - Reintroduce { -not => undef } column operator (regression from 1.75)
61
62 revision 1.75  2013-12-27
63 ----------------------------
64     - *UPCOMING INCOMPATIBLE BUGFIX*: SQLA used to generate incorrect SQL
65       on undef-containing lists fed to -in and -not_in. An exception will
66       be raised for a while before properly fixing this, to avoid quiet
67       but subtle changes to query results in production
68     - Deprecate and warn when supplying an empty arrayref to like/not_like
69       operators (likely to be removed before 2.0)
70
71     - Warn when using an inequality operator with a multi-value array to
72       arrive at what amounts to a 1=1 condition (no pre-2.0 plans to fix
73       this behavior due to backwards comp concerns)
74     - Fix false negative comparison of ORDER BY <function> ASC
75     - More improvements of incorrect parsing (placeholder at end of list
76       element)
77     - Fix typos in POD and comments (RT#87776)
78     - Augment -not_bool example with nesting (RT#89601)
79
80 revision 1.74  2013-06-04
81 ----------------------------
82     - Fix insufficient parenthesis unroll during operator comparison
83     - 'ORDER BY foo' and 'ORDER BY foo ASC' are now considered equal
84       by default (with a switch to reenable old behavior when necessary)
85     - Change parser to not eagerly slurp RHS expressions it doesn't recognize
86
87 revision 1.73  2012-07-10
88 ----------------------------
89     - Fix parsing of ORDER BY foo + ?
90     - Stop filling in placeholders in `format-sql` since it does not support
91       passing values for them anyway
92     - Fix parsing of NOT EXISTS
93     - Fix over-eager parenthesis unrolling
94     - Fix deep recursion warnings while parsing obnoxiously long sql statements
95     - Fix incorrect comparison of malformed lists
96     - Fix incorrect reporting of mismatch-members in SQLA::Test
97     - Migrate the -ident operator from DBIC into SQLA
98     - Migrate the -value operator from DBIC into SQLA
99
100 revision 1.72  2010-12-21
101 ----------------------------
102     - Extra checks of search arguments for possible SQL injection attacks
103     - Remove excess parentheses in debug SQL
104     - Fix parsing of foo.* in SQLA::Tree
105     - Fix bindtype fail when using -between with arrayrefref literals
106     - Add handling for NULL for -in
107     - The -nest operator has entered semi-deprecated status and has been
108       undocumented. Please do not use it in new code
109
110 revision 1.71  2010-11-09
111 ----------------------------
112     - Add EXECUTING for clarity of long running SQL
113     - Add "squash_repeats" option to fix it such that repeated SQL gets ellided
114       except for placeholders
115     - Highlight transaction keywords
116     - Highlight HAVING
117     - Leave quotes from DBIC in bindargs
118     - Add error checking on "profile" for SQLA::Tree
119     - Hide bulk inserts from DBIx::Class
120     - Fix missing doc (RT#62587)
121     - Format functions in MySQL-friendly manner foo( ... ) vs foo ( ... )
122
123 revision 1.69  2010-10-22
124 ----------------------------
125     - Add quotes for populated placeholders and make the background
126       magenta instead of cyan
127     - Color and indent pagination keywords
128     - Fix a silly bug which broke placeholder fill-in in DBIC
129     - Installs format-sql to format SQL passed in over STDIN
130     - Switch the tokenizer to precompiled regexes (massive speedup)
131     - Rudimentary handling of quotes ( 'WHERE' vs WHERE )
132     - Fix extended argument parsing by IN/BETWEEN
133     - Add proper handling of lists (foo,bar,?)
134     - Better handling of generic -function's during AST construction
135     - Special handle IS NOT? NULL
136     - Make sure unparse() does not destroy a passed in \@bindargs
137     - Support ops with _'s in them (valid in Oracle)
138     - Properly parse both types of default value inserts
139     - Allow { -func => $val } as arguments to UPDATE
140
141 revision 1.68  2010-09-16
142 ----------------------------
143     - Document methods on Tree
144     - Add affordances for color coding placeholders
145     - Change ::Tree::whitespace to whitespace_keyword
146
147 revision 1.67_03  2010-09-11
148 ----------------------------
149     - Add docs for SQL::Abstract::Tree->new
150     - correcty merge profile and parameters
151     - added fill_in_placeholders option for excellent copy/pasta
152
153 revision 1.67_02  2010-09-08
154 ----------------------------
155     - rename DBIx::Class::Storage::PrettyPrinter to DBIx::Class::Storage::Debug::PrettyPrint
156     - decreased a lot of indentation from ::Tree
157     - cleaned up handling of newlines inside of parens
158
159 revision 1.67_01  2010-09-06
160 ----------------------------
161     - Add SQL::Abstract::Tree
162     - Add unindexed DBIx::Class::Storage::PrettyPrinter
163     - Better documentation of undef/NULL in where clause
164     - Depend on bugfixed Module::Install (now again installs
165       on old < 5.8.3 perls)
166
167 revision 1.67  2010-05-31 14:21 (UTC)
168 ----------------------------
169     - Fix SQL::Test failure when first chunk is an unrecognized
170       literal
171     - Generic -not operator tests
172     - More columns-bindtype assertion checks
173
174 revision 1.66  2010-04-27 02:44 (UTC)
175 ----------------------------
176     - Optimized the quoting mechanism, winning nearly 10%
177       speedup on repeatable sql generation
178
179 revision 1.65  2010-04-11 19:59 (UTC)
180 ----------------------------
181     - Rerelease last version to not include .svn files
182       and grab MANIFEST.SKIP from DBIx::Class so it
183       won't happen again
184
185 revision 1.64  2010-04-11 16:58 (UTC)
186 ----------------------------
187     - Fix multiple generic op handling regressions by
188       reverting the auto-equality assumption (turned out
189       to be a very very bad idea)
190
191 revision 1.63  2010-03-24 09:56 (UTC)
192 ----------------------------
193     - Add ILIKE to the core list of comparision ops
194
195 revision 1.62  2010-03-15 11:06 (UTC)
196 ----------------------------
197     - Fixed open outer parens for a multi-line literal
198     - Allow recursively-nested column-functions in WHERE
199     - Bumped minimum perl to 5.6.2 and changed tests to
200       rely on core dependencies
201
202 revision 1.61  2010-02-05 16:28 (UTC)
203 ----------------------------
204     - Allow INSERT to take additional attributes
205     - Support for INSERT ... RETURNING
206     - Another iteration of SQL::Abstract::Test fixes and improvements
207
208 revision 1.60  2009-09-22 11:03 (UTC)
209 ----------------------------
210     - fix a well masked error in the sql-test tokenizer
211
212 revision 1.59  2009-09-22 08:39 (UTC)
213 ----------------------------
214     - fixed a couple of untrapped undefined warnings
215     - allow -in/-between to accept literal sql in all logical
216       variants - see POD for details
217     - unroll multiple parenthesis around IN arguments to accomodate
218       crappy databases
219
220 revision 1.58  2009-09-04 15:20 (UTC)
221 ----------------------------
222     - expanded the scope of -bool and -not_bool operators
223     - added proper testing support
224
225 revision 1.57  2009-09-03 20:18 (UTC)
226 ----------------------------
227     - added -bool and -not_bool operators
228
229 revision 1.56  2009-05-30 16:31 (UTC)
230 ----------------------------
231     - support for \[$sql, @bind] in order_by clauses e.g.:
232       { -desc => \['colA LIKE ?', 'somestring'] }
233
234 revision 1.55  2009-05-17 22:54 (UTC)
235 ----------------------------
236     - make sure that sql generation does not mutate the supplied
237       where condition structure
238
239 revision 1.54  2009-05-07 17:23 (UTC)
240 ----------------------------
241     - allow special_operators to take both code refs and method names
242       (makes it possible to properly subclass the builtin ones)
243
244 revision 1.53  2009-04-30 14:58 (UTC)
245 ----------------------------
246     - make sure hash keys are sorted in all search sub-conditions
247     - switch installer from EU::MM to M::I
248
249 revision 1.52  2009-04-28 23:14 (UTC)
250 ----------------------------
251     - allow -between to handle [\"", \""] and \["", @bind]
252     - allow order_by to handle -asc|desc => [qw/colA colB/] (artifact from DBIx::Class)
253     - more tests and clearing up of some corner cases
254     - t/10test.t does not run by default (developer only, too cpu intensive)
255
256 ----------------------------
257 revision 1.51  2009-03-28 10:00 (UTC)
258     - fixed behavior of [-and => ... ] depending on the current
259       condition scope. This introduces backwards comp with 1.24
260
261 ----------------------------
262 revision 1.50  2009-03-10 12:30 (UTC)
263     - fixed the problem with values() not behaving the same as the rest of the code (RT#43483)
264     - fixed interjecting arrayrefref into a where clause
265     - added value-only insert test with a literal SQL snippet
266     - cleanup and enhancement of t/03values.t
267     - better handling of borked SQL in tests
268     - deal properly with parentheses in is_same_sql_bind()
269     - fixed test subs (is_same_*) in SQL::Abstract::Test to return the correct test value
270     - do not version MANIFEST
271
272     Version 1.50 was a major internal refactoring of SQL::Abstract.
273     Great care has been taken to preserve the published behavior
274     documented in previous versions in the 1.* family; however,
275     some features that were previously undocumented, or behaved.
276     differently from the documentation, had to be changed in order
277     to clarify the semantics. Hence, client code that was relying
278     on some dark areas of SQL::Abstract v1.* might behave differently
279     in v1.50.
280
281 ----------------------------
282 revision 1.49_04  2009-03-03
283     - add support for a [\%column_meta => value] bind value format
284
285 ----------------------------
286 revision 1.49_03  2009-02-17
287     - clarify syntax of \['...', @bind] when used with a bindtype
288       of 'columns'
289
290 ----------------------------
291 revision 1.49_02  2009-02-16
292     - added an AST-aware SQL::Abstract::Test library for sql syntax tests
293     - vastly expanded test coverage
294     - support for the { operator => \'...'|\['...', @bind] } syntax
295       allowing to embed arbitrary operators on the LHS
296     - fixed multiple regressions wrt DBIx::Class
297
298 ----------------------------
299 revision 1.49_01  2009-02-11
300     - support for literal SQL through the [$sql, bind] syntax.
301     - added -nest1, -nest2 or -nest_1, -nest_2, ...
302     - optional support for array datatypes
303     - defensive programming : check arguments to functions/methods
304     - fixed bug with global logic of -and/-or (no side-effects any more)
305     - changed logic for distributing an op over arrayrefs
306     - fixed semantics of  _bindtype on array args
307     - dropped the _anoncopy of the %where tree. No longer necessary.
308     - dropped the _modlogic function
309     - Make col => [] and col => {$op => [] } DTRT or die instead of generating
310       broken SQL. Added tests for this.
311     - Added { -desc => 'column' } order by support
312     - Tiny "$_"-related fix for { -desc => 'columns'} order by support
313       tests + docs
314
315 ----------------------------
316 revision 1.20
317 date: 2005/08/18 18:41:58;  author: nwiger;  state: Exp;  lines: +104 -50
318 - added patch from Dan Kubb enabling quote_char and name_sep options
319 - added patch from Andy Grundman to enhance _anoncopy for deep refs
320 ----------------------------
321 revision 1.19
322 date: 2005/04/29 18:20:30;  author: nwiger;  state: Exp;  lines: +34 -20
323 added _anoncopy to prevent destroying original; updated docs
324 ----------------------------
325 revision 1.18
326 date: 2005/03/07 20:14:12;  author: nwiger;  state: Exp;  lines: +201 -65
327 added support for -and, -or, and -nest; see docs for details
328 ----------------------------
329 revision 1.17
330 date: 2004/08/25 20:11:27;  author: nwiger;  state: Exp;  lines: +58 -46
331 added patch from Eric Kolve to iterate over all hashref elements
332 ----------------------------
333 revision 1.16
334 date: 2004/06/10 17:20:01;  author: nwiger;  state: Exp;  lines: +178 -12
335 added bindtype param to allow this to work with Orasuck 9+
336 ----------------------------
337 revision 1.15
338 date: 2003/11/05 23:40:40;  author: nwiger;  state: Exp;  lines: +18 -6
339 several bugfixes, including _convert being applied wrong and
340 the edge case field => { '!=', [qw/this that/] } not working
341 ----------------------------
342 revision 1.14
343 date: 2003/11/04 21:20:33;  author: nwiger;  state: Exp;  lines: +115 -34
344 added patch from Philip Collins, and also added 'convert' option
345 ----------------------------
346 revision 1.13
347 date: 2003/05/21 17:22:29;  author: nwiger;  state: Exp;  lines: +230 -74
348 added "IN" and "BETWEEN" operator support, as well as "NOT"
349 modified where() to support ORDER BY, and fixed some bugs too
350 added PERFORMANCE and FORMBUILDER doc sections
351 fixed several bugs in _recurse_where(), it now works as expected
352 added test suite, many thanks to Chas Owens
353 modified all hash access to return keys sorted, to allow cached queries
354 ----------------------------
355 revision 1.12
356 date: 2003/05/08 20:10:56;  author: nwiger;  state: Exp;  lines: +181 -96
357 1.11 interim checking; major bugfixes and order_by, 1.12 will go to CPAN
358 ----------------------------
359 revision 1.11
360 date: 2003/05/02 00:07:30;  author: nwiger;  state: Exp;  lines: +52 -12
361 many minor enhancements to add querying flexibility
362 ----------------------------
363 revision 1.10
364 date: 2002/09/27 18:06:25;  author: nwiger;  state: Exp;  lines: +6 -2
365 added precatch for messed up where string
366 ----------------------------
367 revision 1.9
368 date: 2002/08/29 18:04:35;  author: nwiger;  state: Exp;  lines: +4 -3
369 CPAN
370 ----------------------------
371 revision 1.8
372 date: 2001/11/07 22:18:12;  author: nwiger;  state: Exp;  lines: +31 -14
373 added embedded SCALAR ref capability to insert() and update()
374 ----------------------------
375 revision 1.7
376 date: 2001/11/07 01:23:28;  author: nwiger;  state: Exp;  lines: +3 -3
377 damn uninit warning
378 ----------------------------
379 revision 1.6
380 date: 2001/11/06 21:09:44;  author: nwiger;  state: Exp;  lines: +14 -6
381 oops, had to actually *implement* the order by for select()!
382 ----------------------------
383 revision 1.5
384 date: 2001/11/06 03:13:16;  author: nwiger;  state: Exp;  lines: +43 -4
385 lots of docs
386 ----------------------------
387 revision 1.4
388 date: 2001/11/06 03:07:42;  author: nwiger;  state: Exp;  lines: +16 -7
389 added extra layer of ()'s to ensure correct semantics on AND
390 ----------------------------
391 revision 1.3
392 date: 2001/11/06 01:16:31;  author: nwiger;  state: Exp;  lines: +11 -10
393 updated all statements so that they use wantarray to just return SQL if asked
394 ----------------------------
395 revision 1.2
396 date: 2001/10/26 22:23:46;  author: nwiger;  state: Exp;  lines: +112 -15
397 added scalar ref for SQL verbatim in where, fixed bugs, array ref, docs
398 ----------------------------
399 revision 1.1
400 date: 2001/10/24 00:26:43;  author: nwiger;  state: Exp;
401 Initial revision