Maul the evaulate & friends typo

(cherry picked from commit 8ae47dc6e0a98b359247040236be0810b9086f40)

Conflicts:
doc/build/changelog/changelog_10.rst
doc/build/changelog/migration_10.rst
lib/sqlalchemy/ext/declarative/base.py

- Fixed bug where using a :class:`.TypeDecorator` that implemented
a type that was also a :class:`.TypeDecorator` would fail with
Python's "Cannot create a consistent method resolution order (MRO)"
error, when any kind of SQL comparison expression were used against
an object using this type.

(cherry picked from commit d1ac6cb33af3b105db7cdb51411e10ac3bafff1f)

- Added a version check to the MySQLdb dialect surrounding the
check for 'utf8_bin' collation, as this fails on MySQL server < 5.0.
fixes #3274

(cherry picked from commit 00aaaa4bd4aa150ff9964bf2c00b1404d2e8a140)

- automap isn't new anymore

- Added new method :meth:`.Session.invalidate`, functions similarly
to :meth:`.Session.close`, except also calls
:meth:`.Connection.invalidate`
on all connections, guaranteeing that they will not be returned to
the connection pool.  This is useful in situations e.g. dealing
with gevent timeouts when it is not safe to use the connection further,
even for rollbacks.
references #3258

(cherry picked from commit cf7981f60d485f17465f44c6ff651ae283ade377)

- fix up query update /delete documentation, make warnings
a lot clearer, partial fixes for #3252

(cherry picked from commit 3c70f609507ccc6775495cc533265aeb645528cd)

Conflicts:
lib/sqlalchemy/orm/query.py

Removing unneeded space.
(cherry picked from commit c86c593ec3b913361999a1970efae3e6f3d831fa)

pep8

(cherry picked from commit 95cd2003bbe1b5da2d3c78ac845855126e03de2f)

- pep8

(cherry picked from commit ec6214457ed71f0ae87d83076e084214650aae5d)

Conflicts:
test/dialect/test_sqlite.py

- pep8 cleanup

(cherry picked from commit 6e53e866dea4eba630128e856573ca1076b91611)

- Updated the :ref:`examples_versioned_history` example such that
mapped columns are re-mapped to
match column names as well as grouping of columns; in particular,
this allows columns that are explicitly grouped in a same-column-named
joined inheritance scenario to be mapped in the same way in the
history mappings, avoiding warnings added in the 0.9 series
regarding this pattern and allowing the same view of attribute
keys.

(cherry picked from commit de62497b03274c860ea2554dfbacb3064ce02c19)

- formatting

(cherry picked from commit a88be57fb7ef96e914d8a7fb90de375ec7f0befd)

- fix minor spelling error

(cherry picked from commit 5fd779df0c958dc1ec2766f55d80b3090d2427eb)

added docs to clarify that sql statement is already in a dialect

(cherry picked from commit 0f5a400b77862d2ae8f5d1a326fe9571da8fc0cb)

- add an order_by here

(cherry picked from commit fb06fa9d6e6f6da8eee5b7dfc196c3e12761da61)

- Fixed a bug in the examples/generic_assocaitions/discriminator_on_association.py
example, where the subclasses of AddressAssociation were not being
mapped as "single table inheritance", leading to problems when trying
to use the mappings further.

(cherry picked from commit 2098001ad3e0a40aa909a347ec91c12fab04a657)

- Fixed a leak which would occur in the unsupported and highly
non-recommended use case of replacing a relationship on a fixed
mapped class many times, referring to an arbitrarily growing number of
target mappers.  A warning is emitted when the old relationship is
replaced, however if the mapping were already used for querying, the
old relationship would still be referenced within some registries.
fixes #3251

- Fixed issue where the columns from a SELECT embedded in an
INSERT, either through the values clause or as a "from select",
would pollute the column types used in the result set produced by
the RETURNING clause when columns from both statements shared the
same name, leading to potential errors or mis-adaptation when
retrieving the returning rows.
fixes #3248

- we aren't changing .key behavior yet here, this is just documentation

