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