- 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.

fix for dbapi() method to be classmethod #546

a rudimental reconnect/pool auto-dispose test.  not super-comprehensive but better
than nothing, will close #516

- informix support added !  courtesy James Zhang
- tweak to oracle default execution code to use local connection for compilation
- tweak to connection.execute_text() to generate None for parameters when no params sent

- converted logger.warn() to warnings.warn()
- implemented #302

non-db identifier length raised arbitrarily high

more comprehensive query docs

rewrite....

- some docstrings
- some more test scenarios for raw bind params

- Promoted mysql's dburl query string helper to util + fixed
- Coercing sqlite connect args provided in query string to their expected type
  (e.g. 'timeout' as float, fixes #544)
- Coerce mysql's client_flag to int too

support positional parameters at the execute level even for DBs where we dont expect positional

unit test with just one param

some changelog

- merged in the combined patch for #474, #475, #476 (attached to #476) and a new set of tests

- fixed issue where slice assignment on relation properties truncates the relation (#529)
- fix for #530, don't require collection classes to respond to len requests

- tweak to restore Python 2.3 compatability

some docstrings

- the "where" criterion of an update() and delete() now correlates
embedded select() statements against the table being updated or
deleted.  this works the same as nested select() statement
correlation, and can be disabled via the correlate=False flag on
the embedded select().

- fixed critical issue when, after options(eagerload()) is used,
the mapper would then always apply query "wrapping" behavior
for all subsequent LIMIT/OFFSET/DISTINCT queries, even if no
eager loading was applied on those subsequent queries.

added "is_disconnect()" for firebird

- making progress with session.merge() as well as combining its
usage with entity_name [ticket:543]

note about elixir

slight cleanup for #498

- the dialects within sqlalchemy.databases become a setuptools
entry points. loading the built-in database dialects works the
same as always, but if none found will fall back to trying
pkg_resources to load an external module [ticket:521]

docs/examples for new with_parent() feature

- added query.with_parent(someinstance) method.  searches for
target instance using lazy join criterion from parent instance.
takes optional string "property" to isolate the desired relation.
also adds static Query.query_from_parent(instance, property)
version. [ticket:541]

added "recreate()" argument to connection pool classes
this method is called when the invalidate() occurs for a disconnect condition,
so that the entire pool is recreated, thereby avoiding repeat errors on
remaining connections in the pool.
dispose() called as well (also fixed up) but cant guarantee all connections closed.

- removed meaningless entity_name argument from session.delete()
- session.merge() propigates given entity_name to locate that mapper if the given object
is transient (and therefore has no entity_name)
- some fixes to MockEngine which still is mostly useless for most cases.
- unitofwork test used incorrect session.delete() signature

- got unicode schemas to work with postgres
- unicode schema with mysql slightly improved, still cant do has_table
- got reflection of unicode schemas working with sqlite, pg, mysql

more docstrings stuff

added ansisql docs to output, moved exceptions to a more reasonable location

didnt need that method...

some docstrings to provide more detail in the sql package

- small fix to allow successive compiles of the same SELECT object
which features LIMIT/OFFSET.  oracle dialect needs to modify
the object to have ROW_NUMBER OVER and wasn't performing
the full series of steps on successive compiles.

[ticket:534] get dictionary append() method properly

- the "mini" column labels generated when using subqueries, which
are to work around glitchy SQLite behavior that doesnt understand
"foo.id" as equivalent to "id", are now only generated in the case
that those named columns are selected from (part of [ticket:513])
- MS-SQL better detects when a query is a subquery and knows not to
generate ORDER BY phrases for those [ticket:513]

- fix to many-to-many relationships targeting polymorphic mappers
[ticket:533]

will be 0.3.7

- some cleanup of reflection unit tests
- removed silly behavior where sqlite would reflect UNIQUE indexes
as part of the primary key (?!)
- added __contains__ support to ColumnCollection; contains_column() method should be removed

explicit zero was failing for float cols

- slight tweak to raw execute() change to also support tuples,
not just lists [ticket:523]

for #516, moved the "disconnect check" step out of pool and back into base.py.  dialects have
is_disconnect() method now.  simpler design which also puts control of the ultimate "execute" call back into the hands of the dialects.

- merged the patch from #516 + fixes
- improves the framework for auto-invalidation of connections that have
lost their underlying database - the error catching/invalidate
step is totally moved to the connection pool.
- added better condition checking for do_rollback() and do_commit() including
SQLError excepetion wrapping

- merged the "execcontext" branch, refactors engine/dialect codepaths
- much more functionality moved into ExecutionContext, which impacted
the API used by dialects to some degree
- ResultProxy and subclasses now designed sanely
- merged patch for #522, Unicode subclasses String directly,
MSNVarchar implements for MS-SQL, removed MSUnicode.
- String moves its "VARCHAR"/"TEXT" switchy thing into
"get_search_list()" function, which VARCHAR and CHAR can override
to not return TEXT in any case (didnt do the latter yet)
- implements server side cursors for postgres, unit tests, #514
- includes overhaul of dbapi import strategy #480, all dbapi
importing happens in dialect method "dbapi()", is only called
inside of create_engine() for default and threadlocal strategies.
Dialect subclasses have a datamember "dbapi" referencing the loaded
module which may be None.
- added "mock" engine strategy, doesnt require DBAPI module and
gives you a "Connecition" which just sends all executes to a callable.
can be used to create string output of create_all()/drop_all().

latest #214 fixups

- query strings in unicode URLs get keys encoded to ascii
for **kwargs compat

thank you, SVN, for being completely idiotic and non-intutive. rolling back incorrect checkin to trunk

current progress with exec branch

- corresponding to label/bindparam name generataion, eager loaders
generate deterministic names for the aliases they create using
md5 hashes.

added example for expressions in updates

ordering adjustments

added keys() to ColumnParameters, needed for setbindparamsizes traversal

- sending None as an argument to func.<something> will produce
an argument of NULL

unit test fix, same child object was being attached to two parents in a one-to-many which produced inconsistent results

better explicit PK insert checking

Change to ParameterClause object change
New syntax for adodbapi connection string with port

error raised if trying to auto-join on a self referential

added "supports_unicode_statements()" step to dialect/execute_raw so that DB's like oracle can opt out of unicode statement strings

- column label and bind param "truncation" also generate
deterministic names now, based on their ordering within the
full statement being compiled.  this means the same statement
will produce the same string across application restarts and
allowing DB query plan caching to work better.
- cleanup to sql.ClauseParameters since it was just falling
apart, API made more explicit
- many unit test tweaks to adjust for bind params not being
"pre" truncated, changes to ClauseParameters

added label truncation for bind param names which was lost in the previous related commit.
added more tests plus test for column targeting with text() clause.