merge

Remove unused import.

DecimalResultProcessor memory testing is likely to catch something only when cextensions are enabled.  [ticket:1978]

Shorter tests for [ticket:1978]

- modernize MutableTypesTest, add tests for expired/deferred to establish 0.6 behavior
regarding [ticket:1976]

- active_history flag also added to composite().
The flag has no effect in 0.6, but is instead
a placeholder flag for forwards compatibility,
as it will be needed in 0.7 for composites.
[ticket:1976]

Fix memory leaks in the cprocessors DecimalResultProcessor, including tests.  [ticket:1978]

skip on 2.4

- remove really old, redundant test

- Added as_uuid=True flag to the UUID type, will receive
and return values as Python UUID() objects rather than
strings.  Currently, the UUID type is only known to
work with psycopg2.  [ticket:1956]

- Ensured every numeric, float, int code, scalar + array,
are recognized by psycopg2 and pg8000's "numeric"
base type. [ticket:1955]

- fix test specification for oracle euro test

- Added active_history flag to relationship()
and column_property(), forces attribute events to
always load the "old" value, so that it's available to
attributes.get_history(). [ticket:1961]
- modernize test_relationship, give test classes meaningful names

- The mapper argument "primary_key" can be passed as a
single column as well as a list or tuple.  [ticket:1971]

- The cx_oracle "decimal detection" logic, which takes place
for for result set columns with ambiguous numeric characteristics,
now uses the decimal point character determined by the locale/
NLS_LANG setting, using an on-first-connect detection of
this character.  cx_oracle 5.0.3 or greater is also required
when using a non-period-decimal-point NLS_LANG setting.
[ticket:1953].

- An error is raised if __table_args__ is not in tuple
or dict format, and is not None.  [ticket:1972]

- primary_key arg to mapper() is a list
- other modernizations to mapper() doc

- Added a bind processor for booleans which coerces
to int, for DBAPIs such as pymssql that naively call
str() on values.

- Fixed indexing of Query objects by -1. It was erroneously
transformed to the empty slice -1:0 that resulted in
IndexError. [ticket:1968]

- add a few choice TypeDecorator recipes

- add helpstring for site-mako

- The 'info' attribute of Column is copied during
Column.copy(), i.e. as occurs when using columns
in declarative mixins.  [ticket:1967]

- move inline "import" statements to use new "util.importlater()" construct.  cuts
down on clutter, timeit says there's a teeny performance gain, at least where
the access is compared against attr.subattr.  these aren't super-critical
calls anyway
- slight inlining in _class_to_mapper

- additional fix for [ticket:1964]
- [ticket:1965] is invalid

- nose3 seems to support "addplugins" now
- add a note about sqla_nose.py

comment

- On the same theme, the REFERENCES clause in a CREATE TABLE
that includes a remote schema to a *different* schema
than that of the parent table doesn't render at all,
as cross-schema references do not appear to be supported.

- The REFERENCES clause in a CREATE TABLE that includes
a remote schema name now renders the remote name without
the schema clause, as required by SQLite.  [ticket:1851]

whoopsie

- Fixed bug regarding "subqueryload" strategy whereby
strategy would fail if the entity was an aliased()
construct.  [ticket:1964]

stupid tab got committed

add a note to use column_property with declarative map to a join

- and fix everything from the last checkin that breaks on py 2.4, 2.5

- Implemented sequence check capability for the C
version of RowProxy, as well as 2.7 style
"collections.Sequence" registration for RowProxy.
[ticket:1871]

- "innerjoin" flag doesn't take effect along the chain
of joinedload() joins if a previous join in that chain
is an outer join, thus allowing primary rows without
a referenced child row to be correctly returned
in results.  [ticket:1954]

