Changes

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