- added undefer_group() MapperOption, sets a set of "deferred" columns joined by a
"group" to load as "undeferred".

Added util.defaultdict for ticket #582

remove func call for getting at result proxy dialect.  func call count drops below 60K for masseagerload !

ResultProxy pre-caches the dialect_impl()s for each TypeEngine, saving the
method calls later.  knocks 5000 function calls off the masseagerload.py test.

self-referential refs in this test work just fine

- most of the __init__ decoration has been removed from mapper, save for
that the mappers all get compiled when an instance of a mapped class is first constructed.
the SessionContextExt extension gets all the "add object to the session" logic now and the
_sa_session and _sa_entity_name arguments only apply to when the SessionContextExt is in use.
Some extra methods to MapperExtension to support __init__ decoration.
- assignmapper loses "join_to", gains "join".  id like to replace all those methods with just "query"
but i think they are too popular, so it should probably get filter(), filter_by() also.

- merged "find the equivalent columns" logic together (although both methodologies are needed....)
- uniqueappender has to use a set to handle staggered joins

i just re-took 7th grade, helped a million

more speed improvements, built hotshot prof into masseagerload test

- merged trunk r2653
- small orm fixes

further minute speedups

attempting to cut down on function call overhead

some change to populate_instance etc., allows poly secondary load to re-use popoulate_instance

- refactor !  MapperProperty now has create_row_processor() method, returns
a tuple of (rowprocessor, post_processor) functions.  this is called
once per mapper per result set, given just one row (usually the first row)
in the result set, so that all MapperProperty objects can make decisions based on that row
which get saved for all successive rows.
essentially it allows lots of decision making and pre-calculations to happen per-result
instead of per-row, and decreases how much state needs to be placed in SelectContext.attributes
since the functions are closures.

- added 'fetchmode' capability to deferred polymorphic loading.
can load immediately via second select or via deferred columns.
needs work to reduce complexity and possibly to improve upon unnecessary work
performed by ColumnLoader objects hitting lots of non-existent columns
- would like to add post_exec() step to MapperProperty...but need to devise some way
such that MapperProperty instances can register themselves in the SelectContext as
requiring post_exec....otherwise we add huge method call overhead (and there is too
much already)
- fix to deferred loading so that the attributes loaded by "group" deferred loading
get proper CommittedState
- some refactoring to attributes to support setting attributes as committed

- redefined how the mapper determines primary keys.  this is to help with the new deferred
polymorphic loading.  it takes stock of all the primary keys of all of its tables in all cases,
including when a custom primary key is sent, to maximize its chances of being able to INSERT into each table.
then, whether or not the custom primary key is sent, it gathers together columns which are equivalent via
a foreign key relationship to each other or via a common parent column, similarly to how Join does it.
this continues along the path first set up from [ticket:185].  so primary keys of mappers are always
going to be "minimized" as far as number of columns.  finally, the list of pk cols is normalized to the
mapped table.  this becomes the mapper's "primary key" and is distinct from all the per-table pk column
collections.
- added "deferred poly load" versions to magazine test, cut down on table recreates in polymorph test.

- factored some fixes from trunk to lazyloader use_get, logging
- deferred inheritance loading: polymorphic mappers can be constructed *without*
a select_table argument.  inheriting mappers whose tables were not
represented in the initial load will issue a second SQL query immediately,
once per instance (i.e. not very efficient for large lists),
in order to load the remaining columns.

separate package for inheritance tests, renamed files

0.4 dev branch

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

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