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