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