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