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