- in lieu of adding a new system of translating bound parameter names
for psycopg2 and others, encourage users to take advantage of positional
styles by documenting "paramstyle".   A section is added to psycopg2
specifically as this is a pretty common spot for named parameters
that may be unusually named.  fixes #3246.

- edits to the subqueryload ordering merge

Added documentation about interaction between `subqueryload` and LIMIT/OFFSET.

- missing import

- Fixed bug regarding expression mutations which could express
itself as a "Could not locate column" error when using
:class:`.Query` to  select from multiple, anonymous column
entities when querying against SQLite, as a side effect of the
"join rewriting" feature used by the SQLite dialect.
fixes #3241

- added new backend for pysqlcipher, as we will probably get
requests for it soon.

- Fixed bug where the ON clause for :meth:`.Query.join`,
and :meth:`.Query.outerjoin` to a single-inheritance subclass
using ``of_type()`` would not render the "single table criteria" in
the ON clause if the ``from_joinpoint=True`` flag were set.
fixes #3232

Conflicts:
test/orm/inheritance/test_single.py

- repair documenation for object_session(), returns None if no
session, and refer to InstanceState.session.  Add note about
objects that are deleted within an ongoing transaction.

- flake8

Conflicts:
test/orm/test_relationships.py

Fixed typo

0.9.8

- additional issues fixed in mysqlconnector 2.0.1

- this test passes now in more recent mysqlconnector

- Mysqlconnector as of version 2.0, probably as a side effect of
the  python 3 merge, now does not expect percent signs (e.g.
as used as the modulus operator and others) to be doubled,
even when using the "pyformat" bound parameter format (this
change is not documented by Mysqlconnector).  The dialect now
checks for py2k and for mysqlconnector less than version 2.0
when detecting if the modulus operator should be rendered as
``%%`` or ``%``.
- Unicode SQL is now passed for MySQLconnector version 2.0 and above;
for Py2k and MySQL < 2.0, strings are encoded.  Note that mysqlconnector
as of 2.0.1 appears to have a bug with unicode DDL on py2k, so the tests here
are skipping until we observe it's fixed.
- take out profiling on mysqlconnector, callcounts vary too much with
its current development speed

Conflicts:
test/profiles.txt

- embedding an existing predicate into a new one only
seems to be used by test_oracle->test_coerce_to_unicode().  The
predicate here should treat as a lambda based on enabled_for_config.
not sure why this test is not failing on jenkins

- Fixed long-standing bug in Oracle dialect where bound parameter
names that started with numbers would not be quoted, as Oracle
doesn't like numerics in bound parameter names.
fixes #2138

- fix the marker here so this page can be found
- clarify the note about the defaults, note that it's upcoming in 1.0

- apply patches to correct for + sign in with_hint() docs,
fixes #3036

- Fixed bug where a fair number of SQL elements within
the sql package would fail to ``__repr__()`` successfully,
due to a missing ``description`` attribute that would then invoke
a recursion overflow when an internal AttributeError would then
re-invoke ``__repr__()``.
fixes #3195

- clean up unicode docs and clarify that client_encoding
at the engine level is not the same thing as at the connect args
level.

- adjustment for ref #3200 as we need an immutabledict() here so
that union() can be called, in the case of a dialect that uses
execution options inside of initialize() (e.g. oursql)

- Fixed "'NoneType' object has no attribute 'concrete'" error
when using :class:`.AbstractConcreteBase` in conjunction with
a subclass that declares ``__abstract__``.
fixes #3185

Conflicts:
test/ext/declarative/test_inheritance.py

- The execution options passed to an :class:`.Engine` either via
:paramref:`.create_engine.execution_options` or
:meth:`.Engine.update_execution_options` are not passed to the
special :class:`.Connection` used to initialize the dialect
within the "first connect" event; dialects will usually
perform their own queries in this phase, and none of the
current available  options should be applied here.  In
particular, the "autocommit" option was causing an attempt to
autocommit within this initial connect which would fail with
an AttributeError due to the non-standard state of the
:class:`.Connection`.
fixes #3200

