oracle+zxjdbc returning support

always visit returning clauses in the right order for positional paramstyle
sanity

dont see the need to re-call post_configure inside a reentrant loop.  since we're
in 0.6 let's just simplify.

add a really contrived test that tests the _already_compiling flag.  but this seems silly
so far.

lower call counts for 2.4, hurray

don't use the deprecated driver name

Replace HTML entities with reST markup

move postgresql's % escape handling out of base

o default Connector/J's characterEncoding=UTF-8 for generally better JDBC
unicode handling
o pass url query params down as jdbc connect opts

some doc work

0.6

- simplify MySQLIdentifierPreparer into standard pattern,
thus allowing easy subclassing
- move % sign logic for MySQLIdentifierPreparer into MySQLdb dialect
- paramterize the escape/unescape quote char in IdentifierPreparer
- cut out MySQLTableDefinitionParser cruft

- the Oracle dialect now features NUMBER which intends
to act justlike Oracle's NUMBER type.  It is the primary
numeric type returned by table reflection and attempts
to return Decimal()/float/int based on the precision/scale
parameters.  [ticket:885]

- PG: somewhat better support for % signs in table/column names;
psycopg2 can't handle a bind parameter name of
%(foobar)s however and SQLA doesn't want to add overhead
just to treat that one non-existent use case.
[ticket:1279]
- MySQL: somewhat better support for % signs in table/column names;
MySQLdb can't handle % signs in SQL when executemany() is used,
and SQLA doesn't want to add overhead just to treat that one
non-existent use case. [ticket:1279]

close out py3k + pg8000 bugs that are fixable for now without pg8000 decimal fix

python3k fixes

pull from identity_map atomically to avoid a race with weakref cleanup

o oracle+zxjdbc type handling additions
o avoid returning tests on oracle+zxjdbc for now

merge 06CHANGES into CHANGES and add more stuff

- added **kw to ClauseElement.compare(), so that we can smarten up the "use_get" operation
- many-to-one relation to a joined-table subclass now uses get()
  for a simple load (known as the "use_get" condition),
  i.e. Related->Sub(Base), without the need
  to redefine the primaryjoin condition in terms of the base
  table. [ticket:1186]
- specifying a foreign key with a declarative column,
  i.e. ForeignKey(MyRelatedClass.id) doesn't break the "use_get"
  condition from taking place [ticket:1492]

clean up the way we detect MSSQL's form of RETURNING

unwrapped _get_colparams a bit, dropped out an isinstance() call

fix up oracle tests, returning is on by default

- turned on auto-returning for oracle, some errors
- added make_transient() [ticket:1052]
- ongoing refactor of compiler _get_colparams()  (more to come)

ensure order of larger comparisons

documentation updates

- renamed PASSIVE_NORESULT to PASSIVE_NO_RESULT
- renamed PASSIVE_NO_CALLABLES to PASSIVE_NO_FETCH
- passive now propagates all the way through lazy callables,
all the way into query._get(), so that many-to-one lazy load
can load the instance via the local session but not trigger
any SQL if not available, fixes [ticket:1298] without
messing up consistency of tests added in r6201
- many-to-one also handles returning PASSIVE_NO_RESULT
for the "old" value thus eliminating the need for the
previous value even if the new value is None
- query._get() uses identity_map.get(), which has been
changed to no longer raise KeyError, thus providing
mythical time savings that didn't seem to make any
difference in how fast the unit tests ran.

Fix #1451: take into account the actual coding system when determining the field length

Fix #1429: take into account possible spurious spaces around the DEFAULT keyword

M-x whitespace-cleanup

fix some profiles for 2.4

fix non2.4 gremlin

dont need this anymore

merge 0.6 series to trunk.

disabled examples test pending necesary repairs

- UPDATE and DELETE do not support ORDER BY, LIMIT, OFFSET,
etc. in standard SQL.  Query.update() and Query.delete()
now raise an exception if any of limit(), offset(),
order_by(), group_by(), or distinct() have been
called. [ticket:1487]

- Simplified the sweep of instrumentation in strategies._register_attribute

- Improved support for MapperProperty objects overriding
that of an inherited mapper for non-concrete
inheritance setups - attribute extensions won't randomly
collide with each other.  [ticket:1488]

- Added AttributeExtension to sqlalchemy.orm.__all__

backported 0.6 r6084 fix for oracle alias names, [ticket:1309]

