py2k: accept unicode literals on :func:`backref`, too

Fixed bug where in Py2K a unicode literal would not be accepted as the
string name of a class or other argument within declarative using
:func:`.backref` on :func:`.relationship`.

amends commit e6f67f48054d906856f879bc1803ea639aa4b670

(cherry picked from commit 58f73d2278393d813c7f39736fc96c5086f18f6d)

- update changelog for all the py3.5/3.6 related prs at once

Change generator termination from StopIteration to return.

From [PEP 479](https://www.python.org/dev/peps/pep-0479/) the correct way to
terminate a generator is to return (which implicitly raises StopIteration)
rather than raise StopIteration.

Without this change using sqlalchemy in python 3.5 or greater results in
these warnings
    PendingDeprecationWarning: generator '__iter__' raised StopIteration
which this commit should remove.

(cherry picked from commit 6ab120558078bdcbfbe06d2ca55bd7a0d417bbb4)

- A descriptive ValueError is now raised in the event that SQL server
returns an invalid date or time format from a DATE or TIME
column, rather than failing with a NoneType error.  Pull request
courtesy Ed Avis.
pullreq github:206

(cherry picked from commit 03a3b5ffd3027c79ce9b17b9388fd074e69b889d)

- update changelog to accommodate pr github:218

Fix _assert_unorderable_types on py36.

The error message changed to:

`'<' not supported between instances of 'foo' and 'bar'`

(cherry picked from commit d9178320d6755d893638646503ed538b11b6536a)

- changelog for pr github:210

Update usages of getargspec to compat version.

The places inspect.getargspec was being used were causing problems for
newer Python versions.

(cherry picked from commit e8a5ed9c1cbc5e9f0aebffad5ea78abb16167778)

- make inserted_primary_key a link and be more clear what happens here

(cherry picked from commit 86e5419968be23b88ef7e2ba4de9ca6698f0540b)

- close the session

(cherry picked from commit 4fcd93afb877ec8929586c2d7b671aef1783d883)

- Fixed an issue in baked queries where the .get() method, used either
directly or within lazy loads, didn't consider the mapper's "get clause"
as part of the cache key, causing bound parameter mismatches if the
clause got re-generated.  This clause is cached by mappers
on the fly but in highly concurrent scenarios may be generated more
than once when first accessed.
fixes #3597

(cherry picked from commit b0308a7b3af91cc61fbe3347376024ad8b7be019)

- Added support for parameter-ordered SET clauses in an UPDATE
statement.  This feature is available by passing the
:paramref:`~.sqlalchemy.sql.expression.update.preserve_parameter_order`
flag either to the core :class:`.Update` construct or alternatively
adding it to the :paramref:`.Query.update.update_args` dictionary at
the ORM-level, also passing the parameters themselves as a list of 2-tuples.
Thanks to Gorka Eguileor for implementation and tests.
adapted from pullreq github:200

(cherry picked from commit c90f0a49f332867f6b337c79ddf192299788667f)

- Fixed bug which is actually a regression that occurred between
versions 0.8.0 and 0.8.1, due :ticket:`2714`.  The case where
joined eager loading needs to join out over a subclass-bound
relationship when "with_polymorphic" were also used would fail
to join from the correct entity.
fixes #3593

(cherry picked from commit 1202e140b9876cf202c56d2f41bbbb573e15a39d)

- support declarativemappedtest with per-test setup

(cherry picked from commit 2a2be6a2ce66ed1040c0345a20f959cbea218859)

- add an ignore for N806

- Change "expr" to "entity" for example illustrating an event
that intercepts a query and adds entity-oriented criteria

(cherry picked from commit 054b22c7867722a256bfe8dd74eada4da378a601)

- add py35

(cherry picked from commit f7943db2f32e3cace9cadc5cf05402d425b76d33)

- Fixed joinedload bug which would occur when a. the query includes
limit/offset criteria that forces a subquery b. the relationship
uses "secondary" c. the primaryjoin of the relationship refers to
a column that is either not part of the primary key, or is a PK
col in a joined-inheritance subclass table that is under a different
attribute name than the parent table's primary key column d. the
query defers the columns that are present in the primaryjoin, typically
via not being included in load_only(); the necessary column(s) would
not be present in the subquery and produce invalid SQL.
fixes #3592

(cherry picked from commit 60c36ca8418cec180733a4d97637699fa2d3c36e)

- don't create tables on compile-only tests

(cherry picked from commit 068d37035a5d0004dc93712f4fa88703aefa4076)

- try to get this to skip for oracle

(cherry picked from commit ef9a4cb60b4e7fe305367c5223e8bb2cbf2b3b0f)

- A rare case which occurs when a :meth:`.Session.rollback` fails in the
scope of a :meth:`.Session.flush` operation that's raising an
exception, as has been observed in some MySQL SAVEPOINT cases, prevents
the original  database exception from being observed when it was
emitted during  flush, but only on Py2K because Py2K does not support
exception  chaining; on Py3K the originating exception is chained.  As
a workaround, a warning is emitted in this specific case showing at
least the string message of the original database error before we
proceed to raise  the rollback-originating exception.
fixes #2696

(cherry picked from commit a6fe4dc0c8ebc346a90dd849a86dac9345d74515)

- add documentation that describes, then proceeds to warn about
the many caveats and confusing effects of, the popular approach
of using contains_eager() to alter the natural result of a
related collection.  I'm not a fan of this technique as it changes
the semantics of a relationship in such a way that the rest of the
ORM isn't aware of and it also can be undone very easily; hence the
section needs as much text for warnings as for describing the
technique itself.   fixes #3563

(cherry picked from commit 1dc805dd4d902b9204703f0bd6151c58f1f287af)

- Fixed the ``.python_type`` attribute of :class:`.postgresql.INTERVAL`
to return ``datetime.timedelta`` in the same way as that of
:obj:`.types.Interval.python_type`, rather than raising
``NotImplementedError``.
fixes #3571

- rewrite the docs and add a test for the bake_queries=True
relationship flag; this flag *does* have an effect when the baked
lazy loader plugin has been invoked.  clarify the intent of this
flag as an "opt out" but only has an effect when the baked system
is loaded anyway.  fixes #3572

(cherry picked from commit c7f9aa281857eeeaf7963c370bda43d2eb4746f5)

- version bump

- extend pullreq github:213 to also include DATETIMEOFFSET and TIME,
which also accept zero precision
- extend test case here to include a backend-agnostic suite
- changelog for MSSQL date fix

(cherry picked from commit 0847097c29ab48a5f111518e2c6ee324d5242057)

Pass precision value to mssql.DATETIME2 when it is 0

The simple check on the precision results in DATETIME2(0) generating a
DATETIME2 column, with default precision, which is 7.

(cherry picked from commit 80ce23f6fd0f14ab656d3ec82773bd0cffbd4791)

Updated PostgreSQL links to point to "current" rather than hardcoded version
(cherry picked from commit a2e83dbd2aa14de19a309ad13144151b56804674)

Update links in SQLAlchemy docs that point to postgres docs to use 'devel' rather than hardcoded version
(cherry picked from commit 0d3ab3198a2863f28399a34a3bdbd1de0ca2530f)

Fix typo: foriegn --> foreign
(cherry picked from commit 8660883e1ac11044487e02ec818f59ed7b5a50f9)

fix typo: Explcitly -> Explicitly

(cherry picked from commit 887edc431a4c5198bb4f842419d729aed42a6ce8)

- fix ambiguous documentation re: after_flush_postexec(), the
looping nature of it only occurs within the context of a commit.

(cherry picked from commit 5d8bb1f4a65c8932c0dcb39d241b521bd95db681)

- fix broken link to loader behavior

(cherry picked from commit 2d54e3819f34e5f886b8d85f5525b83abdf8bc5a)

- cross-linking for pool recycle feature

(cherry picked from commit 07a199d929aa920b5b2b5d8b2d7008626a731f1f)

- add a JSON warning for coerce_compared_value

(cherry picked from commit 98c1dcc6bcade313a254fe11e8efa3c5b5ad959e)

Link to maintained redshift dialect
(cherry picked from commit e4bfe2aa4b5246207837b0b1c3ac99483e20498b)

- update the pool pessimistic invalidation recipe to refer to the
engine_connect event, allowing easy detection of disconnects
and full invalidation of the pool

(cherry picked from commit 2daaacef047718856623f43ea55d09abfa2a2dd7)

1.0.9

- try to make this language more succinct and fix links

- use is_() here to more clearly show what's going wrong
on occasional pypy test runs

(cherry picked from commit 5bc5adb6270bd5c7ef0564973cbd765aa371fbca)

- adjust 4f54607923a11669961b53f where we still allow_multirow as long
as versioning isn't needed, fixes test_unitofworkv2->test_update_multi_missing_broken_multi_rowcount

- Fixed regression in 1.0 where new feature of using "executemany"
for UPDATE statements in the ORM (e.g. :ref:`feature_updatemany`)
would break on Postgresql and other RETURNING backends
when using server-side version generation
schemes, as the server side value is retrieved via RETURNING which
is not supported with executemany.
fixes #3556

- modernize some very old global-engine tests w/ bad teardowns

(cherry picked from commit affcfd1e529ccb11f56203f5805711a15072a7ab)

Conflicts:
test/dialect/postgresql/test_query.py

- repair flake8 issues

(cherry picked from commit e6779d84376e32941be36a97c75ecd4ab6d480d8)

- repair laziness about setting time zone here, which is leaking
out depending on connection pool state

(cherry picked from commit 2a8a06e33af60705faf3e7601ec7b3e31e44f8fb)

- Added the :paramref:`.AssociationProxy.info` parameter to the
:class:`.AssociationProxy` constructor, to suit the
:attr:`.AssociationProxy.info` accessor that was added in
:ticket:`2971`.  This is possible because :class:`.AssociationProxy`
is constructed explicitly, unlike a hybrid which is constructed
implicitly via the decorator syntax.
fixes #3551

(cherry picked from commit 9d08c6abc21dcf3d832897d38aaba84aeaa14fa6)

Update base.py

Docstring typo keysowrds => keywords
(cherry picked from commit f8eb7c2858443649190b735c587c190ae90b6106)

- Fixed bug in Oracle dialect where reflection of tables and other
symbols with names quoted to force all-lower-case would not be
identified properly in reflection queries.  The :class:`.quoted_name`
construct is now applied to incoming symbol names that detect as
forced into all-lower-case within the "name normalize" process.
fixes #3548

(cherry picked from commit 4578ab54a5b849fdb94a7032987f105b7ec117a4)

- add an additional note regarding select_from, fixes #3546

(cherry picked from commit d84dea62de3a9c83ad539a5cf2ff4be2c0685a94)

- remove ambiguous use of the phrase "joined together by AND" as this
may be construed as the Python "and" keyword
- add notes to ORM tutorial for beginners that Python "and" keyword
is not to be used
fixes #3545

(cherry picked from commit ac08920284935e7e7519ce77ba369703390155dc)

- fix bool test

(cherry picked from commit 1704eacf24f803283033c172cb74b0fb4e9e36d8)

- break out critical aspects of test_query into their own tests
finally, test_resultset and test_insert_exec.   Update all
idioms within these.

(cherry picked from commit a8e1d33ae514a045d71d0a26d0c1325eecd4ca99)

Fix sqlalchemy.ext.baked.Result.one_or_none() exception message

Also add a couple of missing tests.
(cherry picked from commit 91255618ddb47553774c620a23479adf88c27b74)

- replicate Query.one_or_none to BakedQuery
- changelog / version note finishing

(cherry picked from commit 5b71858533ea153dec119b3592631fdb1500a15f)

Add Query.one_or_none()

(cherry picked from commit a9b5fb3f497837c0a4f1122c49c5dd54c87474a0)

Merge remote-tracking branch 'origin/pr/199' into rel_1_0

Add a lot more detail

- Fixed rare TypeError which could occur when stringifying certain
kinds of internal column loader options within internal logging.
fixes #3539

(cherry picked from commit 47fcb1d0b6ad6481e89d4b2e8c2cc29cf7c03d8b)

Add some markup

A few minor rewordings

- fix incorrect example in inheritance docs

(cherry picked from commit 7eb34baf99179eec966ddd8b3607a6d8cfdfba21)

- add new entry for sharing of Engine across process boundaries

(cherry picked from commit fe41e39b9b776c18a03dde0540a45e1f0100d44b)

- call it deque, since you can really pop from either side

- add a new FAQ recipe for "walk all objects", replacing the need
to use mapper.cascade_iterator() for this purpose as it was not really
designed for that use case.  Add docs to cascade_iterator() pointing
to the recipe.  fixes #3498

(cherry picked from commit 03797b78475bec9fb9c15f8e926414f3720a273c)

Correcting the Hybrid Property Example

Fixes #3528

Signed-off-by: Jason Myers <jason@jasonamyers.com>

fix typo in session events docs

(cherry picked from commit 2fb3bb31ef897ee48748908524288067c53df4e1)

Minor grammar fix for capitalisation in session docs

(cherry picked from commit 3bd58fac7b607007cb42ab7e41d2e2d01fc390e2)

- Fixed bug in :meth:`.Session.bulk_save_objects` where a mapped
column that had some kind of "fetch on update" value and was not
locally present in the given object would cause an AttributeError
within the operation.
fixes #3525

(cherry picked from commit 68a6701c6d72d6c6ef1ea2b7d615273659e8b735)

- update moved link, fixes #3351

(cherry picked from commit 176ac6ab0915f99d378c7d9be67e9c0a73ab1800)

- add new documentation that applies to all modern SQLA versions,
detailing ORM event recipes across the board.

(cherry picked from commit 8be93c23ee566de7cefd7d1b8ef044324132a70f)

- add a note about DISTINCT in query w/ ORDER BY, references #3518

(cherry picked from commit 6d0c0994e9a08cf5d149af0314970d5f6e25b159)

- Fixed regression in 1.0-released default-processor for multi-VALUES
insert statement, :ticket:`3288`, where the column type for the
default-holding column would not be propagated to the compiled
statement in the case where the default was being used,
leading to bind-level type handlers not being invoked.
fixes #3520

(cherry picked from commit c39ff9978dbb77cbea4f1ee08234887d8aa1b165)

- use consistent and descriptive language in all cases
where we refer to the "weak_identity_map" option, and add additional
exposition in the session documentation which refers to it.
fixes #3517

(cherry picked from commit 956907a4b15f6dcc492582a7ad03706ff62d96fb)

- reword and update documentation on passive_updates=False; as virtually
all DBs now support ON UPDATE CASCADE other than Oracle, there's no need
to try to reimplement more functionality here and users should be encouraged
to forego natural PKs unless their target platform supports them.
references #2666

(cherry picked from commit d459afa8dbf73b8d9d620d09dede97e3461b6b3f)

- re-document and fully cross link all of configure_mappers(),
mapper_configured(), after_configured(), and before_configured().

(cherry picked from commit 0127ac668e405584d74c92768a9f0dc7913798fe)

- Fixed two issues in the "history_meta" example where history tracking
could encounter empty history, and where a column keyed to an alternate
attribute name would fail to track properly.  Fixes courtesy
Alex Fraser.

(cherry picked from commit d57e5edbcdf915168c613cdd6da0bd7bea877fa4)

- rework the "controlling DDL sequences" documentation to
refer mostly to the DDL object; this system is primarily useful
in that case, and not for built-in objects.  Reference that
the built-in case is not really viable right now. References #3442.

- document workaround type for ARRAY of ENUM, fixes #3467

(cherry picked from commit ba1e959e5316a8c17ca80dca950574038bd650c4)

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

- add tests for InstanceEvents.init, InstanceEvents.init_failure
- ensure that kwargs can be modified in-place within InstanceEvents.init
and that these take effect for the __init__ method.
- improve documentation for these and related events, including
that kwargs can be modified in-place.

(cherry picked from commit b00b430e87512d721ad30c81fdcb35a5253dfc0a)

- Fixed 1.0 regression where the "noload" loader strategy would fail
to function for a many-to-one relationship.  The loader used an
API to place "None" into the dictionary which no longer actually
writes a value; this is a side effect of :ticket:`3061`.
- remove InstanceState._initialize() totally, it's used nowhere
else and no longer does what it says it does
- fill in fowards-port version ids throughout the changes for 1.0.9

(cherry picked from commit 5198b1de31029cc985102cd13569086a7056c2f1)

- pep8 test/orm/test_mapper

(cherry picked from commit 669a42c604e007623aeeb50a6f01b217badc8ceb)

- Fixed two issues regarding Sybase reflection, allowing tables
without primary keys to be reflected as well as ensured that
a SQL statement involved in foreign key detection is pre-fetched up
front to avoid driver issues upon nested queries.  Fixes here
courtesy Eugene Zapolsky; note that we cannot currently test
Sybase to locally verify these changes.
fixes #3508  fixes #3509

(cherry picked from commit a7d7941d3ebafd16f603785c4677e371c675d1c0)

fix typo int->into
(cherry picked from commit 51870ddaef8abf61ee4c8d6337a72db5395a0a85)

Remove useless code

`to_unicode` variable was created but was not used.
(cherry picked from commit 69fcabb335130bd0f6e9889c5b191c68192559b5)

- add a note clarifying query.with_labels(), fixes #3506

(cherry picked from commit 292f5bec1cbfcaa9d16af8fe4149c7191f194f11)

- Fixed support for cx_Oracle version 5.2, which was tripping
up SQLAlchemy's version detection under Python 3 and inadvertently
not using the correct unicode mode for Python 3.  This would cause
issues such as bound variables mis-interpreted as NULL and rows
silently not being returned.
fixes #3491

(cherry picked from commit d8efa2257ec650b345ec6e840984387263a957a6)

- fix typo in suffix_with() docs, fixes #3502

(cherry picked from commit 2e52f877638ded9d8440fa94632bff0f1705a83e)

- using text().columns() for ORM matching won't work well
until ticket #3501, so remove this from pre-1.1 tutorials

- work to bridge between core/ORM tutorials regarding the text() construct

(cherry picked from commit 4f51fa947ffa0cadeab7ad7dcab649ce3fbcf970)

- remove "completely raw", whatever that is

- typo

- add an example of text.columns
- correct the scalar() example output

- An adjustment to the new Postgresql feature of reflecting storage
options and USING of :ticket:`3455` released in 1.0.6,
to disable the feature for Postgresql versions < 8.2 where the
``reloptions`` column is not provided; this allows Amazon Redshift
to again work as it is based on an 8.0.x version of Postgresql.
Fix courtesy Pete Hollobon.
references #3455

1.0.8

- categorize this correctly

- Fixed critical issue whereby the pool "checkout" event handler
may be called against a stale connection without the "connect"
event handler having been called, in the case where the pool
attempted to reconnect after being invalidated and failed; the stale
connection would remain present and would be used on a subsequent
attempt.  This issue has a greater impact in the 1.0 series subsequent
to 1.0.2, as it also delivers a blanked-out ``.info`` dictionary to
the event handler; prior to 1.0.2 the ``.info`` dictionary is still
the previous one.
fixes #3497

0.9.10 release date

(cherry picked from commit e71cf56a835842cd7d7038d6527888cc1297005f)

- 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

- Fixed an issue where a particular base class within utils
didn't implement ``__slots__``, and therefore meant all subclasses
of that class didn't either, negating the rationale for ``__slots__``
to be in use.  Didn't cause any issue except on IronPython
which apparently does not implement ``__slots__`` behavior compatibly
with cPython.
Fixes #3494

1.0.7