- Custom comparator classes used in conjunction with
column_property(), relation() etc. can define
new comparison methods on the Comparator, which will
become available via __getattr__() on the
InstrumentedAttribute.   In the case of synonym()
or comparable_property(), attributes are resolved first
on the user-defined descriptor, then on the user-defined
comparator.

Modified UOW so that a Row Switch scenario will not attempt to update the Primary Key.

Cleanup of r5556. Makes the description_encoding less public since this is a
workaround for the pyodbc dbapi.

emacs

yes ive been watching the IRC channel.  restored setup_instance() to ClassManager and added coverage for mapper's usage of it.

- added an extremely basic illustration of a PostGIS
integration to the examples folder.

Modifications to the mssql dialect in order to to pass through unicode in the pyodbc dialect.

Added a new description_encoding attribute on the dialect.

This is used for encoding the column name when processing the metadata. This
usually defaults to utf-8.

A few 2.3 cleanup items.

Added in MSGenericBinary to the mssql dialect tests.

- added another usage recipe for contains_eager()
- some typos

  - Added OracleNVarchar type, produces NVARCHAR2, and also
      subclasses Unicode so that convert_unicode=True by default.
      NVARCHAR2 reflects into this type automatically so
      these columns pass unicode on a reflected table with no explicit
      convert_unicode=True flags.  [ticket:1233]

- Can pass mapped attributes and column objects as keys
to query.update({}).  [ticket:1262]

- Mapped attributes passed to the values() of an
expression level insert() or update() will use the
keys of the mapped columns, not that of the mapped
attribute.

Added in a new MSGenericBinary type.

This maps to the Binary type so it can implement the specialized behavior of
treating length specified types as fixed-width Binary types and non-length
types as an unbound variable length Binary type.

- RowProxy objects can be used in place of dictionary arguments
sent to connection.execute() and friends.  [ticket:935]

- Fixed shard_id argument on ShardedSession.execute().
[ticket:1072]

Corrected reflection issue in mssql where include_columns doesn't include the PK.

On MSSQL if a field is part of the primary_key then it should not allow NULLS.

MSSQL refactoring of BINARY type and addition of MSVarBinary and MSImage.

- Added in new types: MSVarBinary and MSImage
- Modified MSBinary to now return BINARY instead of IMAGE. This is a
  backwards incompatible change. Closes #1249.

- added a full exercising test for all of #946, #947, #948, #949

- Added a mutex for the initial pool creation when
using pool.manage(dbapi).  This prevents a minor
case of "dogpile" behavior which would otherwise
occur upon a heavy load startup.  [ticket:799]

- Added ScopedSession.is_active accessor. [ticket:976]

- NullPool supports reconnect on failure behavior.
[ticket:1094]

- Reflected foreign keys will properly locate
their referenced column, even if the column
was given a "key" attribute different from
the reflected name.  This is achieved via a
new flag on ForeignKey/ForeignKeyConstraint
called "link_to_name", if True means the given
name is the referred-to column's name, not its
assigned key.
[ticket:650]
- removed column types from sqlite doc, we
aren't going to list out "implementation" types
since they aren't significant and are less present
in 0.6
- mysql will report on missing reflected foreign
key targets in the same way as other dialects
(we can improve that to be immediate within
reflecttable(), but it should be within
ForeignKeyConstraint()).
- postgres dialect can reflect table with
an include_columns list that doesn't include
one or more primary key columns

fix imports for index reflection unit test

Fixed bugs in sqlalchemy documentation. Closes #1263.

- Exceptions raised during compile_mappers() are now
preserved to provide "sticky behavior" - if a hasattr()
call on a pre-compiled mapped attribute triggers a failing
compile and suppresses the exception, subsequent compilation
is blocked and the exception will be reiterated on the
next compile() call.  This issue occurs frequently
when using declarative.

use new anonymize style for the public _anonymize as well

Added MSSQL support for introspecting the default schema name for the logged in user. Thanks Randall Smith. Fixes #1258.

silly negative ID numbers on linux...

- Added Index reflection support to Postgres, using a
great patch we long neglected, submitted by
Ken Kuhlman. [ticket:714]

Merge branch 'collation'

- Columns can again contain percent signs within their
names. [ticket:1256]

Major refactoring of the MSSQL dialect. Thanks zzzeek.
Includes simplifying the IDENTITY handling and the exception handling. Also
includes a cleanup of the connection string handling for pyodbc to favor
the DSN syntax.

also check for primaryjoin/secondaryjoin that equates to False, [ticket:1087]

- CHANGES update
- added slightly more preemptive message for bad remote_side

- Fixed mysql bug in exception raise when FK columns not present
during reflection. [ticket:1241]

fix unittest import

Pulled callable into testlib because path fixup is not available at the point we need it.

Corrected ColumnsTest for mssql's new explicit nullability behavior.

removed the "create_execution_context()" method from dialects and replaced
with a more succinct "dialect.execution_ctx_cls" member

more platform neutral way of getting at 'buffer'

missed an ordering on a set.   attempting to nail down linux-specific buildbot errors

and try again

2.4 doesnt have hashlib....

*most* py3k warnings are resolved, with the exception of the various __setslice__ related warnings
I don't really know how to get rid of

merge the test/ directory from -r5438:5439 of py3k_warnings branch.  this gives
us a 2.5-frozen copy of unittest so we're insulated from unittest changes.

merged -r5299:5438 of py3k warnings branch.  this fixes some sqlite py2.6 testing issues,
and also addresses a significant chunk of py3k deprecations.  It's mainly
expicit __hash__ methods.  Additionally, most usage of sets/dicts to store columns uses
util-based placeholder names.

dynamic_loader() accepts query_class= to mix in user Query subclasses.

