- Fixed bug in SQLite dialect where reflection of UNIQUE constraints
that included non-alphabetic characters in the names, like dots or
spaces, would not be reflected with their name.
fixes #3495

(cherry picked from commit f39e692d1249aeffb4de85987f6a74303fc5dcc5)

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

- try to note under insert.values(), if you need
"multiple parameter sets" there is a much more common case
which works equally well for INSERT/UPDATE/DELETE e.g.
executemany().   reference #3476

- add a warning suggesting to use the dictionary form of access
if the name of the attribute being accessed is non-specific,
thereby avoiding collisions on names like items, values, keys.
fixes #3475

(cherry picked from commit 6fcc5d4a07e5c409a7d8438582598d0e90562ea0)

- fix the link here fixes 3473

(cherry picked from commit cf21497f02e64b6ddec82e12a7c26b9476616b00)

Fix code examples in automap's documentation

Fix camelize_classname and pluralize_collection functions as they didn't work as expected.
(cherry picked from commit 5717186122d5538e53205268846beb7143a3d4cc)

- edits to this section

(cherry picked from commit 00656ae4930620bc8c0c4be6a82853f01c90f758)

- add a new FAQ on re-reading of data within a transaction, since
this is definitely something that is asked regularly.

(cherry picked from commit be2b35f7f2156c4b723df9e7be389e6575afedc4)

- more edits, references #3461

(cherry picked from commit 7aa2100db3e6f768a280b4dfdb675d6709f94625)

- fix the bullets
- tone down the "never dispose an engine" language
- refer to NullPool for the "I don't like pooling" use case
references #3461

(cherry picked from commit a1b6e9f324eec04ff69f2ac5347ad3df5b931dd5)

- add explciit section on engine disposal, fixes #3461

(cherry picked from commit 3d78705cf4981e460d6d1b5bb08870286fc3fe93)

- automap is stable

(cherry picked from commit 370b237ddb6af0ba62f0ce5b1bedfe7556c6ccf3)

- add a subsection on how to use Sequence with server_default,
fixes #3453

(cherry picked from commit b861b7537c29349da00793fc828226a68cded62d)

- add an 0.9 migration note regarding TypeEngine's default
constructor removal; fixes #3446

- add a comment, also I think we want to expire before we do the
new begin, as begin_nested() does a flush

(cherry picked from commit 8f1130672d5a54dee311a11041857abfe85aa8a5)

Expire session in testing transaction handling

(cherry picked from commit d1dc39d55d111cdeffa663deec773d8bb67d237e)

- document SQlite dotted name issue, fixes #3441

(cherry picked from commit 4c90f355fd552e70009ffcdf3fdde9f3653e337e)

Update to correct TDS version; FreeTDS only supports up to 7.3. 8.0 is not a valid version (Microsoft released the spec late).

(cherry picked from commit 19571e2f8f4b621f3a1eaea198a8556497178015)

Fix typo in directive
(cherry picked from commit 6245d003f2ce404daedfba9101bb1e4f098b4c66)

Remove spaces around kwargs in metadata.rst

(cherry picked from commit 1bc7881171e02a80bcdb45191be6c6d83b6f01fd)

- break out binary insert against None, disable for freetds for now

(cherry picked from commit 0198d9aa5fee96c7523cc3e827baaba442c0ba02)

- backport no freetds rule

- autopep8

(cherry picked from commit 96f49085b8dd05062b97c4f9c892c071042dad66)

- liberalize list.remove() regexp as recent Pypy versions
format this message differently than cpython

(cherry picked from commit 1bb9c99ea9f3e36e5d4a9f1d4f21f1d0a252db4a)

- document fully how to use autoincrement w/ SQLite including
non-Integer column types, fixes #2075

flake8 some tests

(cherry picked from commit 164f2ad2f433b3d297df709d617a1fc421495921)

Correcting typo in introspection
(cherry picked from commit 9434356da63006b3bfbb7833bb62def4cda17189)

