Clarity fix for assocproxy example code

.pop() on association proxies is no longer problematic with 0.4 collections.

- unittest cleanup: after removal of threadlocal mod + changes to session calling signature,
got sqlite, postgres, mysql all working again (one unresolved failure for mysql)

partial progress on adding prop.compare(), new behavior for prop ==

added some aggregate tests

- merged fix of PG identifier length from 68 to 63 [ticket:571]
- merged r2958, commutativity for _BinaryExpression.compare

- put a generic regexp for chopping foreign key specs along the "."
[ticket:667]

- Merged r2945, r2946, r2947 from trunk
- Cache 'lower_case_table_names' test for the lifetime of a connection
- Clean up compat fetch stuff

typo

- changed the order of args to session.execute(), session.scalar()
- removed session.connect().  theres only connection()
- implemented twophase flag on session, twophase calls within SessionTransaction,
one unit test so far which tests that it succeeds (but doesnt test a failure yet or
do any mocking)
- rewrote session transaction docs

Properly escape table names when reflecting for mssql and sqlite [ticket:653]

Rewrote association proxy documentation to be more accessible and promote the general awesomeness of association proxies.

- removed ancient threadlocal/legacy_session mods
- Session now has tranasaction API built into it, SessionTransaction not part of the usual API now (but still does the work)
- integrated nested transactions/SAVEPOINT with Session transactional system
- Session gets "transactional" mode, it always begins a transaction and reopens after commit/rollback
- Session gets "autoflush=True" flag, implies "transactional", issues a flush before the execution of every
query so that query results include whatever is currently in the session
- various unit test fixes

- Adjust has_table for MySQL, workaround multibyte issue on osx

another order_by fix

- got in_() working, enhanced sql.py treatment of Comparator so comparators can be used in any SQL expression (i.e. order bys, desc(), etc.)
- adding various tests for new clause generation

- added operator support to class-instrumented attributes. you can now
filter() (or whatever) using <classname>.<attributename>==<whatever>.
for column based properties, all column operators work (i.e. ==, <, >,
like(), in_(), etc.).  For relation() and composite column properties,
==<instance>, !=<instance>, and ==<None> are implemented so far.
[ticket:643]

- moved query._with_parent into prop.compare() calls
- built extensible operator framework in sql package, ORM
builds on top of it to shuttle python operator objects back down
to the individual columns.  no relation() comparisons yet.  implements
half of [ticket:643]

Ignore generated doc build artifacts

Tweak collections doc to fit in with long-lines club.

- Finish collections doc changes started in r2839, expanding coverage in
  main documentation and docstrings.
- Per list discussion, removed backward compat. for dict- and object-derived
  collection types.  This is the safest course of action given the major
  change in dict iterator behavior.
- Minor typos and code cleanups.

removed get_str(), get_from_text() from ansicompiler.  removes a few hundred method calls

regexp searches for negative decimals too

When testing unicode for MySQL, ensure the connection is utf8

fix to connection-bound compiled objects

fix to SessionTransaction so it holds onto a Connection properly

few more tweaks for the aliasing change

- converted all anonymous labels and aliases to be generated within the compilation phase.  this allows fully "deterministic" label generation. theres a couple of unit test failures that need to be fixed but most are passing.
- also some tweaks to unicode result column names; no longer chopping out characters from the names, since the name might be composed of all non-ascii characters.  mysql needs some work here since its returning, i think, the unicode's internally-encoded bytes directly within a bytestring.
- need to simplify the amount of dictionaries present in ANSICompiler, its pretty hard to follow at this point.

removed some remaining "connectable"/"bind_to" keywords

completed connectable/bind_to/engine work for [ticket:645]

merged trunk r2901-2924

- bind test in query.orm
- merged ambiguous colname fix from r2915

added some text tests

- merged trunk r2880-r2901 (slightly manually for 2900-2901)
- merges "bind" argument change
- merges join fixes for [ticket:185]
- removed all "engine"/"connectable"/"bind_to"/"engine_or_url" arguments/attributes

context manager support for sql transactions

add support for two phase commits, nested subtransactions and savepoints. refactors Transaction class into a hierarchy.

added some order_bys to eager relations, which otherwise load with different
ordering on PG.  we might want to get eager relations on m2m to handle default order-by differently

dont log statement + parameters if logging is not enabled

added polymorphic associations examples from the trunk

Fixed postgres array concatenation

merged trunk r2826-2879

Added PGArray datatype for using postgres array datatypes

missed an override of type engine comparison that is now the same as default, removed it

changed type engine default comparison from identity to equality

added a unit test to illustrate the equivalent of
https://lists.ubuntu.com/mailman/private/storm/2007-July/000037.html

make use of the isinstance(obj, (A,B)) idiom, makes the code a bit shorter and more comprehensible (maybe a bit faster too)

Try to only convert :bind params and leave colons in text literals alone

- renamed DynamicMetaData to ThreadLocalMetaData
- removed BoundMetaData, use MetaData instead

Fix up extensions in wake of r2852 mapper.props change

- the type of a _BooleanExpression should always be Boolean
- added a random generative select() to a test (need to add the real tests to either select.py or generative.py)

- removed mapper.props, replaced with mapper.get_property()/ mapper.iterate_properties,
since these are the only two use cases for the "__props" collection on mapper.
does synonym resolution so also fixes [ticket:598]

