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