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