- A warning is emitted if the ``isolation_level`` parameter is used
with :meth:`.Connection.execution_options` when a :class:`.Transaction`
is in play; DBAPIs and/or SQLAlchemy dialects such as psycopg2,
MySQLdb may implicitly rollback or commit the transaction, or
not change the setting til next transaction, so this is never safe.
- Added new parameter :paramref:`.Session.connection.execution_options`
which may be used to set up execution options on a :class:`.Connection`
when it is first checked out, before the transaction has begun.
This is used to set up options such as isolation level on the
connection before the transaction starts.
- added new documentation section
detailing best practices for setting transaction isolation with
sessions.
fixes #3296

(cherry picked from commit 9cbe235810b7c0c24d2556b4bb581b0207812e2d)

Conflicts:
test/orm/test_bind.py

- Fixed bug in lazy loading SQL construction whereby a complex
primaryjoin that referred to the same "local" column multiple
times in the "column that points to itself" style of self-referential
join would not be substituted in all cases.   The logic to determine
substitutions here has been reworked to be more open-ended.
fixes #3300

Conflicts:
test/orm/test_relationships.py

- Repaired support for Postgresql UUID types in conjunction with
the ARRAY type when using psycopg2.  The psycopg2 dialect now
employs use of the psycopg2.extras.register_uuid() hook
so that UUID values are always passed to/from the DBAPI as
UUID() objects.   The :paramref:`.UUID.as_uuid` flag is still
honored, except with psycopg2 we need to convert returned
UUID objects back into strings when this is disabled.
fixes #2940

(cherry picked from commit b2189da65019ed2f44e77933a122619489319c5a)

Add unit test for UUID arrays in PostgreSQL.

(cherry picked from commit cf4e421248e3175b97170d0c6930b360ff326c06)

- Added support for the :class:`postgresql.JSONB` datatype when
using psycopg2 2.5.4 or greater, which features native conversion
of JSONB data so that SQLAlchemy's converters must be disabled;
additionally, the newly added psycopg2 extension
``extras.register_default_jsonb`` is used to establish a JSON
deserializer passed to the dialect via the ``json_deserializer``
argument.  Also repaired the Postgresql integration tests which
weren't actually round-tripping the JSONB type as opposed to the
JSON type.  Pull request courtesy Mateusz Susik.

- Repaired the use of the "array_oid" flag when registering the
HSTORE type with older psycopg2 versions < 2.4.3, which does not
support this flag, as well as use of the native json serializer
hook "register_default_json" with user-defined ``json_deserializer``
on psycopg2 versions < 2.5, which does not include native json.

(cherry picked from commit bf70f556b382dc376783efbcb598e0fab71ee235)

Psycopg2 JSONB support.

(cherry picked from commit e7d61d594b8a89535696436a667a526bd2999fb2)

- Fixed bug in 0.9's foreign key setup system, such that
the logic used to link a :class:`.ForeignKey` to its parent could fail
when the foreign key used "link_to_name=True" in conjunction with
a target :class:`.Table` that would not receive its parent column until
later, such as within a reflection + "useexisting" scenario,
if the target column in fact had a key value different from its name,
as would occur in reflection if column reflect events were used to
alter the .key of reflected :class:`.Column` objects so that the
link_to_name becomes significant.  Also repaired support for column
type via FK transmission in a similar way when target columns had a
different key and were referenced using link_to_name.
fixes #3298

(cherry picked from commit 3712e35c329cc3b5106f026be90e04f65412586d)

- fix link to non_primary flag
- rewrite the multiple mappers section

- Added new user-space accessors for viewing transaction isolation
levels; :meth:`.Connection.get_isolation_level`,
:attr:`.Connection.default_isolation_level`.
- enhance documentation inter-linkage between new accessors,
existing isolation_level parameters, as well as in
the dialect-level methods which should be fully covered
by Engine/Connection level APIs now.

(cherry picked from commit c3d898e8d06c7e549bb273fc8654f5d24fab2204)

- enhance detail here regarding the difference between
Connection.connection and engine.raw_connection()

(cherry picked from commit 4032aaf097a9268bc331e4b4815d77b19ba3febb)

formatting

(cherry picked from commit 10dd5fe81062347905492ef66e6f0453479cc03b)

- add an exclusion here that helps with the case of 3rd party
test suite redefining an existing test in test_suite

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

