more searching for equiv columns

- fixed error where Query.add_column() would not accept a class-bound
attribute as an argument; Query also raises an error if an invalid
argument was sent to add_column() (at instances() time) [ticket:858]

- query doesn't throw an error if you use distinct() and an order_by()
containing UnaryExpressions (or other) together [ticket:848]

a tweak, still requiring test coverage, to add more "foreign key equivalents" to the equivalent_columns collection

more changes to traverse-and-clone; a particular element will only be cloned once and is
then re-used.  the FROM calculation of a Select normalizes the list of hide_froms against all
previous incarnations of each FROM clause, using a tag attached from cloned clause to
previous.

- identified some cases where Alias needs to be cloned; but still cant clone
when its an alias of a Table; added some test coverage for one particular
case from the doctests
- fixed "having" example in doctests, updated eager load example

updated zoomark test_1a_populate callcounts. if the calls keep being removed like this then soon there will be none left.

- fixed remainder of [ticket:853]
- bindparam 'shortname' is deprecated
- fixed testing.assert_compile() to actually generate bind param dict before asserting
- added bind param assertions to CRUDTest.test_update

  - <Engine|Connection>._execute_clauseelement becomes a public method
    Connectable.execute_clauseelement

  - fix to compiled bind parameters to not mistakenly populate None
    [ticket:853]

fixed the previous TLTransaction checkin

- fixed the close() method on Transaction when using strategy='threadlocal'

adjusted "blank out primary key" rule to check for "allow_null_pks" on target mapper.  this was revealed by
recent attributes.py change in r3695 that causes a value of "None" to register as part of the attribute history's
added_items() collection (i.e. since AttributeHistory compares against NO_VALUE instead of None).

  - fixed very hard-to-reproduce issue where by the FROM clause of Query
    could get polluted by certain generative calls [ticket:852]

fixed/added coverage for list extension; [ticket:855]

Added missing InternalError exception wrapper [ticket:854]

Create a storage field for arbitrary info on tables/columns; ticket #573

Added note about EXT_CONTINUE to 3.x -> 4.x migration guide

Migrated maxdb behavioral assumptions from unsupported to fails_on

Added testing.fails_on('db') failure-asserter.

- figured out a way to get previous oracle behavior back.  the ROWID thing
is still a pretty thorny issue.

- adjustments to oracle ROWID logic...recent oid changes mean we have to
use "rowid" against the select itself (i.e. its just...'rowid', no table name).
seems to work OK but not sure if issues will arise
- fixes to oracle bind param stuff to account for recent removal of ClauseParameters object.

- oid_column proxies more intelligently off of Select, CompoundSelect - fixes platform-affected bugs in missing the correct "oid" column
- locate_all_froms() is expensive; added an attribute-level cache for it
- put a huge warning on all select.append_XXX() methods stating that derived collections like locate_all_froms() may become invalid if
already initialized

Whitespace cleanup

- base_columns on ColumnElement becomes a list; as usual, because columns in CompoundSelects
may extend from more than one root column.
- keys_ok argument from corresponding_column() removed.  no more name-based matching of columns anywhere.
- DictDecorator is gone.  all row translators provided by orm.util.create_row_adapter().  Mapper
and contains_alias() cache the adapters on target mapper to avoid re-computation of adapters.
- create_row_adapter() accepts an "equivalent_columns" map as produced by Mapper, so that
row adapters can take join conditions into account (as usual again, to help with the CompoundSelects
produced by polymorphic_union).
- simplified TableSingleton to just provide lookup; moved all initialization into Table.
- the "properties" accessor on Mapper is removed; it now throws an informative
exception explaining the usage of mapper.get_property() and
mapper.iterate_properties

- SHOW CREATE TABLE output is slightly different if msyql is in ANSI mode