fix broken orm debug logging

merged [ticket:1486] fix from 0.6

Reverted my screw up of setup.cfg

Corrected examples tests. I was running from ./test instead of root.

Added in Examples into the test suite so they get exercised regularly. Cleaned up some deprecation warnings in the examples.

Corrected annoying deprecation warning on 2.6+ related to mssql and the __new__ calls.

Corrected problem with binary test on mssql. Still having issues with prepared statements.

- Squeezed a few more unnecessary "lazy loads" out of
relation().  When a collection is mutated, many-to-one
backrefs on the other side will not fire off to load
the "old" value, unless "single_parent=True" is set.
A direct assignment of a many-to-one still loads
the "old" value in order to update backref collections
on that value, which may be present in the session
already, thus maintaining the 0.5 behavioral contract.
[ticket:1483]

- Fixed bug in Table and Column whereby passing empty
dict for "info" argument would raise an exception.
[ticket:1482]

- Fixed bug whereby a load/refresh of joined table
inheritance attributes which were based on
column_property() or similar would fail to evaluate.
[ticket:1480]

- Declarative will raise an informative exception if
__table_args__ is passed as a tuple with no dict argument.
Improved documentation.  [ticket:1468]

- fixed the test for FalseDiscriminator to use Boolean for picky postgresql
- added Query.enable_assertions(False) as a mediocre solution for [ticket:1424].
updated the recipe at http://www.sqlalchemy.org/trac/wiki/UsageRecipes/PreFilteredQuery to
reflect.
- moved most default Query state to be class level variables to start.  the dicts could
go as well but being overly careful to not place mutables there for the moment.
- a visit by the "dunder-private method names aren't cool" police
- continued undisciplined pep-8ness

- Using False or 0 as a polymorphic discriminator now
works on the base class as well as a subclass.
[ticket:1440]

- Unary expressions such as DISTINCT propagate their
type handling to result sets, allowing conversions like
unicode and such to take place.  [ticket:1420]

- Improved error message when query() is called with
a non-SQL /entity expression. [ticket:1476]

beefed up documentation for count(), [ticket:1465]

- The collection proxies produced by associationproxy are now
pickleable.  A user-defined proxy_factory however
is still not pickleable unless it defines __getstate__
and __setstate__. [ticket:1446]

Fix small typos in docstring

ensure "rowswitch" for isdelete is supported

- relations() now have greater ability to be "overridden",
meaning a subclass that explicitly specifies a relation()
overriding that of the parent class will be honored
during a flush.  This is currently to support
many-to-many relations from concrete inheritance setups.
Outside of that use case, YMMV.  [ticket:1477]

- Fixed bug whereby inheritance discriminator part of a
composite primary key would fail on updates.
Continuation of [ticket:1300].

- Fixed a bug in extract() introduced in 0.5.4 whereby
the string "field" argument was getting treated as a
ClauseElement, causing various errors within more
complex SQL transformations.

Guard against a gc hitting during the sweep for dirty objects.

beefed up the description of dialects

changed reference to PostgreSQL in docs.

- remove docs about partial flush, add docs about disabling autoflush

- sqlalchemy.orm.join and sqlalchemy.orm.outerjoin are now
added to __all__ in sqlalchemy.orm.*. [ticket:1463]

- Fixed bug where Query exception raise would fail when
a too-short composite primary key value were passed to
get().  [ticket:1458]

- rearranged CHANGES for 0.5.5 to be somewhat severity based.

- commented on [ticket:1445]

updates

Formatting

Implemented recreate() for StaticPool

- Fixed potential memory leak whereby previously pickled objects
placed back in a session would not be fully garbage collected
unless the Session were explicitly closed out.

- Fixed bug whereby session.is_modified() would raise an exception
if any synonyms were in use.

- Fixed a bug involving contains_eager(), which would apply itself
to a secondary (i.e. lazy) load in a particular rare case,
producing cartesian products.   improved the targeting
of query.options() on secondary loads overall [ticket:1461].

Session.mapper is now *deprecated*.
Call session.add() if you'd like a free-standing object to be
part of your session.  Otherwise, a DIY version of
Session.mapper is now documented at
http://www.sqlalchemy.org/trac/wiki/UsageRecipes/SessionAwareMapper
The method will remain deprecated throughout 0.6.

M    test/ext/test_declarative.py
M    test/orm/test_scoping.py
M    lib/sqlalchemy/orm/scoping.py
M    CHANGES

