fix to the backref primary join condition

added "polymorphic assocaition" example, illustrates how to emulate
Rails' polymorphic associaiton functionality

fixed two bad __init__ calls

remove unneeded division

added hotshot points into unit test, localizes profiling to just the query.select() process.
0.4 branch now has 18% fewer function calls for the same test.

another object.__init__() call with args....might need to build py2.6 to test this more completely....

removed ClauseVisitor.__init__(), doesnt work with python trunk

normalized PG test schema name to "alt_schema"

- mysql doesnt have + for concatenation, but pg doesnt have concat() (nor does sqlite)
- parameterized masseagerload test

- Micro-documentation for why we set FOUND_ROWS flag (supports_sane_rowcount)

- Coerce 'local_infile' mysql connect argument into an int

- Nearly all MySQL column types are now supported for declaration and
  reflection. Added NCHAR, NVARCHAR, VARBINARY, TINYBLOB, LONGBLOB, YEAR
- The sqltypes.Binary passthrough now builds a VARBINARY rather than a
  BINARY if given a length
- Refactored the inheritance of some types with respect to sqltypes, and
  especially the binary types
- Lots and lots of docs
- MySQL unit tests now starting to adapt to known problems with alpha/beta
  drivers
- A couple mysql unit test fix-ups and expansions

- Don't use '+' for sql expr concatenation by default

- Setup/teardown out test table properly

- DB connection urls for tests can now be loaded from a configuration file
- Test runs can now --require a particular external package version
- Added some 'coerce' magic to the Oracle connection factory to support use_ansi in the dburl query string

update

turned off supports_sane_rowcount until someone wants to fix #370

CompoundSelect (i.e. UNION etc.) needed self_group() to provide parenthesis

fix typo

- improved support for eagerloading of properties off of mappers that are mapped
to select() statements; i.e. eagerloader is better at locating the correct
selectable with which to attach its LEFT OUTER JOIN.
- some fixes to new tests in inheritance5 to work with postgres

fix to previous logging fix...

- restored logging of "lazy loading clause" under sa.orm.strategies logger,
got removed in 0.3.7

restored comparison of 1-element clause list -> ClauseElement, which was broken in [changeset:2620]

- fixed bug in query.instances() that wouldnt handle more than
on additional mapper or one additional column.

- removed "no group by's in a select thats part of a UNION"
restriction [ticket:578]

correct typo

- the "primary_key" argument to mapper() is propigated to the "polymorphic"
mapper.  primary key columns in this list get normalized to that of the mapper's
local table.

- fix to select_by(<propname>=<object instance>) -style joins in conjunction
with many-to-many relationships, bug introduced in r2556
- the "reverse_direction" flag in _create_lazy_clause works correctly for a many-to-many
relationship (i.e. the reverse is on which clause, not which column in the clause, in the
case of m2m)

added test for "assign a list of objects", ensure cascade/persistence functions

fixed LoggingClauseVisitor

restored outerjoin test

- fix to polymorphic query which allows the original polymorphic_union
to be embedded into a correlated subquery [ticket:577]

- parenthesis are applied to clauses via a new _Grouping construct.
uses operator precedence to more intelligently apply parenthesis
to clauses, provides cleaner nesting of clauses (doesnt mutate
clauses placed in other clauses, i.e. no 'parens' flag)
- added 'modifier' keyword, works like func.<foo> except does not
add parenthesis.  e.g. select([modifier.DISTINCT(...)]) etc.

- _Label propigates "_hide_froms()" so that scalar selects
behave more properly with regards to FROM clause #574

propigated detach() and invalidate() methods to Connection.

- Connections can be detached from their pool, closing on dereference instead of returning to the pool for reuse

- set max identifier length to 31

- fix to long name generation when using oid_column as an order by
(oids used heavily in mapper queries)

- session.get() and session.load() propigate **kwargs through to query

- many-to-many relationships properly set the type of bind params
for delete operations on the association table
- many-to-many relationships check that the number of rows deleted
from the association table by a delete operation matches the expected
results

- shored up DBAPI descriptions
- added link to select() docs in sqlconstruction

clarifying some cascade-based unit tests, adding a little more coverage,
and trying to remove unneeded parts of dependency.py cascades.
also de-emphasizing the whole session.flush([oneobject]) thing since i dont really
agree it should be supported

- "delete-orphan" no longer implies "delete". ongoing effort to
separate the behavior of these two operations.

- _Label class overrides compare_self to return its ultimate object.
meaning, if you say someexpr.label('foo') == 5, it produces
the correct "someexpr == 5".

Oops, Python 2.5 ternary operator snuck in.

- Test assoc proxy lazy loads, fixed __set__ race on single scalar assocs

- New association proxy implementation, implementing complete proxies to list, dict and set-based relation collections (and scalar relations).  Extensive tests.
- Added util.duck_type_collection

- Aliasizer removed.  hooray !
- ClauseVisitor has handy chain() method.

- added sqlalchemy.ext.orderinglist, a custom list class that synchronizes an object attribute with that object's position in the list

- Use Python 2.5's built-in ElementTree if possible

- Expanded on the MySQL ENUM 'strict' documentation a little bit.
- Oops, clean up after enum unitttest.

