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

docstring cleanup, removal of some ORM cruft

moved "clone" conditional blocks into separate copy_internals() method; was a
conflation of tasks having them in the same place like that.

removed ConnectionProvider.  engines have a "pool" attribute now.

merged trunk r2755-r2778

- fixed  limit/offset compilation for postgres

- merge of generative_sql branch
- copy_container() removed.  ClauseVisitor.traverse() now features "clone"
flag which allows traversal with copy-and-modify-in-place behavior
- select() objects copyable now [ticket:52] [ticket:569]
- improved support for custom column_property() attributes which
  feature correlated subqueries...work better with eager loading now.
- accept_visitor()  methods removed.  ClauseVisitor now genererates method
names based on class names, or an optional __visit_name__ attribute.  calls
regular visit_XXX methods as they exist, can optionally call an additional
"pre-descent" enter_XXX method to allow stack-based operations on traversals
- select() and union()'s now have "generative" behavior.  methods like
order_by() and group_by() return a *new* instance - the original instance
is left unchanged.  non-generative methods remain as well.
- the internals of select/union vastly simplified - all decision making
regarding "is subquery" and "correlation" pushed to SQL generation phase.
select() elements are now *never* mutated by their enclosing containers
or by any dialect's compilation process

- Added missing orm import

- expanded assignment test, ensure that re-assigning the value of
  an association mutates the backing object (rather than a delete and
  create with new primary keys)

- merged trunk r2730-r2755
- removed "clear_mapper()" method

update changelog

added a unit test to test PK "collapsing" as in [changeset:2636], to help illustrate for [ticket:611]

fixed overly eager check for ClauseElement type in filter()

fixed outerjoin() to use correct start point

- finally figured out how to get setuptools version in, available
as sqlalchemy.__version__ [ticket:428]

filter() checks for ClauseElement [ticket:535]

- merged last_inserted_ids() fix from trunk [changeset:2743]

- Eh, dummy_threading trick didn't actually work for no-op'ing overflow.
  Works now, but less readable.
- Shaped the script from ticket #608 into a test case

- Put a mutex around the QueuePool's overflow handlings

- Added testbase.Table and testbase.Column, interceptors that can set up
  test-run- and dialect-specific options on those objects
  All tests re-pointed to go through the interceptors
- Removed mysql_engine= from table declarations, replaced with a general
  flag indicating storage requirements
- Added ability to choose a global MySQL storage engine for all tests
  --mysql-engine=<whatever>
  If none is specified, tests use the old db-default/InnoDB behavior
- Added ability to append arbitrary table creation params
  --table-option=KEY=VALUE
  For MySQL 3, use this to set mysql_type instead of --mysql-engine
- Removed a couple dead test modules

unit test fix

- added "explcit" create/drop/execute support for sequences
(i.e. you can pass a "connectable" to each of those methods
on Sequence)
- checkfirst flag propigates for sequence creates/drops

- merged trunk 2629-2730
- fixes to is_select() which is now an important method
- mysql unit tests fixes

 - result sets from CRUD operations close their underlying cursor immediately.
    will also autoclose the connection if defined for the operation; this
    allows more efficient usage of connections for successive CRUD operations
    with less chance of "dangling connections".

fixed up really old tests to work without legacy engine syntax

r/m psycopg1 support

add explanation of prefab db connections

fix apparent typo

merge 2684-2686 from trunk

- Faster FOR UPDATE tests

- Added tests for SELECT ... FOR UPDATE
- Added postgres support for FOR UPDATE NOWAIT via select(for_update='nowait')

  - result.last_inserted_ids() should return a list that is identically
    sized to the primary key constraint of the table.  values that were
    "passively" created and not available via cursor.lastrowid will be None.

- MetaData loses 'name' attribute
- no more global_connect()

added separate test for metadata
some cleanup to query.py unit test
added settable "engine" property on MetaData

- added "aliased joins" feature to query.filter_by()
- further work on modernizing/cleaning up unit tests

merged StaticPool implementation

version number

added test for testing against "outerjoin"

- added a third layer of inheritance to polymorph test
- added some extra logic to mapper to try to convert a "foreign key" holding PK-col
into a non-FK col
- apparently, polymorphic loading can now be achieved with LEFT OUTER JOINs quite easily (i.e. no UNIONs).
this needs to be studied further (i.e. why was I making everyone use UNION ALL all this time)