- reworked the way the "select_wraps_for" expression is
handled within visit_select(); this attribute was added in the
1.0 series to accommodate the subquery wrapping behavior of
SQL Server and Oracle while also working with positional
column targeting and no longer relying upon "key fallback"
in order to target columns in such a statement.  The IBM DB2
third-party dialect also has this use case, but its implementation
is using regular expressions to rewrite the textual SELECT only
and does not make use of a "wrapped" select at this time.
The logic no longer attempts to reconcile proxy set collections as
this was not deterministic, and instead assumes that the select()
and the wrapper select() match their columns postionally,
at least for the column positions they have in common,
so it is now very simple and safe.  fixes #3657.
- as a side effect of #3657 it was also revealed that the
strategy of calling upon a ResultProxy._getter was not
correctly calling into NoSuchColumnError when an expected
column was not present, and instead returned None up to
loading.instances() to produce NoneType failures; added
a raiseerr argument to _getter() which is called when we
aren't expecting None, fixes #3658.

(cherry picked from commit 8ad968f33100baeb3b13c7e0b724b6b79ab4277f)

- version bump

- further edit the unnest() example to suit PG's esoteric requirements
exactly

(cherry picked from commit c97aa63789036fc145503f03123275253ae02d2c)

- use same colname as the alias we give to the PG function
here, fixes #3652

(cherry picked from commit e310a8e423d9a4eeb511b7b84dbeccc90c234a1f)

- 1.0.12

- Fixed bug in :meth:`.Session.merge` where an object with a composite
primary key that has values for some but not all of the PK fields
would emit a SELECT statement leaking the internal NEVER_SET symbol
into the query, rather than detecting that this object does not have
a searchable primary key and no SELECT should be emitted.
fixes #3647

(cherry picked from commit 366f97b5617af0d15cfaf594ec5ef0408c70e873)

- add more documentation to MutableDict explaining
that this structure is only intended to track additions
and removals from the dictionary, not recursive tracking
of embedded changes.  fixes #3646.

(cherry picked from commit 287aaa9d416b4f72179da320af0624b9ebc43846)

- don't drop the ts1/ts2 databases without seeing the primary DB,
because we never log in on the ts1/ts2.  races against other runs
and erases their DBs

(cherry picked from commit 3f1f1895ac99963da1a989c69c2dce59ae916ffc)

- repair the fix just cherry-picked for ref #3644 as compiler.py wasn't
present in the commit for master, having been inadvertently committed
on February 3.  Source of this line is c1316a299257fae8264c8038d83e415f4605fde7.

- Fixed bug in :func:`.expression.text` construct where a double-colon
expression would not escape properly, e.g. ``some\:\:expr``, as is most
commonly required when rendering Postgresql-style CAST expressions.
fixes #3644

(cherry picked from commit 29dcaa2b0ae2d26b36ec624be80f56e03ab9095e)

- repair generic _post_configure_engine() from previous changeset

- backport changes to SQLite attached DB tests so that
we dont get file conflicts, cherry-pick from 5bb2536cc57c55c7d8c5901b5b622d18a9a6c646

- backport new profile system from 1.1 so we can run new-style
test envs on jenkins

- Testing reveals that we have *no* weak references to any cx_Oracle connections at all,
yet cx_Oracle still has open sessions that cannot be killed until process dies.
Oracle wins!   Add a completely separate DB reaper script that runs
after py.test is done.

(cherry picked from commit 11a8440bc43aa9f7eb6f2cb7b7f43e0cf6680f41)

- restore GLOBAL keyword here

- add tox.ini from 1.1

- use config-based test schema

(cherry picked from commit 00a05e357b5bcc37c66256bc08c1198541475739)

- fully hyperlink the docstring for make_transient
- establish make_transient and make_transient_to_detached as special-use,
advanced use only functions
- list all conditions under make_transient() under which an attribute
will not be loaded and establish that make_transient() does not attempt
to load all attributes before detaching the object from its
session, fixes #3640

(cherry picked from commit 7eff4e8f3e3999d9eb914647d8776e6e5b7ee88e)

- add missing __backend__ directives so that oracle tests actually run with --backend-only

(cherry picked from commit 860d07ff89a8fd8b6a4d3036837c0e129d6cc233)

- detect "Enterprise" and assume compression stuff isn't available
if not

