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