- Fixed bug where Postgresql dialect would fail to render an
expression in an :class:`.Index` that did not correspond directly
to a table-bound column; typically when a :func:`.text` construct
was one of the expressions within the index; or could misinterpret the
list of expressions if one or more of them were such an expression.
fixes #3174

(cherry picked from commit 79fa69f1f37fdbc0dfec6bdea1e07f52bfe18f7b)

- add new section to ORM referring to runtime inspection API,
more links, attempt to fix #3290

- The "wildcard" loader options, in particular the one set up by
the :func:`.orm.load_only` option to cover all attributes not
explicitly mentioned, now takes into account the superclasses
of a given entity, if that entity is mapped with inheritance mapping,
so that attribute names within the superclasses are also omitted
from the load.  Additionally, the polymorphic discriminator column
is unconditionally included in the list, just in the same way that
primary key columns are, so that even with load_only() set up,
polymorphic loading of subtypes continues to function correctly.
fixes #3287

(cherry picked from commit b63aae2c232f980a47aa2a635c35dfa45390f451)

Conflicts:
lib/sqlalchemy/orm/mapper.py

- this will be 0.9.9

- changelog for pr 41

(cherry picked from commit 5f1d34c4c86263684d5a79c8d8f9db8d1e3afccb)

Add native_enum flag to Enum's repr() result

Needed for alembic autogenerate rendering.

(cherry picked from commit f4b7b02e31e6b49195c21da7221bcbda0bad02b9)

Conflicts:
test/sql/test_types.py

- add a close here

- Fixed bug where if an exception were thrown at the start of a
:class:`.Query` before it fetched results, particularly when
row processors can't be formed, the cursor would stay open with
results pending and not actually be closed.  This is typically only
an issue on an interpreter like Pypy where the cursor isn't
immediately GC'ed, and can in some circumstances lead to transactions/
locks being open longer than is desirable.
fixes #3285

Conflicts:
lib/sqlalchemy/orm/loading.py

- make a new page that introduces mapping a little better for the
"mapping" section, contrasts declarative and classical some more

Conflicts:
doc/build/orm/mapper_config.rst

- fix some RST whitespace syntactical issues in toctrees
- have the topmost toctree only include page names
- add glossary to toctree, remove search by itself

(cherry picked from commit 87a1af4efe5bb515d9e687e2f7dfc84dfb8ee522)

Conflicts:
doc/build/changelog/index.rst

- see if we can get RTD to use this for now

bump

(cherry picked from commit 1cb24b37421d413045daccfc819d9fa0e61dd4c4)

bump

(cherry picked from commit 60368fdd9f278492099f7c8108456ecbb44c76ef)

- fix links for loading, add a redirect page

bump

foo

(cherry picked from commit 0bd632804eae635d793175a959294f49f3538806)

- another bump

(cherry picked from commit d11c7a197e556eda873b267d20a03e317477e510)

- remove private superclasses from docs in favor of fixing
zzzeeksphinx to omit these from warning

remove pipe...

(cherry picked from commit 3ccae267894804b104171f2fee9355cd292e0dbf)

no hassuffixes in 0.9

corrections

(cherry picked from commit 5343d24fee5219de002a8efba8bc882f8b3d4b5b)

- corrections
- attempt to add a script to semi-automate the fixing of links

(cherry picked from commit 544e72bcb6af1ca657b1762f105634372eca3bc0)

- squash-merge the improve_toc branch, which moves all the Sphinx styling
and extensions into an external library, and also reorganizes most large documentation
pages into many small areas to reduce scrolling and better present the context
into a more fine-grained hierarchy.

(cherry picked from commit 9561321d0328df270c4ff0360dc7a035db627949)

- manually port previous differences between 0.9 and 1.0 docs to the
cherry-pick.

- typo fixes #3269

(cherry picked from commit ef6dc0cf2ef581e7cb53dcb4840f678aa1fa5ba6)

- ouch, this needs to be in dbapi, not module level!

- make the google deprecation messages more specific, use full URL
format
- add an extra doc to MySQLdb
- changelog

(cherry picked from commit 182553b7409cfa6673483d03f29bc4c462336577)

Update gaerdbms to highlight improved connection method

(cherry picked from commit 0d15791a6e3ec35e3c2e297026d8396742e30a34)

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.