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