Changes

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