- MySQL ENUM types can now optionally ensure that values are within the
  enum's allowed range on insert and update, with strict=True
- Added new 'dialect' category of unit tests, and migrated MySQL-specific
  dialect tests there.
- Noted the max identifier length in the MySQL dialect (the max alias length,
  actually)

Removed an unneeded and troublesome subquery test.

some notes on a labeling issue that arises when label truncation doesnt match col truncation

- allow MySQL column-level CHARACTER SET and COLLATE, plus shortcuts like
  ASCII, UNICODE, and BINARY.  support NATIONAL.
- added MySQL-specific reserved words
- added tests for MySQL numeric and string column DDL generation
- various minor cleanups, also tweak regex to not break emacs syntax hilighting

- applied YAGNI to supports_autoclose_results (this issue would be handled by BufferedColumnResultProxy)
- the docstrings, they do not end

 - small fix to SelectResultsExt to not bypass itself during
      select().

- docstring improvements in query
- added support for __getitem__ on OrderedSet

0.3.7...

- adapted gaetan's eager load adaption code for non-mapped column properties

- restored old "column_property()" ORM function (used to be called
"column()") to force any column expression to be added as a property
on a mapper, particularly those that aren't present in the mapped
selectable.  this allows "scalar expressions" of any kind to be
added as relations (though they have issues with eager loads).

- the label() method on ColumnElement will properly propigate the
TypeEngine of the base element out to the label, including a label()
created from a scalar=True select() statement.

added orig_set colleciton to Select when its declared as a scalar, to allow
corresponding_column() to return a result

- fix to using distinct() or distinct=True in combination with
join() and similar

- mysql uses "DESCRIBE [<schemaname>].<tablename>", catching exceptions
if table doesnt exist, in order to determine if a table exists.
this supports unicode table names as well as schema names. tested
with MySQL5 but should work with 4.1 series as well. (#557)

- mssql: replace "select @@identity" with "select @@scope_identity". Should help avoid returning wrong ID when insert triggers are used. Also add unit test (thanks paj)
- mssql: if no db-api module specified, probe in the order [pyodbc, pymssql, adodbapi]

document the 'echo' property

- added 'url' attribute to Engine
- added docstring to 'echo' attribute

docstring tweaks

- CSS change to regular font for docstrings now that we use docutils for formatting
- dynamicmetadata clarification

- fixed textual select elements that got broke the other day
- docstring work

sentence clarify

- support for inline hyperlinks between HTML-generated docstrings
- docstrings for all sql package functions including cross linking.

extra tests that unneeded UPDATEs dont occur

removed unneeded closure function

removed 'unjoined_table', synonymous with local_table

- the usual adjustments to relationships between inheriting mappers,
in this case establishing relation()s to subclass mappers where
the join conditions come from the superclass' table
- specifically, places where PropertyLoader limits its search to mapper.local_table had to be expanded
to search separately within mapper.mapped_table as well.  in the case of determining primary/secondaryjoin, it starts more specifically first with local table then out to mapped table if not found.  in the case of determining direction, it starts more generally with mapped table, then if ambiguous direction, goes to the local tables.

correct typo-equivalent mistakes in some comments/docstrings

- Fully specify ordering for ordered union test comparison

restored functionality to not issue DELETE for instances that have no _identity_key

decruftify UOW some more....uowdumper always prints out based on
polymorphic collections

- generative test doesnt apply to mysql, others
- refactoring to unitofwork.py.  low-hanging cruft
removed, UOWTask structure simplified particuularly with the
per-instance sort phase, most methods docstring'ed extensively.
this is a merge from the 'uowsimplify' branch.  (only slightly simpler, tho)
- mapper delete_obj works across multiple mappers to be consistent
with the operation of save_obj

some extra tests for synonyms to relation()s

- _with_parent_criterion generalized into _with_lazy_criterion
- _create_lazy_clause now includes a 'reverse_direction' flag to generate lazy criterion
in from parent->child or vice versa
- changed join_by() in query to use the "reverse" _create_lazy_clause for instance comparisons
so conditions like AND can work [ticket:554]

fixed casing of SET clause

- Always propagate constructor exceptions in mapped clases (applied patch in #528)

- added generative versions of aggregates, i.e. sum(), avg(), etc.
to query. used via query.apply_max(), apply_sum(), etc.
#552

revert CSS tweak

#553 propigate index on copied columns

some formatting/indentation stuff

wrap __name__ settings in a try/except for 2.3 compat

- assign_mapper names methods according to their keys (i.e. __name__)
      #551

- added a col label to help sqlite with order by

- primary key determination within Join maintains table PK ordering

- fix to case() construct to propigate the type of the first
WHEN condition as the return type of the case statement
- various unit test tweaks to get oracle working

added an order_by

- Fire delrecord events when items are discard()ed from a set-backed
  InstrumentedList, just like remove().

dont use assignmapper.flush()

- big fix to AssociationProxy so that multiple AssociationProxy
  objects can be associated with a single association collection.

- support for SSL arguments given as inline within URL query string,
prefixed with "ssl_", courtesy terjeros@gmail.com.