- rewrote and simplified the system used to "target" columns across
selectable expressions.  On the SQL side this is represented by the
"corresponding_column()" method. This method is used heavily by the ORM
to "adapt" elements of an expression to similar, aliased expressions,
as well as to target result set columns originally bound to a
table or selectable to an aliased, "corresponding" expression.  The new
rewrite features completely consistent and accurate behavior.
- the "orig_set" and "distance" elements as well as all associated
fanfare are gone (hooray !)
- columns now have an optional "proxies" list which is a list of all
columns they are a "proxy" for; only CompoundSelect cols proxy more than one column
(just like before).  set operations are used to determine lineage.
- CompoundSelects (i.e. unions) only create one public-facing proxy column per
column name.  primary key collections come out with just one column per embedded
PK column.
- made the alias used by eager load limited subquery anonymous.

  - func. objects can be pickled/unpickled [ticket:844]

- eager loading with LIMIT/OFFSET applied no longer adds the primary
table joined to a limited subquery of itself; the eager loads now
join directly to the subquery which also provides the primary table's
columns to the result set.  This eliminates a JOIN from all eager loads
with LIMIT/OFFSET.  [ticket:843]

- rewritten ClauseAdapter merged from the eager_minus_join branch; this is a much simpler
and "correct" version which will copy all elements exactly once, except for those which were
replaced with target elements.  It also can match a wider variety of target elements including
joins and selects on identity alone.

Added a profiled benchmark for orm attribute modification & flush

- Swap operator.eq for lambda x,y: x==y
- Some docstring re-formatting

Formatting for 0.4.1

Added some more notes for maxdb

- Removed equality, truth and hash() testing of mapped instances. Mapped
  classes can now implement arbitrary __eq__ and friends. [ticket:676]

- removed "name" attribute from FromClause, Join, Select, CompoundSelect.  its needless
and led to some very strange anonymous label names
- removed what was apparently cruft in some column-targeting code

added small clarification on single-table inheritance mapper def

doc updates for save_on_init=False, merge(...dont_save=True)

- extra merge test
- merge with dont_load also propagates _state.modified

- merge() includes a keyword argument "dont_load=True".  setting this flag will cause
the merge operation to not load any data from the database in response to incoming
detached objects, and will accept the incoming detached object as though it were
already present in that session.  Use this to merge detached objects from external
caching systems into the session.

More improvements to testlib's mapper decorator

Tweaks for assert_unordered_result

Added AssertMixin.assert_unordered_result

- session checks more carefully when determining "object X already in another session";
e.g. if you pickle a series of objects and unpickle (i.e. as in a Pylons HTTP session
or similar), they can go into a new session without any conflict
- added stricter checks around session.delete() similar to update()
- shored up some old "validate" stuff in session/uow

Added rowset() testing helper.

