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