- Added official support for a CTE used by the SELECT present
inside of :meth:`.Insert.from_select`.  This behavior worked
accidentally up until 0.9.9, when it no longer worked due to
unrelated changes as part of :ticket:`3248`.   Note that this
is the rendering of the WITH clause after the INSERT, before the
SELECT; the full functionality of CTEs rendered at the top
level of INSERT, UPDATE, DELETE is a new feature targeted for a
later release.
fixes #3418

(cherry picked from commit eb1bb84fbc10c801c7269a3d38c9e0235327857e)

- plead with RTD to please please use the correct version

(cherry picked from commit 6d7901fa7d3feb5c7894e31a48d249b445557f20)

RTD doesn't seem to want to refresh on a git tag so go back to using
release numbers

- re-tag zzzeeksphinx w/ new version supporting sphinx 1.3

(cherry picked from commit 4f31db82100bee20284d8e9273ac9c6d147a32e3)

- bump zs version due to not yet diagnosed error

(cherry picked from commit ae4c2b6cbee0f993b3937237411df7fb8e66592d)

- fix typo MANYTOONE -> MANYTOMANY, fixes #3415

(cherry picked from commit be81cb200d9efb45c3bf331315c54dff778b5de6)

- Repair _reinstall_default_lookups to also flip the _extended flag
off again so that test fixtures setup/teardown instrumentation as
expected
- clean up test_extendedattr.py and fix it to no longer leak
itself outside by ensuring _reinstall_default_lookups is always called,
part of #3408
- Fixed bug where when using extended attribute instrumentation system,
the correct exception would not be raised when :func:`.class_mapper`
were called with an invalid input that also happened to not
be weak referencable, such as an integer.
fixes #3408

(cherry picked from commit 95949db715ff54be01bfd260a51903ede60597ae)

- Fixed an import that prevented "pypy setup.py test" from working
correctly.
fixes #3406

- Repaired / added to tests yet more expressions that were reported
as failing with the new 'entity' key value added to
:attr:`.Query.column_descriptions`, the logic to discover the "from"
clause is again reworked to accommodate columns from aliased classes,
as well as to report the correct value for the "aliased" flag in these
cases.
fixes #3409

(cherry picked from commit 24d6ea362e757c79b3bada663cf6fc9f262dae4f)

- Fixed regression from 0.9.10 prior to release due to :ticket:`3349`
where the check for query state on :meth:`.Query.update` or
:meth:`.Query.delete` compared the empty tuple to itself using ``is``,
which fails on Pypy to produce ``True`` in this case; this would
erronously emit a warning in 0.9 and raise an exception in 1.0.
fixes #3405

(cherry picked from commit 681276b5b4ae48924c85a1c26af3f9bde3d77b5f)

- Fixed regression from as yet unreleased 0.9.10 where the new addition
of ``entity`` to the :attr:`.Query.column_descriptions` accessor
would fail if the target entity was produced from a core selectable
such as a :class:`.Table` or :class:`.CTE` object.
fixes #3403  references #3320

(cherry picked from commit 20e3df602846bb1d8940b5138f21ef203c99bade)

- add boldface for "viable" plus a note describing that this
refers to the table having a primary key.  fixes #3398

(cherry picked from commit 93b5eae9843d423378f68be928a4f1e6fcacfb87)

Fix typo in 'Relationships API' docs
exprssed -> expressed

(cherry picked from commit da327d0349b2af88700808c8e0041eda4c57882f)

- try pinning a tag here to for RTD to please build correctly

(cherry picked from commit 6833669469b646fbd332b9ce4bd59a1122d3aa99)

- add a warning to SingletonThreadPool that it isn't for general use

(cherry picked from commit 732fb99fc0afbeb69d684b2bfa6d0be6250919a3)

- Added the string value ``"none"`` to those accepted by the
:paramref:`.Pool.reset_on_return` parameter as a synonym for ``None``,
so that string values can be used for all settings, allowing
.ini file utilities like :func:`.engine_from_config` to be usable
without issue.
fixes #3375

(cherry picked from commit c2e3002503242331fc8f2b314e0d4f3c65de9d73)

PEP8 cleanup in /test/aaa_profiling

(cherry picked from commit 45876612d2342250b73a9d3d9afd2bd6008db4c6)