increase code font size

More collections test coverage.

- added NullType to export list
- any NullType will trigger the "get col type from FK logic", though
there are other issues with this logic (requires the FK be initialized)
- added INT to sqlite resolution map
- adjusted sqlsoup for sql.Select api changes

Add a test for that OrderedDict fix, also add more paranoia in the constructor.

- Add coverage for dict collections, and fixes for dict support.
- Default dict appender name now 'set' to be consistent with duck_typing,
  prefer to remove default appender/remover methods from dict altogether.
- Add coverage for MappedCollection and OrderedDict derived dict collections
- Add coverage for raw object collections
- Fix OrderedDict pop() etc., [ticket:585]
- Update orderinglist unit test and remove 'broken until #213' assertion

- Add coverage for set collections, added missing clear() decorator
- Try not to be such an idiot when testing lists

- Coverage of list collections, and matching fixes in slice mutation

More byroot_tree cleanups.

- Started moving collection module docs to doc
- Added collections.attribute_mapped_collection, an attrgetter variant
  for mapped_collection
- Added collections unit test stub, and fix accompanying bugs

- standardized the behavior for table reflection where types can't be located;
NullType is substituted instead, warning is raised.
- consolidation of imports in some db modules

removed ancient "backref" example, updated byroot_tree to not suck so much

simplified the loading mechanism.  much easier to understand now

forgot to add the xml files...

moved oracles "auto_convert_lobs" logic into a generic dialect
function which attempts to map DBAPI types to TypeEngine instances
at result time.  This only occurs for statements that have no typemaps
(i.e. textual statements).

marking some methods as private

separated the adjacency list version into the "basic" and the "optimized" version

added some path searching

fix to test created in [changeset:2621], was corrected in trunk in [changeset:2637].
very weird that it was passing on sqlite/postgres since it was producing a SELECT without a FROM.

- implemented ORM-level composite column types [ticket:211].
constructed via composite(cls, *columns), allows multiple columns
to be expressed as a single object attribute.  can be used for primary
key columns also.  not yet supported for deferred column loading (but
this is straightforward).
- formatting to CHANGES
- some test suite fixes

some better cascades

added "elementtree" examples

merged, with some modifications, mapped constructor exceptions fix from trunk 2825

merged pool tweak from r2823

- finished moving all EagerLoader tests from mapper to eager_relations
- consolidated other eager tests into assorted_eager
- moved assertion objects into fixtures module

- merged some tweaks to the pool overflow sync from trunk r2819
- merged vertical.py delete tests from trunk r2820, fixed collection
to new style collection

merged pickleable schema items from trunk r2817

merged postgres domains patch r2814-2815

expanded upon query's prefab assertion data

migrated most of mapper/EagerTest to updated eager_relations module

all of LazyTest moved to updated lazy_relations module

Added another set of assertions for attribute pickling.

Simplifying that pickle workaround.

Working around the pickle memoization quirk in attributes test.

fix --file again

copyright page

Bump doc version to 0.4, fix --file gen option

merged r2678 from trunk (merge in r2733 truncated but did not remove)

Unused import.

- OrderedDict shouldn't send None to update, never know who might be watching
  (breaks use as a collection class)
- Update MapperExtension in byroot_tree example, finish updates for new
  collections.

update example to work with new collections class

some comparison fixes

- Applied some safe collections optimizations and annotated a few key places
  for future optimization.  As-is, masseagerload shows a speed up and overall
  function reduction compared to 0.4 pre-collections.
- Some minor cleanups in collections + related

- Replaced collection api: The "InstrumentedList" proxy is replaced with
  a proxy-free, decorator-based approach for user-space instrumentation and
  a "view" adapter for interaction with the user's collection within the orm.
  Fixes [ticket:213], [ticket:548], [ticket:563].
- This needs many more unit tests.  There is significant indirect coverage
  through association proxy, but direct tests are needed, specifically in
  the decorators and add/remove event firing.
- Collections are now instrumented via decorations rather than
  proxying.  You can now have collections that manage their own
  membership, and your class instance will be directly exposed on the
  relation property.  The changes are transparent for most users.
- InstrumentedList (as it was) is removed, and relation properties no
  longer have 'clear()', '.data', or any other added methods beyond those
  provided by the collection type.  You are free, of course, to add them
  to a custom class.
- __setitem__-like assignments now fire remove events for the existing
  value, if any.
- dict-likes used as collection classes no longer need to change __iter__
  semantics- itervalues() is used by default instead.  This is a backwards
  incompatible change.
- subclassing dict for a mapped collection is no longer needed in most cases.
  orm.collections provides canned implementations that key objects by a
  specified column or a custom function of your choice.
- collection assignment now requires a compatible type- assigning None
  to clear a collection or assinging a list to a dict collection will now
  raise an argument error.
- AttributeExtension moved to interfaces, and .delete is now .remove
  The event method signature has also been swapped around.

merge from trunk fix for undetected disconnects for mysql (ticket #625), r2793

merge 2791 from trunk, fix for bad error message (ticket #607)

merge compound select grouping patch from trunk (ticket #623)

merge from trunk #624 fix, modulo operator escaping

merged between precedence from trunk ([2785])

merged operator precedence fixes/tests IN fixes/tests from trunk r2782-r2783