(cherry picked from commit 308244a90b95d2b78ed8f76e3af0d0c3d2329720)

- adjust the MultiSchemaTest to handle multiple test_schemas / processes at the
same time

(cherry picked from commit 80853059a9f4bebfe41f9c340eddc2d6a86ef70f)

- adjust to allow dblink tests to work with multiprocess users.
unfortunately the synonym doesn't work for SQL statements here
when the dblink is on a different user, testing this is not really
critical so just removed it.

(cherry picked from commit 7e619d0be41afc3b6cd5e5fceba9dbc5f39b012d)

- more oracle fixes

(cherry picked from commit 93c5328e66d8491e73027f6e789df2255c4fa767)

- add multi-database provisioning for oracle

(cherry picked from commit c01d11907cbc98ddefe323c6115bc954b908f101)

- add literal_binds for delete() statements in addition to insert()/update()
- move tests to CRUDTest
- changelog, fixes #3643

(cherry picked from commit 150591f9e0a94902cb2a76b68ac7c9d8a1a3ec83)

fix passing literal_binds flag through for update and insert

(cherry picked from commit c9b03fa8afd52646aba8c59fc038330eeee6db60)

- changelog for #3621 fixes #3621

(cherry picked from commit 9149fd062b8b5f4d84902b4581288ab991fd25ce)

