Changes

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