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