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