Changes

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