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