Association proxies no longer cloak themselves at the class level.

- Query() can be passed a "composite" attribute
as a column expression and it will be expanded.
Somewhat related to [ticket:1253].
- Query() is a little more robust when passed
various column expressions such as strings,
clauselists, text() constructs (which may mean
it just raises an error more nicely).
- select() can accept a ClauseList as a column
in the same way as a Table or other selectable
and the interior expressions will be used as
column elements. [ticket:1253]
- removed erroneous FooTest from test/orm/query

-This line, and those below, will be ignored--

M    test/orm/query.py
M    test/orm/mapper.py
M    test/sql/select.py
M    lib/sqlalchemy/orm/query.py
M    lib/sqlalchemy/sql/expression.py
M    CHANGES

document ConnectionProxy

- _execute_clauseelement() goes back to being
a private method.  Subclassing Connection
is not needed now that ConnectionProxy
is available.
- tightened the interface for the various _execute_XXX()
methods to reduce ambiguity
- __distill_params() no longer creates artificial [{}] entry,
blank dict is no longer passed through to do_execute()
in any case unless explicitly sent from the outside
as in connection.execute("somestring"), {})
- fixed a few old sql.query tests which were doing that
- removed needless do_execute() from mysql dialect
- fixed charset param not properly being sent to
_compat_fetchone() in mysql

- sqlite types
- fixed targeting for sqlalchemy.types

- Fixed bug where many-to-many relation() with
viewonly=True would not correctly reference the
link between secondary->remote.

- added sphinx handler to allow __init__ methods through
- sqlite module documentation
- some corrections to pool docs
- the example in URL.translate_connect_args() never made any sense anyway so removed it

polymorphic_fetch is deprecated. Mark it so in the documentation.

ok we need find_packages.  fine.

corrections

removed dependencies on setuptools.  distutils will be used if setuptools is not
present.

Corrected output on docs and a missing {stop} that prevented python results from displaying in the docs.

Support for three levels of column nullability: NULL, NOT NULL, and the database's configured default.

The default Column configuration (nullable=True) will now generate NULL in the DDL. Previously no specification was emitted and the database default would take effect (usually NULL, but not always).  To explicitly request the database default, configure columns with nullable=None and no specification will be emitted in DDL. Fixes #1243.

Modified fails_on testing decorator to take a reason for the failure.

This should assist with helping to document the reasons for testing failures.
Currently unspecified failures are defaulted to 'FIXME: unknown'.

Corrected and verified a few more mssql tests.

Broke out a specific values test and indicated that it fails on mssql due to duplicate columns in the order by clause.

- turn __visit_name__ into an explicit member.
[ticket:1244]

Index entries for thread safety.

And now for the CHANGES.

Corrected problem with bindparams not working properly with Query.delete and Query.update. Thanks zzzeek. Fixes #1242.

We don't need two of these.

Access doesn't support savepoints or two-phase commit.

Implemented experimental savepoint support in mssql. There are still some failing savepoint related tests.

fix circular import

- Connection.invalidate() checks for closed status
to avoid attribute errors. [ticket:1246]

- PickleType now favors == comparison by default,
if the incoming object (such as a dict) implements
__eq__().  If the object does not implement
__eq__() and mutable=True, a deprecation warning
is raised.

- fixed string-based "remote_side", "order_by" and
others not propagating correctly when used in
backref().

- VERSION moves just as a string in __version__
- added modified sphinx.sty with plain Verbatim section
- link to pdf doc in site

- first() works as expected with Query.from_statement().

- reworked the "SQL assertion" code to something more flexible and based off of ConnectionProxy.  upcoming changes to dependency.py
will make use of the enhanced flexibility.

dont use names to find Annotated subclasses

- restored the previous API Reference structure
- bumped latex TOC structure, the PDF looks great
- but we need to fix the translate_connect_args docstring bug to really have PDF

fix typos

- removed redundant declarative docs
- cleanup of metadata/foreignkey docs

further fix that docstring

fixed invalid docstring example

- restored the main search form
- fixed search highlighting
- the url docstring works again from a ReST perspective, still not PDF

- moved index.rst around to have the API docs right there, no "Main Documentation" chapter which is fairly needless.  this all allows PDF to have a decent TOC on the side with only two levels (can we change that ?)
- added LatexFormatter.
- PDF wont work until issue with the docstirng in url.py/URL.translate_connect_args is fixed.

worked schema into sections

- convert __init__ and :members: to be compatible with autoclass_content='both'

fix typos

documented onupdate, partially documented server_onupdate

- re-documented Table and Column constructors, fixed case sensitivity description [ticket:1231]
- turned on autoclass_content="both".  Need to specify __init__ docstring with a newline after the """.
- other docs

Adjusted basis for refs.

- removed creepy exec call for now
- removed unnecessary isinstance() from class_mapper()
- removed unnecessary and py3k incompatible "dictionary sort" from association table delete

need to use absolutes for these, otherwise its dictionary ordering roulette

- postgres docstring
- insert/update/delete are documented generatively
- values({}) is no longer deprecated, thus enabling
unicode/Columns as keys

Enabled sphinx doctests.

remove old files

- merged -r5338:5429 of sphinx branch.
- Documentation has been converted to Sphinx.
In particular, the generated API documentation
has been constructed into a full blown
"API Reference" section which organizes
editorial documentation combined with
generated docstrings.   Cross linking between
sections and API docs are vastly improved,
a javascript-powered search feature is
provided, and a full index of all
classes, functions and members is provided.

- union() and union_all() will not whack
any order_by() that has been applied to the
select()s inside.  If you union() a
select() with order_by() (presumably to support
LIMIT/OFFSET), you should also call self_group()
on it to apply parenthesis.