- rework tests for attached databases into individual tests,
test both memory and file-based
- When selecting from a UNION using an attached database file,
the pysqlite driver reports column names in cursor.description
as 'dbname.tablename.colname', instead of 'tablename.colname' as
it normally does for a UNION (note that it's supposed to just be
'colname' for both, but we work around it).  The column translation
logic here has been adjusted to retrieve the rightmost token, rather
than the second token, so it works in both cases.   Workaround
courtesy Tony Roberts.
fixes #3211

- A revisit to this issue first patched in 0.9.5, apparently
psycopg2's ``.closed`` accessor is not as reliable as we assumed,
so we have added an explicit check for the exception messages
"SSL SYSCALL error: Bad file descriptor" and
"SSL SYSCALL error: EOF detected" when detecting an
is-disconnect scenario.   We will continue to consult psycopg2's
connection.closed as a first check.
fixes #3021

- flake8

- add explicit warning re: polymorphic_on, cascading is not supported
at this time.  ref #3214

- clarify documentation on exists() that it is preferred to be in the
WHERE clause.  fixes #3212

- flake8 all of test/ext/declarative

- these tests don't test anything in SQLAlchemy - from our perpsective,
we need to be in transactions (tested elsewhere) and we need to
emit the correct FOR UPDATE strings (tested elsewhere).  There's nothing
in SQLA to be tested as far as validating that for update causes exceptions
or not, and these tests frequently fail as they are timing sensitive.

- Fixed bug that affected generally the same classes of event
as that of :ticket:`3199`, when the ``named=True`` parameter
would be used.  Some events would fail to register, and others
would not invoke the event arguments correctly, generally in the
case of when an event was "wrapped" for adaption in some other way.
The "named" mechanics have been rearranged to not interfere with
the argument signature expected by internal wrapper functions.
fixes #3197

Conflicts:
test/base/test_events.py
test/orm/test_attributes.py
test/orm/test_events.py

- Fixed an unlikely race condition observed in some exotic end-user
setups, where the attempt to check for "duplicate class name" in
declarative would hit upon a not-totally-cleaned-up weak reference
related to some other class being removed; the check here now ensures
the weakref still references an object before calling upon it further.
fixes #3208

- Fixed bug that affected many classes of event, particularly
ORM events but also engine events, where the usual logic of
"de duplicating" a redundant call to :func:`.event.listen`
with the same arguments would fail, for those events where the
listener function is wrapped.  An assertion would be hit within
registry.py.  This assertion has now been integrated into the
deduplication check, with the added bonus of a simpler means
of checking deduplication across the board.
fixes #3199

Conflicts:
lib/sqlalchemy/event/registry.py
test/base/test_events.py

- not sure what this is testing but remove the self.l that might
be contributing to pypy not cleaning up on this one

Conflicts:
test/orm/test_eager_relations.py

- Fixed the version string detection in the pymssql dialect to
work with Microsoft SQL Azure, which changes the word "SQL Server"
to "SQL Azure".
fixes #3151

- raise from cause here to preserve stack trace

Added EXASolution dialect to documentation

- use compat.u for python3.2, fixes #3198

- fix issue where nose Failure object comes into play here

Conflicts:
lib/sqlalchemy/testing/plugin/noseplugin.py

Updated documenation for engines.rst

Clarified connecting to absolute path for sqlite using Windows.

- Fixed warning that would emit when a complex self-referential
primaryjoin contained functions, while at the same time remote_side
was specified; the warning would suggest setting "remote side".
It now only emits if remote_side isn't present.
fixes #3194

- Fixed bug in ordering list where the order of items would be
thrown off during a collection replace event, if the
reorder_on_append flag were set to True.  The fix ensures that the
ordering list only impacts the list that is explicitly associated
with the object.
fixes #3191

- for whatever reason, Insert.values() with multi values wasn't
in the 0.8 migration, so let's just add that

- add in all the method-chained methods to the parameter descriptions
on select().  improve some descriptions.

- mako_layout isn't used, remove it
- to check for epub look at "builder"