Fix deprecated usage of  on numeric type

added docs for post_update

- repaired non-working attributes.set_committed_value function.

- Trimmed the pickle format for InstanceState which should further
reduce the memory footprint of pickled instances.  The format
should be backwards compatible with that of 0.5.4 and previous.

assoc proxy object appends to list automatically [ticket:1351]

added test to verify #1423

- Fixed bug whereby list-based attributes, like pickletype
and PGArray, failed to be merged() properly.

split CHANGES into CHANGES and CHANGES_PRE_05, since I would like CHANGES to be viewable in trac

- The "foreign_keys" argument of relation() will now propagate
automatically to the backref in the same way that
primaryjoin and secondaryjoin do.   For the extremely
rare use case where the backref of a relation() has
intentionally different "foreign_keys" configured, both sides
now need to be configured explicity (if they do in fact require
this setting, see the next note...).

- ...the only known (and really, really rare) use case where a
different foreign_keys setting was used on the forwards/backwards
side, a composite foreign key that partially points to its own
columns, has been enhanced such that the fk->itself aspect of the
relation won't be used to determine relation direction.

- unit tests have been migrated from unittest to nose.
See README.unittests for information on how to run
the tests.  [ticket:970]

- Fixed Query being able to join() from individual columns of
a joined-table subclass entity, i.e.
query(SubClass.foo, SubcClass.bar).join(<anything>).
In most cases, an error "Could not find a FROM clause to join
from" would be raised. In a few others, the result would be
returned in terms of the base class rather than the subclass -
so applications which relied on this erroneous result need to be
adjusted. [ticket:1431]

- removed test.testing.ORMTest, test.fixtures, and all
dependencies on those.

move from pXXX to 0.5.5 [ticket:1427]

- Fixed another 0.5.4 bug whereby mutable attributes (i.e. PickleType)
wouldn't be deserialized correctly when the whole object
was serialized.  [ticket:1426]

slight cleanup i want in 0.5/0.6

removed needless "thread" imports from util

- sql
    - Removed an obscure feature of execute() (including connection,
      engine, Session) whereby a bindparam() construct can be sent as
      a key to the params dictionary.  This usage is undocumented
      and is at the core of an issue whereby the bindparam() object
      created implicitly by a text() construct may have the same
      hash value as a string placed in the params dictionary and
      may result in an inappropriate match when computing the final
      bind parameters.   Internal checks for this condition would
      add significant latency to the critical task of parameter
      rendering, so the behavior is removed.  This is a backwards
      incompatible change for any application that may have been
      using this feature, however the feature has never been
      documented.

- Fixed bug introduced in 0.5.4 whereby Composite types
fail when default-holding columns are flushed.

more fixes to bound parameter exception reporting

- added unit test for exception formatting
- Deprecated the hardcoded TIMESTAMP function, which when
used as func.TIMESTAMP(value) would render "TIMESTAMP value".
This breaks on some platforms as Postgres doesn't allow
bind parameters to be used in this context.  The hard-coded
uppercase is also inappropriate and there's lots of other
PG casts that we'd need to support.  So instead, use
text constructs i.e. select(["timestamp '12/05/09'"]).

- Repaired the printing of SQL exceptions which are not
based on parameters.

- Fixed an attribute error introduced in 0.5.4 which would
occur when merge() was used with an incomplete object.

- Back-ported the "compiler" extension from SQLA 0.6.  This
is a standardized interface which allows the creation of custom
ClauseElement subclasses and compilers.  In particular it's
handy as an alternative to text() when you'd like to
build a construct that has database-specific compilations.
See the extension docs for details.

unusual ...

- The "polymorphic discriminator" column may be part of a
primary key, and it will be populated with the correct
discriminator value.  [ticket:1300]

- Reflecting a FOREIGN KEY construct will take into account
a dotted schema.tablename combination, if the foreign key
references a table in a remote schema. [ticket:1405]

- Exception messages are truncated when the list of bound
parameters is larger than 10, preventing enormous
multi-page exceptions from filling up screens and logfiles
for large executemany() statements. [ticket:1413]

- Removed all* O(N) scanning behavior from the flush() process,
i.e. operations that were scanning the full session,
including an extremely expensive one that was erroneously
assuming primary key values were changing when this
was not the case.

* one edge case remains which may invoke a full scan,
  if an existing primary key attribute is modified
  to a new value.