changelog

- we shouldn't be raising warnings on non-unicode for String type,
even if convert_unicode=True

- fix mssql index bug, regression post 0.6.4
- dont emit unicode warning if _warn_on_bytestring is false, including
for in-python string conversion

- further fixes to no trans in progress, no trans ever for TLEngine, [ticket:1998]

various formatting and hyperlinking fixes

- Threadlocal engine methods rollback(), commit(),
prepare() won't raise if no transaction is in progress;
this was a regression introduced in 0.6.  [ticket:1998]

- gently push users towards entity name for simple cases

- add version selector

- merge current 0.6 default branch (0.6.6) to rel_0_6.   rel_0_6 branch
moves from pre-release to maintenance.

log [ticket:1978]

- ordering for tests, [ticket:1888]

- Backport of "optimized get" fix from 0.7,
improves the generation of joined-inheritance
"load expired row" behavior.  [ticket:1992]

- Fixed bug whereby KeyError would occur with non-ENUM
supported PG versions after a pool dispose+recreate
would occur, [ticket:1989]

- format guid hexstring explicit with 32 chars, [ticket:1988]

- Query.get() will raise if the number of params
in a composite key is too large, as well as too
small. [ticket:1977]
- the above change smoked out an old mistake in a unit test.

fixed a small potential memory leak in UnicodeResultProcessor (for some weird
reason, it didn't actually leak in my tests) by providing a dealloc method to
the type, and added a test to ensure it stays that way. Closes #1981.

- Fixed operator precedence rules for multiple
chains of a single non-associative operator.
I.e. "x - (y - z)" will compile as "x - (y - z)"
and not "x - y - z".  Also works with labels,
i.e. "x - (y - z).label('foo')"
[ticket:1984]
- Single element tuple expressions inside an IN clause
parenthesize correctly, also from [ticket:1984],
added tests for PG
- re-fix again importlater, [ticket:1983]

- adjust importlater to import the full path, break out of "import" problems with ImportError,
[ticket:1983]

this is new

merge tip

- SqlSoup overhaul
- Added "map_to()" method to SqlSoup, which is a "master"
method which accepts explicit arguments for each aspect of
the selectable and mapping, including a base class per
mapping. [ticket:1975]

- Mapped selectables used with the map(), with_labels(),
join() methods no longer put the given argument into the
internal "cache" dictionary.  Particularly since the
join() and select() objects are created in the method
itself this was pretty much a pure memory leaking behavior.

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