Docs: use the base layout when mako_layout=='epub'

  - https://readthedocs.org/projects/sqlalchemy/downloads/epub/latest/ renders with the full template which is unreadable on e-readers
  - in the makefile the template-variable mako_layout is set for target: epub which makes mako use only the base layout.
  - this is the more elegant solution as proposed to #133

- set flavor to "index" here as MySQL is sending None

- An adjustment to table/index reflection such that if an index
reports a column that isn't found to be present in the table,
a warning is emitted and the column is skipped.  This can occur
for some special system column situations as has been observed
with Oracle. fixes #3180

- backport the expects_warning() context manager from 1.0

- more updates to text docs, literal_column, column etc.  in prep
for ticket 2992.

- walk back these literal SQL lectures into something much more succinct.
the ORM one in particular was really long winded and I don't really care if people
use text() anyway, they'll figure it out ;)

- improve from_statement() doc

- start encouraging the use of text() for injection of string-based SQL
rather than straight strings.  reference #2992

- add a test to events within load to verify something we want
to ensure stays the same on 1.0

- add some more docs to yield_per

- changelog for pr bitbucket:28

add update() support to MutableDict

- changelog for pr bitbucket:27

fix MutableDict.coerce

If a class inherited from MutableDict (say, for instance, to add an update() method), coerce() would give back an instance of MutableDict instead of an instance of the derived class.

- mention that FOUND_ROWS is hardcoded; fixes #3146

- deprecation note regarding resurrect, reference #3171

Add note on begin_nested requiring rollback/commit

Avoid confusion about rollback/commit "must be issued" after
``session.begin_nested()`` --- this might be taken to mean call must be
*added*, but that's only true if not using the return value as a context
manager.

Merge branch 'rel_0_9' of bitbucket.org:zzzeek/sqlalchemy into rel_0_9

Fix doc typo 'conjunection'

Fix copy-paste error in Delete doc

- doc corrections for inline=True

- upgrade the note about inline=True to a warning, and make it clear that
this flag should really be set all the time. ref #3169

- Fixed bug in connection pool logging where the "connection checked out"
debug logging message would not emit if the logging were set up using
``logging.setLevel()``, rather than using the ``echo_pool`` flag.
Tests to assert this logging have been added.  This is a
regression that was introduced in 0.9.0.
fixes #3168

- pep8 cleanup

- changelog for pullreq github:125
- add pg8000 version detection for the "sane multi rowcount" feature

pg8000 now supports sane_multi_rowcount

From pg8000-1.9.14 sane_multi_rowcount is supported so this commit
updates the dialect accordingly.

- mutablemapping adds compiler overhead, so screw it

- TIL that dict.keys() in py3K is not an iterator, it is an iterable
view.  So copy collections.OrderedDict and use MutableMapping to set up
keys, items, values on our own OrderedDict.

- The string keys that are used to determine the columns impacted
for an INSERT or UPDATE are now sorted when they contribute towards
the "compiled cache" cache key.   These keys were previously not
deterministically ordered, meaning the same statement could be
cached multiple times on equivalent keys, costing both in terms of
memory as well as performance.
fixes #3165

- rework documentation for reflection flags, backport from
1.0

- add tests for the savepoint recipe

- rewrite all the sqlite/pysqlite transaction isolation docs

- turn off the testing reaper here, that's the source of the leaks
when we are running with pydist, and even when we are running without it
in fact...

Conflicts:
test/aaa_profiling/test_memusage.py

- take out the iterator approach here as it does not support concurrent access

-Fixed bug where Postgresql JSON type was not able to persist or
otherwise render a SQL NULL column value, rather than a JSON-encoded
``'null'``.  To support this case, changes are as follows:

* The value :func:`.null` can now be specified, which will always
  result in a NULL value resulting in the statement.

* A new parameter :paramref:`.JSON.none_as_null` is added, which
  when True indicates that the Python ``None`` value should be
  peristed as SQL NULL, rather than JSON-encoded ``'null'``.

Retrival of NULL as None is also repaired for DBAPIs other than
psycopg2, namely pg8000.

fixes #3159

- clarify docs that contains_eager() is included in the of_type() system,
fix #2438