- mysql
  - Fixed error handling for Jython + zxjdbc, such that
    has_table() property works again.  Regression from
    0.6.3 (we don't have a Jython buildbot, sorry)
    [ticket:1960]

further edits

- write a new section describing the "subtransactions=True" flag in full detail

- Fixed bug whereby a non-"mutable" attribute modified event
which occurred on an object that was clean except for
preceding mutable attribute changes would fail to strongly
reference itself in the identity map. This would cause the
object to be garbage collected, losing track of any changes
that weren't previously saved in the "mutable changes"
dictionary.

- engine status updates

Added tag rel_0_6_5 for changeset b96e6232a42918692e95b32b7dd3723cd4a242bb

cleanup most egregiously long lines

- remove remaining create_session() calls from examples, replace with Session
- replace all flush()/expunge_all() with commit()

- mssql+pymssql dialect now honors the "port" portion
of the URL instead of discarding it.  [ticket:1952]
- testing.only_on() accepts db specs optionally as a list

- Rewrote the reflection of indexes to use sys.
catalogs, so that column names of any configuration
(spaces, embedded commas, etc.) can be reflected.
Note that reflection of indexes requires SQL
Server 2005 or greater.  [ticket:1770]

- make a futile attempt to combat the needless usage of clear_mappers() in the wild,
[ticket:1861]

- Added type_coerce(expr, type_) expression element.
Treats the given expression as the given type when evaluating
expressions and processing result rows, but does not
affect the generation of SQL, other than an anonymous label.

- Oracle - the implicit_retunring argument to create_engine()
is now honored regardless of detected version of
Oracle.  Previously, the flag would be forced
to False if server version info was < 10.
[ticket:1878]

fix typo

- New Query methods: query.label(name), query.as_scalar(),
return the query's statement as a scalar subquery
with /without label [ticket:1920];
query.with_entities(*ent), replaces the SELECT list of
the query with new entities.
Roughly equivalent to a generative form of query.values()
which accepts mapped entities as well as column
expressions.

- A mixin can now specify a column that overrides
a column of the same name associated with a superclass.
Thanks to Oystein Haaland.

- Fixed bug in TypeDecorator whereby the dialect-specific
type was getting pulled in to generate the DDL for a
given type, which didn't always return the correct result.

- TypeDecorator can now have a fully constructed type
specified as its "impl", in addition to a type class.

- TypeDecorator will now place itself as the resulting
type for a binary expression where the type coercion
rules would normally return its impl type - previously,
a copy of the impl type would be returned which would
have the TypeDecorator embedded into it as the "dialect"
impl, this was probably an unintentional way of achieving
the desired effect.

- TypeDecorator.load_dialect_impl() returns "self.impl" by
default, i.e. not the dialect implementation type of
"self.impl".   This to support compilation correctly.
Behavior can be user-overridden in exactly the same way
as before to the same effect.

- document is_modified() caveats including that the "old" value isn't always
present, and that this results in a positive response for "changed"
[ticket:1928]

- Fixed mysql bug involving reflection of CURRENT_TIMESTAMP
default used with ON UPDATE clause, thanks to
Taavi Burns [ticket:1940]

- Fixed bug which prevented "domain" built from a
custom type such as "enum" from being reflected.
[ticket:1933]

merge tip

- Added "as_tuple" flag to pg ARRAY type, returns results
as tuples instead of lists to allow hashing.

- Fixed bug where aliasing of tables with "schema" would
fail to compile properly.  [ticket:1943]

Update for new nose plugin location.

- the NoseSQLAlchemyPlugin has been moved to a
new package "sqlalchemy_nose" which installs
along with "sqlalchemy".  This so that the "nosetests"
script works as always but also allows the
--with-coverage option to turn on coverage before
SQLAlchemy modules are imported, allowing coverage
to work correctly.
- added some new ignores

- forgot to add the immediate loader tests

edit

note expire_on_commit in the docstring for commit() as well

- Fixed MSSQL reflection bug which did not properly handle
reflection of unknown types.  [ticket:1946]

- Added a new "lazyload" option "immediateload".
Issues the usual "lazy" load operation automatically
as the object is populated.   The use case
here is when loading objects to be placed in
an offline cache, or otherwise used after
the session isn't available, and straight 'select'
loading, not 'joined' or 'subquery', is desired.
[ticket:1914]

 - engine_from_config() now accepts 'debug' for
'echo', 'echo_pool', 'force' for 'convert_unicode',
boolean values for 'use_native_unicode'.
[ticket:1899]

- Fixed labeling bug in Query whereby the NamedTuple
would mis-apply labels if any of the column
expressions were un-labeled.

warn when two classes with the same name end up in the declarative registry

document creating indexes for columns in mixins

- default compilation of a type will check if the type class's module is
inside of sqlalchemy.dialects, in which case that dialect's default
will be used instead of DefaultDialect.

- added "views=True" option to metadata.reflect(),
will add the list of available views to those
being reflected.  [ticket:1936]

- this test began working for oracle as of r14af1f73fbbd.   Additionally,
the operation wasn't actually "working" on sqlite, mysql prior to that
rev, but no assertions checked. added assertions for those.

- *Major* cleanup / modernization of the Informix
dialect for 0.6, courtesy Florian Apolloner.
[ticket:1906]

- Fixed bug in query.update() where 'evaluate' or 'fetch'
expiration would fail if the column expression key was
a class attribute with a different keyname as the
actual column name.  [ticket:1935]

correct that only MySQL doesn't support CHECK constraints, [ticket:1927]

- Make it clear that the second mapping of User is against User.__table__, [ticket:1934]

- add additional logic that duplicates mapper's prop.copy(); prop.columns.append(col)
logic when columns are present in a joined subclass with an attribute name different
than the column name itself [ticket:1931]
- add coverage to verify that we need to check (obj.name or name) when
deciding if a Column from a mixin should be added to the mapped table

- reworked the internals of mapper.cascade_iterator() to
cut down method calls by about 9% in some circumstances.
[ticket:1932]

py2.4 didn't seem to like super() on an exception

don't need itertools here

- CircularDependencyError now has .cycles and .edges
members, which are the set of elements involved in
one or more cycles, and the set of edges as 2-tuples.
[ticket:1890]

- add Sphinx 1.0 makefile and config options, [ticket:1929]

- Fixed bug whereby columns on a mixin wouldn't propagate
correctly to a single-table inheritance scheme where
the attribute name is different than that of the column.
[ticket:1930].   Note [ticket:1931] which is the same
issue for joined inh, not yet resolved.

@mapperproperty -> @declared_attr

for internal link to top render #

- @classproperty 's official name/location for usage
with declarative is sqlalchemy.ext.declarative.mapperproperty.
Same thing, but moving there since it is more of a
"marker" that's specific to declararative,
not just an attribute technique.  [ticket:1915]

- Fixed recursion overflow which could occur when operating
with two expressions both of type "NullType", but
not the singleton NULLTYPE instance. [ticket:1907]

- fix a typo that was apparently not really impacting anything

fix the default here

merge tip

- optimized_al doesn't need mapper extension
- convert to non-bound metadata, Session, session.commit()

make less ficticious ;-)

doc edits

doc edits

- in depth docs about some merge() tips
- docs about backref cascade
- Another new flag on relationship(), cascade_backrefs,
disables the "save-update" cascade when the event was
initiated on the "reverse" side of a bidirectional
relationship.   This is a cleaner behavior so that
many-to-ones can be set on a transient object without
it getting sucked into the child object's session,
while still allowing the forward collection to
cascade.   We *might* default this to False in 0.7.

- Query.select_from() has been beefed up to help
ensure that a subsequent call to query.join()
will use the select_from() entity, assuming it's
a mapped entity and not a plain selectable,
as the default "left" side, not the first entity
in the Query object's list of entities.

use default dialect for compile tests

- the logging message emitted by the engine when
a connection is first used is now "BEGIN (implicit)"
to emphasize that DBAPI has no explicit begin().

- Patched a case where query.join() would adapt the
right side to the right side of the left's join
inappropriately [ticket:1925]

- scoped_session emits a warning when configure() is
called if a Session is already present (checks only the
current thread) [ticket:1924]