Removed entry that causes AttributeError (#3621) - Oracle zxJDBC fails with AttributeError in object OracleCompiler_zxjdbc
(cherry picked from commit edc0b8678bc06ae27fa0f7e80c3eb074978fbe10)

- D rules seem to have been added overnight to the flake8 plugin
I'm using and many of these seem contradictory and/or undesirable.
block all until individual rules can be approved.

- Fixed issue where inadvertent use of the Python ``__contains__``
override with a column expression (e.g. by using ``'x' in col``)
would cause an endless loop in the case of an ARRAY type, as Python
defers this to ``__getitem__`` access which never raises for this
type.  Overall, all use of ``__contains__`` now raises
NotImplementedError.
fixes #3642

(cherry picked from commit e0a580b3d055a600afae61840058a5a30ef5fe74)

- put a retry in for PG database provisioning as it locks
on database use

(cherry picked from commit c8b3d4ed3f2638599fc73486cf0f724fa033a638)

- happy new year

(cherry picked from commit 859379e2fcc4506d036700ba1eca4c0ae526a8ee)

- use a StaticPool for componentreflectiontest to ensure
temp tables are reflectable on the same session they were
created

(cherry picked from commit 14b1e6fe8e18d139846c1aba6761d4eea3dc25c3)

- use schema argument correctly when we are dropping for a schema

(cherry picked from commit 13dfc532ac02657d75da40cc52d97b3b50a6bcfe)

- revert the change first made in a6fe4dc, as we are now generalizing
the warning here to all safe_reraise() cases in Python 2.
- Revisiting :ticket:`2696`, first released in 1.0.10, which attempts to
work around Python 2's lack of exception context reporting by emitting
a warning for an exception that was interrupted by a second exception
when attempting to roll back the already-failed transaction; this
issue continues to occur for MySQL backends in conjunction with a
savepoint that gets unexpectedly lost, which then causes a
"no such savepoint" error when the rollback is attempted, obscuring
what the original condition was.

The approach has been generalized to the Core "safe
reraise" function which takes place across the ORM and Core in any
place that a transaction is being rolled back in response to an error
which occurred trying to commit, including the context managers
provided by :class:`.Session` and :class:`.Connection`, and taking
place for operations such as a failure on "RELEASE SAVEPOINT".
Previously, the fix was only in place for a specific path within
the ORM flush/commit process; it now takes place for all transational
context managers as well.
fixes #2696

(cherry picked from commit 8a1e619fb20df1be6ad2e0c563e451e17eb17628)

fix %x string format to compatible with Python 3.5
(cherry picked from commit 4b9f6f407ceedde247982501a6ae406242c80b4a)

fix %x string format to compatible with Python 3.5
(cherry picked from commit 324e532d6081d9b9ea90bf3945cecfc792264f8d)

- unfortunately we need to match within join where col.key does not match
what's given so we need to use a set() here.  contains_column is not within
any performance paths

(cherry picked from commit 5742e321b261c0c1303835b80418cd3cdc1b5643)

- rework ColumnCollection to no longer persist "all_col_set"; we don't
need this collection except in the extend/update uses where we
create it ad-hoc.  simplifies pickling.  Compatibility with 1.0
should be OK as ColumnColleciton uses __getstate__ in any case
and the __setstate__ contract hasn't changed.
- Fixed bug in :class:`.Table` metadata construct which appeared
around the 0.9 series where adding columns to a :class:`.Table`
that was unpickled would fail to correctly establish the
:class:`.Column` within the 'c' collection, leading to issues in
areas such as ORM configuration.   This could impact use cases such
as ``extend_existing`` and others.  fixes #3632

(cherry picked from commit 8163de4cc9e01460d3476b9fb3ed14a5b3e70bae)

- fix array test that was essentially taking a weird guess
at the primary key of a row based on other tests invoking around it

- fix stray connection

(cherry picked from commit 2419bfe34cd5a1f4ead67d556ba74f3f1950762b)

- restate the "secondary" / AssociationProxy warning more strongly.
references #3638

(cherry picked from commit 67a69da3aa86c8b2b560ed79a9c91408ad704879)

- use uuid fragments for provision names to enable multiple test suites
per server

(cherry picked from commit 65010e97bca995657c2843f6aa8ad48bab370182)

- native unicode expectations are too difficult to maintain
w/ the number of drivers /DBURIs /  python versions

(cherry picked from commit d18d6d9baf4c98c47af70c0a7c796423396a51c1)

- move out match compiler test to test_compiler
- test_query isn't assertscompiledsql

(cherry picked from commit 269313218ddd06a21387085295c553becbd00e46)

- add missing IGNORE_EXCEPTION_DETAIL flag

- add a forwards-test here as well

(cherry picked from commit 38958f7b3f3e6009c419ba8e021f2b14c1f2b89a)

- documenation updates to clarify specific SQLite versions
that have problems with right-nested joins and UNION column keys;
references #3633 references #3634.   backport from 1.1 to 0.9
announcing 1.1 as where these behaviors will be retired based
on version-specific checks
- fix test_resultset so that it passes when SQLite 3.10.0 is
present, references #3633

(cherry picked from commit 89fa08792e98b9e31452aa3c949d9b909b10e7cd)

- generalize the verbiage on LargeBinary so that it doesn't
create confusion for inherited classes such as BYTEA, fixes

(cherry picked from commit 47d8858c54401cdf10285b7935049faf87432f55)

- update oracle JDBC driver URL, fixes #3554

(cherry picked from commit 24dba714cb56e1f5a4dca5453cc5f442e6ee08ab)

- cross link for concrete helper classes
- remove redundant concrete helper docs from declarative docs,
two places is enough

(cherry picked from commit a53bd6f74b4f41fd04c8cde1f8b58bbb766fe18d)

- typo

(cherry picked from commit b53667526eb9b2fabccfb097a5b76906d6452249)

- redo the docs for concrete inheritance to more strongly
favor declarative, fixes #2890

(cherry picked from commit 632c4f21fa3cab353b801f585183494c529c6896)

- clarify the "Adding" section also illustrates updates, fixes #2942

(cherry picked from commit 02271efd8976154f855646478b5438db078f7101)

- add a note that the literal_binds flag should be used
when cross-compiling from DDL to SQL, fixes #3615

(cherry picked from commit 165fa15b0f9dbca50539aa7da377c5da5ac0fc79)

Fix ArrayOfEnum's handling of empty arrays.

Prior to this change a value of `'{}'` would split into the list `['']`.
(cherry picked from commit a2badb751f09299c925bd96a9fd2e76acca04269)

- Fixed bug where some exception re-raise scenarios would attach
the exception to itself as the "cause"; while the Python 3 interpreter
is OK with this, it could cause endless loops in iPython.
fixes #3625
- add tests for reraise, raise_from_cause
- raise_from_cause is the same on py2k/3k, use just one function

(cherry picked from commit d4d9a6524886eb33644e8ce42212267fa569e555)

Fix typo in relationships docs

(cherry picked from commit f9b21855861c1c8983acc934fe47546d71a1df05)

- fix People -> Person , fixes #3628

(cherry picked from commit 66560cef7457d69f56cd2ca3bab93cb033a61a84)

- illustrate these using the newer exception doctest format.
unfortunately we can't show the SQL unless we filtered it out
from doctest...not worth it

(cherry picked from commit 7bb578b1bd61ec9a2506d1bdb60bb28579204808)

- there was a DATEPART test after all, fix format

(cherry picked from commit 0ff3f95d5b41335c977e1bdbe88b7dfd4ae581e1)

- fix some old verbiage that refers to text() as an "implicit" thing
for SQL fragments; we've deprecated that in 1.0 and its a good idea
to document like this for 0.9 as well.

(cherry picked from commit d5d7284bdd0ffc96e7a79354944627cf9b5d8e4d)

Remove quote on first DATEPART paramater
(cherry picked from commit c4f415d97988bc8a8d901b150bfb67571f29712e)
- changelog for pr bitbucket:70, fixes #3624

(cherry picked from commit 215167d8d38a381d27c8448f5c6e50c70b9ba0cc)

- fix link to types in metadata, fixes #3618
- fix "version" got whacked into "f" in core tutorial
- fix short underline in automap
- fix unmatched boldface in session events

(cherry picked from commit d03477d4b761132f44c48417be09d622ad9adfd3)

Update SQLAlchemy-Migrate link to the new repo
(cherry picked from commit 56b76ce7a823a076bd91490f940df95ad409db61)

Fix typo in session docs

(cherry picked from commit bb294497558f96c92253a4a68129a7c7984d3af9)

- Fixed regression since 0.9 where the 0.9 style loader options
system failed to accommodate for multiple :func:`.undefer_group`
loader options in a single query.   Multiple :func:`.undefer_group`
options will now be taken into account even against the same
entity. fixes #3623

(cherry picked from commit c7ae0daf0ed24e2697d6f948db2d9fdc5953c795)

updated sphinx tageting

(cherry picked from commit a0612a4d345019ea603a4d0bccb4ddcab3848af6)

- dont forwards-report tons of 1.0.x changes in the unreleased 1.1;
only when a 1.1.x is released would we want to capture what's still
sitting in a 1.0.x changelog

(cherry picked from commit 16746dd1a63198e3c27422517fa22ec76f441ceb)

- version bump

- Fixed 1.0 regression where the eager fetch of cursor.rowcount was
no longer called for an UPDATE or DELETE statement emitted via plain
text or via the :func:`.text` construct, affecting those drivers
that erase cursor.rowcount once the cursor is closed such as SQL
Server ODBC and Firebird drivers.
fixes #3622

(cherry picked from commit 197ffa2be2cadce3df8bfb0799b3c80158250286)

1.0.11

- An adjustment to the regular expression used to parse MySQL views,
such that we no longer assume the "ALGORITHM" keyword is present in
the reflected view source, as some users have reported this not being
present in some Amazon RDS environments.
fixes #3613

(cherry picked from commit 8c54b14b5c0feee41bd9b9032f6b17b2dbd560a9)

- changelog for pullreq github:222

(cherry picked from commit 5c7ade2f4218b55db8f758949b82a3414474aeb2)

Add new reserved words for MySQL 5.7.

(cherry picked from commit 03ee4bbda671f9d33dd2e990101840cdfde71e81)

- varchar requires a length

(cherry picked from commit 0c8242b26e6c7c2d373ae11ad5a3f97d75e6299c)

- add the test from ref #3614 as well for testing ref #3611

(cherry picked from commit 4b708c48398f6451b6ab0a940a1f247ebcfe26ac)

- just use *arg straight without "key" for pop

(cherry picked from commit 5e5b8a96a7978f5a73a4bd248767122efc5ea265)

- Further fixes to :ticket:`3605`, pop method on :class:`.MutableDict`,
where the "default" argument was not included.
fixes #3605

(cherry picked from commit 913858c949ae9ca6250217d82d72c7d79e9f6585)

Make docs listing of param order for event.listen match the code
(cherry picked from commit 30be49c157e6ebe47c32abb98a570a013418b1e6)

some spelling fixes

(cherry picked from commit 738d515b95f1ff94d7dfd265883237d247d1c153)

- remove errant pdb, references #3612

(cherry picked from commit 03ee22f342bbef9b15bfc989edda6a4ac3910508)

- Fixed bug in baked loader system where the systemwide monkeypatch
for setting up baked lazy loaders would interfere with other
loader strategies that rely on lazy loading as a fallback, e.g.
joined and subquery eager loaders, leading to ``IndexError``
exceptions at mapper configuration time.
fixes #3612

(cherry picked from commit a22b2085068f860d05dbb98631d2ac2079a12b39)

- hyperlink default-related parameters

- Fixed regression caused in 1.0.10 by the fix for :ticket:`3593` where
the check added for a polymorphic joinedload from a
poly_subclass->class->poly_baseclass connection would fail for the
scenario of class->poly_subclass->class.
fixes #3611

(cherry picked from commit a8ec3491983ed5e68452514b4d52a4347377809f)

- add some more oracle skips

(cherry picked from commit c42725ed54a61d7e5a0931404ee83aa6b94d0aea)

- a few tweaks to allow "server_defaults" to be a little more linkable;
remove "undoc members" that was putting some random server_default
atributes from ColumnClause

- since we are mutating the statement in a loop, start with
the same cached starting statement each time.  no issue has been observed
with the former but it could perhaps have issues w/ versioning
or eager_defaults

(cherry picked from commit d0fc7269888247517ffa16d9472f961ebec892a7)

- Fixed bug where :meth:`.Session.bulk_update_mappings` and related
would not bump a version id counter when in use.  The experience
here is still a little rough as the original version id is required
in the given dictionaries and there's not clean error reporting
on that yet.
fixes #3610

(cherry picked from commit 26ed90ab22dde7bdafe933cb1d16acfe70c1ab78)

- Fixed bug in :meth:`.Update.return_defaults` which would cause all
insert-default holding columns not otherwise included in the SET
clause (such as primary key cols) to get rendered into the RETURNING
even though this is an UPDATE.

- Major fixes to the :paramref:`.Mapper.eager_defaults` flag, this
flag would not be honored correctly in the case that multiple
UPDATE statements were to be emitted, either as part of a flush
or a bulk update operation.  Additionally, RETURNING
would be emitted unnecessarily within update statements.

fixes #3609

(cherry picked from commit 0e4c4d7efc08d04c3c0ae960428b08ada37e4a91)

- 1.0.11

- Fixed bug where use of the :meth:`.Query.select_from` method would
cause a subsequent call to the :meth:`.Query.with_parent` method to
fail. fixes #3606
- add mark-as-fail test for #3607

(cherry picked from commit 7d96ad4d535dc02a8ab1384df1db94dea2a045b5)

1.0.10

- Added support for the ``dict.pop()`` and ``dict.popitem()`` methods
to the :class:`.mutable.MutableDict` class.
fixes #3605

(cherry picked from commit 5710a1e88bf669227959ca950b56d1072520b255)

- convert ORM tutorial and basic_relationships to favor
back_populates while still maintaining great familiarity
w/ backref so as not to confuse people.  fixes #3390

(cherry picked from commit 741b8af31bb436356b9e8950c045761a0e054fe0)

- The ORM and Core tutorials, which have always been in doctest format,
are now exercised within the normal unit test suite in both Python
2 and Python 3.
- remove the old testdocs.py runner and replace with test/base/test_tutorials.py
- use pytest's unicode fixer so that we can test for unicode strings
in both py2k/3k
- use py3k format overall for prints, exceptions
- add other fixers to guarantee deterministic results
- add skips and ellipses to outputs that aren't worth matching

(cherry picked from commit d533b8e9223b9c938655e5b666fc928e2d996cd3)

fix some typos

(cherry picked from commit 7e6f3312333d09a051d01509d8c423708d3fbca3)

- Fixed issue within the :meth:`.Insert.from_select` construct whereby
the :class:`.Select` construct would have its ``._raw_columns``
collection mutated in-place when compiling the :class:`.Insert`
construct, when the target :class:`.Table` has Python-side defaults.
The :class:`.Select` construct would compile standalone with the
erroneous column present subsequent to compilation of the
:class:`.Insert`, and the the :class:`.Insert` statement itself would
fail on a second compile attempt due to duplicate bound parameters.
fixes #3603

(cherry picked from commit e57bf796169282f69187f50665f5ea233c2c9ab7)

- fix changelog for #3602
- add version switch for backend fsp test

- make this DROP conditional, attempting to isolate why jenkins has
an issue with just one test

(cherry picked from commit 7df4054b04ed54504be2c2ab8a83721748130780)