- call this 1.0.0b1

(cherry picked from commit 64b7a50cbd64b44fa8ee8413213e9eae73483515)

- repair forwards-port directives

- Fixed regression from 0.9.9 where the :func:`.as_declarative`
symbol was removed from the ``sqlalchemy.ext.declarative``
namespace.
fixes #3324

- fix quantize recipe, fixes #3322

(cherry picked from commit e42d8184ac087e12e463f938e6a07759cc6392ca)

- try to document how to get columns from constraints.
unfortunately Sphinx refuses to work correctly for the columns
attribute so we just add a lame message to contains_column().

(cherry picked from commit f211ad254d53b85aae319b41cc7b206f3e693660)

0.9.10 bump

- Added a new entry ``"entity"`` to the dictionaries returned by
:attr:`.Query.column_descriptions`.  This refers to the primary ORM
mapped class or aliased class that is referred to by the expression.
Compared to the existing entry for ``"type"``, it will always be
a mapped entity, even if extracted from a column expression, or
None if the given expression is a pure core expression.
references #3320

(cherry picked from commit b815e9483319b93f98bef11c7d47378441f78d21)

- feature, not enhancement

- 0.9.9

- copyright 2015

- repair doclevel

- changelog and docs for pullreq bitbucket:45

(cherry picked from commit 5d1206c10a96b6685e57baa9ae09f04f00cf425b)

Conflicts:
lib/sqlalchemy/dialects/postgresql/base.py

Dialect option `postgresql_concurrently` to `Index` construct.

(cherry picked from commit 955576fcf6e7aff7fe924ec3b33bb6d243ddd312)

- changelog for pr github:154

(cherry picked from commit 78874d3679fe45275d44dda40f4f1bae9a0558b7)

Fix slice addressing of _AssociationList with python3

(cherry picked from commit 9fee9cb87e0d13db4426664f5758c1ddad0533e3)

- changelog / doc for sqlite partial indexes

(cherry picked from commit 6ac0555eaa6363ac9d0ad6566248dd294ad61d9e)

Test for partial index support in sqlite dialects.

(cherry picked from commit 4a42bd5a2cba23782df7b6f98cadb7382d22498e)

Partial index support with sqlite dialects.

From https://www.sqlite.org/partialindex.html
> Partial indexes have been supported in SQLite since version 3.8.0.

Reflection does not expose the predicate of partial indexes.  The
postgresql dialect does detect such indexes and issue a warning.  I
looked into matching this level of support, but the sqlite pragma
index_info does not expose the predicate.  Getting this data would
probably require parsing the CREATE INDEX statement from sqlite_master.

(cherry picked from commit 30ce7e93f4068b00ced0db785fdd578dc8a45975)

minor docstring fix in MappedCollection class

(cherry picked from commit 34cb52e8d9f9bf345904315f16fb87ca9310d9cb)

Update migration_09.rst

typo fix: indivdual -> individual.
(cherry picked from commit c5edbc6fdc611d3c812735d83fe056fbb7d113f5)

- Fixed bugs in ORM object comparisons where comparison of
many-to-one ``!= None`` would fail if the source were an aliased
class, or if the query needed to apply special aliasing to the
expression due to aliased joins or polymorphic querying; also fixed
bug in the case where comparing a many-to-one to an object state
would fail if the query needed to apply special aliasing
due to aliased joins or polymorphic querying.
fixes #3310

(cherry picked from commit 305ea84004fe604f461cd3c9438fbc84e3d790b2)

- Fixed bug where internal assertion would fail in the case where
an ``after_rollback()`` handler for a :class:`.Session` incorrectly
adds state to that :class:`.Session` within the handler, and the task
to warn and remove this state (established by :ticket:`2389`) attempts
to proceed.
fixes #3309

(cherry picked from commit ad66266d3d275a6129e3270eaacdad171bc10817)

- autopep8

(cherry picked from commit b86b239c87528cfd898b8b1c66fe1c78f127cccc)

- add a new section regarding multiprocessing

(cherry picked from commit 94d57374c44b49dce8531a0b0ed3116e52530c3b)

- flake8

(cherry picked from commit 03038f7e75500e7d5388dedd79d9b35e01b3a677)

- test + changelog

(cherry picked from commit 7b9134be7129346e486a5caca7bdc87de7ccf015)

Conflicts:
lib/sqlalchemy/orm/query.py

It's the 'kwargs' which are iterable, not 'keys'

(cherry picked from commit 02c072edbb1eaa826632e70174eb96915bb725b5)

- update test for newer API of _connection_for_bind

- Fixed bug in :class:`.Connection` and pool where the
:meth:`.Connection.invalidate` method, or an invalidation due
to a database disconnect, would fail if the
``isolation_level`` parameter had been used with
:meth:`.Connection.execution_options`; the "finalizer" that resets
the isolation level would be called on the no longer opened connection.
fixes #3302

(cherry picked from commit 068f9a1531c8114360d5fcd964c27fe6a21f4679)

- 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