Fixed truth-evaluation of mapped objects (part of [ticket:676]

- merged factor_down_bindparams branch.
- removed ClauseParameters object; compiled.params returns a regular dictionary
  now, as well as result.last_inserted_params()/last_updated_params().
- various code trimming, method removals.

Added command line options to add tripwires for __hash__, __eq__ and __nonzero__ on mapped classes.

- A more efficient IdentitySet

- split ScalarInstrumentedAttribute into a "scalar" and an "object" version.
The "object" version loads the existing value on set/del, fires events,
 and handles trackparent operations; the "scalar" version does not.
- column loaders now use the "scalar" version of InstrumentedAttribute, so that
event handlers etc. don't fire off for regular column attribute operations.
- some adjustments to AttributeHistory to work properly for non-loaded attributes
- deferred column attributes no longer trigger a load operation when the
attribute is assigned to.  in those cases, the newly assigned
value will be present in the flushes' UPDATE statement unconditionally.

dont call up new session unless save_on_init

- also added proxying of save_or_update to scoped sessions.
- session.update() raises an error when updating an instance that is already in the session with a different identity
- adjusted zoomarks lower limits so I can get a nice clean run

added REAL to reflection list

Added proxying of __contains__ and __iter__ methods for scoped sessions

Fixup sp_columns call

Fixed a truncation error when re-assigning a subset of a collection
(obj.relation = obj.relation[1:]) [ticket:834]

Added util.IdentitySet to support [ticket:676] and [ticket:834]

Formatting tweaks.

- Removed unused util.hash()
- Fixed __hash__ for association proxy collections

- Don't re-save objects in these tests (post r3681)

- Refinements for maxdb's handling of SERIAL and FIXED columns
- Expanded maxdb's set of paren-less functions

- Added the NUMERIC sql type alias

- fix to "row switch" behavior, i.e. when an INSERT/DELETE is combined into a
  single UPDATE; many-to-many relations on the parent object update properly.
  [ticket:841]
- it's an error to session.save() an object which is already persistent
  [ticket:840]
- changed a bunch of repr(obj) calls in session.py exceptions to use mapperutil.instance_str()

- restored MapperExtension functionality for [ticket:829], added test coverage
- changed naming convention in mapper.py tests to test_<testname>

- fixed INSERT statements w.r.t. primary key columns that have SQL-expression
  based default generators on them; SQL expression executes inline as normal
  but will not trigger a "postfetch" condition for the column, for those DB's
  who provide it via cursor.lastrowid

- fixed expression translation of text() clauses; this repairs various
  ORM scenarios where literal text is used for SQL expressions

- a little cleanup to deferred inheritance loading

- merged path_based_options branch
- behavior of query.options() is now fully based on paths, i.e. an option
  such as eagerload_all('x.y.z.y.x') will apply eagerloading to only
  those paths, i.e. and not 'x.y.x'; eagerload('children.children') applies
  only to exactly two-levels deep, etc. [ticket:777]
- removes old compiler()/schemagenerator()/schemadropper() methods from mysql dialect

- inlined a couple of context variables
- PG two phase was calling text() without the correct bind param format, previous compiler checkin revealed issue

- removed regular expression step from most statement compilations.
  also fixes [ticket:833]
- inlining on PG with_returning() call
- extra options added for profiling

clear MapperStub ArgSingletons on clear_mappers() too...

- fixed eager calc endless loop, introduced by r3646?  this issue should have been present before 3646 though.

- fixed clear_mappers() behavior to better clean up after itself

Make access dao detecting more reliable #828

remove unused method

- removed needless 'continue'

- refactored _compile_properties/_compile_property, removed redundant code.
still a little squirrely but much less complex.
- improved behavior of add_property() etc., fixed [ticket:831] involving
  synonym/deferred

- de-cruftified backref configuration code, backrefs which step on existing
  properties now raise an error [ticket:832]

A --db alias for max.

- Added initial version of MaxDB dialect.
- All optional test Sequences are now optional=True

Fixed assert_sql_count exception logic.

Updated for r3655.

Added support for dialects that have both sequences and autoincrementing PKs.

- The post_exec() hook now gets invoked before autocommit fires.

Changed some columns from TEXT to VARCHAR for sapdb.

- Now guarding against broken DB-APIs when wrapping their exceptions.
- Added an explicit test for exception wrapping.

- sqlite will reflect "DECIMAL" as a numeric column

exception message, [ticket:826]

bumped sqlite version for empty insert test to 3.4

- the whole OperationContext/QueryContext/SelectionContext thing greatly scaled back;
all MapperOptions process the Query and that's it, one very simpliied QueryContext object gets passed
around at query.compile() and query.instances() time
- slight optimization to MapperExtension allowing the mapper to check for the presence of an extended method, takes 3000 calls off of masseagerload.py test (only a slight increase in speed though)
- attempting to centralize the notion of a "path" along mappers/properties, need to define what that is better.  heading towards [ticket:777]...

Excluding older sqlite versions from the new insert tests.  Currently conservative- 2.8 definitely fails, 3.3 works.  The 3.0 and 3.1 binaries from sqlite.org segfault for me so the version check should be revisited when possible.

- Added contains operator (which generate a "LIKE %<other>%" clause).

- Added test coverage for endswith operator

Fixed empty (zero column) sqlite inserts, allowing inserts on
autoincrementing single column tables.

- added test coverage for unknown type reflection, fixed
  sqlite/mysql handling of type reflection for unknown types

typos, PassiveDefault likes "text()" otherwise the argument is a literal

Bump!

put a little note at the top directing users to the more *exciting* changes

Update for 0.4.0

typo

- removed __len__ from "dynamic" collection as it would require issuing
  a SQL "count()" operation, thus forcing all list evaluations to issue
  redundant SQL [ticket:818]