Changes

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