PEP8 cleanup in /test/engine

(cherry picked from commit 0f0e305d25b6da1d42259e53ebd48712dfae5f40)

PEP8 cleanup in /test/sql

(cherry picked from commit e467db9edba1e629ba45704047fa76ecd08922ff)

- adjust for "0"

(cherry picked from commit fc702c9d809878c5a5d85876bfa23e17177940c2)

- remove errant 1.0 migration doc from 0.9 branch

- Fixed issue where a :class:`.MetaData` object that used a naming
convention would not properly work with pickle.  The attribute was
skipped leading to inconsistencies and failures if the unpickled
:class:`.MetaData` object were used to base additional tables
from.
fixes #3362

(cherry picked from commit 55c26710a1f6d6c6f87a9752035bc160f93b38d0)

- add test support for MySQLdb with use_unicode=1 or using mysqlclient on py3k

(cherry picked from commit ffec6ab936a73f5cbe63d9409beb12f1f0307d0b)

- add some teardown for connections that are held open after tests
in some cases, interfering with tests that check pool._refs

(cherry picked from commit 44a9820b4e02f65b3884fa2c016efce9663e4910)

- make sure this is 1.0.0 backported to 0.9

- Fixed a long-standing bug where the :class:`.Enum` type as used
with the psycopg2 dialect in conjunction with non-ascii values
and ``native_enum=False`` would fail to decode return results properly.
This stemmed from when the PG :class:`.postgresql.ENUM` type used
to be a standalone type without a "non native" option.
fixes #3354
cherry pick from ecd7b31d5eaed138e699293719f70260da3c978d

- Fixed bug where the state tracking within multiple, nested
:meth:`.Session.begin_nested` operations would fail to propagate
the "dirty" flag for an object that had been updated within
the inner savepoint, such that if the enclosing savepoint were
rolled back, the object would not be part of the state that was
expired and therefore reverted to its database state.
fixes #3352

(cherry picked from commit 359f471a1203cafd5dc99b5b078ba7d788b67cec)

- :class:`.Query` doesn't support joins, subselects, or special
FROM clauses when using the :meth:`.Query.update` or
:meth:`.Query.delete` methods; instead of silently ignoring these
fields if methods like :meth:`.Query.join` or
:meth:`.Query.select_from` has been called, a warning
is emitted.  In 1.0.0b5 this will raise an error.
Partial cherry pick from 5302bcebb8e18fdad7448ffb60d2a2017eab26c8.
fixes #3349
- don't realy need _no_select_modifiers anymore

Fix typos
agaisnt -> against
'a Alias' -> 'an Alias'

(cherry picked from commit a518b31f3b131ae8304026109cd826e38c2afc26)

fdb drivers seem to be no longer available

(cherry picked from commit 422fca43f8af1bfba0c2a2d24aa2eca7fc3bd558)

- merge recent commits from master which reorganize and
clarify MySQL unicode documentation, bringing it up-to-date
with current DBAPI support

- add a note that we aren't really doing zxjdbc right now even though
these files are present.

(cherry picked from commit ffddfe1b17b5c09dcb6289f807200f7c8279190e)

- Fixed unicode support for PyMySQL when using an "executemany"
operation with unicode parameters.  SQLAlchemy now passes both
the statement as well as the bound parameters as unicode
objects, as PyMySQL generally uses string interpolation
internally to produce the final statement, and in the case of
executemany does the "encode" step only on the final statement.
fixes #3337

(cherry picked from commit dcf5408f7d315b4d9ddec5d0d696eb364d763099)

Conflicts:
lib/sqlalchemy/dialects/mysql/pymysql.py

- changelog for #3333, fixes #3333

(cherry picked from commit 2feb40d0a48dd424c38a37e70a63a6bcf3c00c02)

fix Python 2-specific byte conversion

(cherry picked from commit 00f37f3984c35fc4a2ee5687e798c5ca36953d6c)

- fix typo, fixes #3325

(cherry picked from commit 138293c246fbf8c6693044a89fe788d0d0446113)

- remove now-misleading comment that SQLite doesn't support MATCH,
since they've apparently added something for it

- 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)