Coroutine exception __context__ leak in python 3

In Python 3 every exception has an auto-attached __context__ exception if it was
raised while an existing exception was being handled.  This is often a very
useful property and allows users to see the underlying cause of many problems.

However, when dealing with async code via coroutines this feature can suddenly
become a pretty big issue.  Namely, if you generator.throw back into a coroutine
to raise an exception in the correct scope, and that coroutine raises an
exception at a later time you can have nested exceptions which shouldn't
logically be nested.

This patch resolves this issue in the coroutine code by moving the gen.throw
outside of the exception handler.  By doing this the user-code scope is able to
later raise exceptions without worrying about inheriting prior exception
context.

Merge pull request #1290 from nosyjoe/branch4.0-mrbeam

Avoid busy waiting in ioloop when system time is skipped forward

modified method _schedule_next of PeriodicCallback to handle sudden changes of the system time differently:
 * calculating next timeout value directly while advancing by a multiple of callback_time
 * when the system time changes, jumps into the future make the _schedule_next method do a busy wait.
 * on slow machines (RPi), jumps of a few months into the future can block the loop for a few minutes
=> added a check for big differences in current system time and the current value of the next scheduled timeout

On a first boot of an older RPi image, tornado sometime starts before the date&time were updated through NTP, hence blocking the ioloop for several minutes.

Enable sphinx doctests on travis-ci

Make many doc code blocks into sphinx doctests.

Enable the sphinx doctest extension.

More flake8 cleanup.

The only remaining flake8 errors are for line length.

Run autopep8

Update requirement versions; add flake8 and twine

Allow unicode strings in import_object in python 2.

Fixes #1316.

Merge pull request #1327 from josephok/master

some modifications in demos/benchmark so it can run both in py2 and py3

Merge pull request #1325 from ccampbell/master

Skip falsy values for some SimpleCookie flags

Bump master branch version number

Set version number to 4.1

Finalize 4.1 release notes.

some modifications in demos/benchmark so it can run both in py2 and py3

Add unit tests for new cookie behavior

Skip falsy values for SimpleCookie flags

Fixes #1324

Set version number to 4.1b2

Update docs for UIModule.

Use self.io_loop in with_timeout tests.

Silence a warning on freebsd.

This was already changed for other platforms but the error behaves
a bit differently on freebsd.

Merge branch 'master' of github.com:tornadoweb/tornado

Disable twisted_web tests on python 3.

The twisted.web modules are importable as of Twisted 15.0.0,
but appear to still have internal str/bytes issues.

Merge pull request #1319 from hfaran/patch-1

Add syntax highlighting to Hello World example

Fix a DeprecationWarning in twisted_test with Twisted 15.0.

Add syntax highlighting to Hello World example

Merge branch 'stable'

Merge pull request #1312 from FreeAquar/patch-1

a wrong describle

a wrong describle

Replace most testing uses of 'localhost' with '127.0.0.1'.

This may work around a suspected ipv6-related issue on travis.

Include the ability to yield asyncio and twisted objects in highlights

Set version number to 4.1b1

Fix doc coverage for WaitIterator.

Clean up release notes

Update release notes and docs.

Merge remote-tracking branch 'Caligatio/ws_message_callback'

Conflicts:
tornado/websocket.py

Give curl_httpclient its own logger for its verbose debug output.

This makes it easier to filter it separately.

This commit is an updated recreation of
https://github.com/SuminAndrew/tornado/commit/88809314e853fb69610cf44095612e78b0882c3e
to account for code movement.

Closes #1093.

Merge pull request #1286 from vovanec/patch-1

Added support for custom web socket protocols.

Introduce gen.sleep().

Closes #1146.

Singledispatch and twisted don't work well together on py26.

Only install singledispatch on py27.

Document convert_yielded.

Add bidirectional asyncio future conversion.

Add a convert_yield adapter for twisted Deferreds.

Document the AsyncIOLoop.asyncio_loop attribute for public use.

Use functools.singledispatch for convert_yielded when available.

Register a converter for asyncio.Future and add tests.

Refactor coroutine yield handling.

Extract a convert_yielded function that can be extended with other types.

Call the WebSocketHandler.on_close method regardless of which side closed.

Closes #1173.

Convert WaitIterator to use while-like iteration instead of for-like.

Make current_future and current_index attributes instead of methods.
Restructure the internals to avoid quadratic performance.

Fix test; cleanup whitespace.

Merge remote-tracking branch 'jordanbettis/feature-waitany' into wait-any

Work around an occasional EPROTOTYPE error on OSX.

Fix broken link in docs.

A new IOLoop is automatically "current" if there isn't already one.

IOLoop keyword arguments throughout the library are now deprecated
in favor of IOLoop.current(). This is because the gen module
uses IOLoop.current() with no opportunity to pass in a different
instance, making it impossible in some cases to use a non-current
IOLoop with AsyncHTTPClient.

Closes #1252.

Update next-release notes.

Add a blanket try/except when parsing multipart form bodies.

This mirrors the behavior for form-urlencoded bodies, as well as the
handling of selected errors in parse_multipart_form_data.

Closes #1267.

Document PeriodicCallback.is_running.

Merge pull request #1303 from ami-GS/external

add is_running to get PeriodicCallback state

Prevent a double-timeout in TCPClient.

This fixes a non-deterministic failure in the tests.
Also fix another less-common failure in test.util.refusing_port.

add is_running to get callback state

Allow SSLError or socket.error in this test.

Fix LogCounter on py26

Fix another unexamined Future

Merge branch 'log_future'

Consider the tests failed if they log any non-filtered warnings or errors.

Log more uncaught exceptions instead of suppressing them.

Add more docs about Future exception logging.

travis-ci: don't install pycurl on pypy3.

Merge pull request #1299 from ysimonson/feature/ignore-xsrf-errors

Handle bad xsrf tokens more gracefully

Merge commit 'bbd1f9'

Conflicts:
.travis.yml

Addressed comments from Ben

Addressed comments from Ben. Added get_websocket_protocol() to WebSocketClientConnection class as well.

More aggressive capturing of xsrf cookie errors

Make Application.start_request match HTTPServerConnectionDelegate.start_request.

This was always intended, but unfortunately the change to HTTPServer
is backwards-incompatible.

Merge pull request #1270 from djvis/master

Use server_hostname parameter in call to ssl_wrap_socket

Catch up on next-release notes.

Correct handling of HTTP version numbers.

Per RFC 7230 section 2.6, we always output HTTP/1.1 even if the
request was HTTP/1.0 (and we accept any 1.x version).

Fix regression in support for both CRLF and bare LF in headers.

Closes #1297.

Fix httputil_test on python 3.2.

Fix header parsing with unicode newline-like characters.

We were using python's unicode.splitlines(), which recognizes
more characters than just CRLF and could cause problems if those
characters appeared in header values.

Fixes #1291.

Refactor connection-closed tests.

On CI servers, port numbers get reused frequently, so a closed
port cannot be relied upon to refuse connections for long.
We now use an open client-side socket's ephemeral port,
which will always refuse connections and cannot be reused
for as log as the socket is open.

Merge pull request #1296 from asvetlov/master

Mention in Sec-WebSocket-Version all versions supported by tornado

Merge pull request #1294 from lmas/master

Fixed TCPServer not setting the correct read_chunk_size.

Merge pull request #1285 from lwzm/master

Ensure that HTTPServerRequest.body is a byte string

Clarify docs: `return` in generator is new in 3.3.

Merge pull request #1300 from arihantagarwal/arihant

Changed 'return' to 'raise gen.Return()' to fix Issue #1292

Changed 'return' to 'raise gen.Return()' to fix Issue #1292, explanation added.

Handle bad xsrf tokens more gracefully

Mention in Sec-WebSocket-Version all versions supported by tornado
 As RFC 6455 recommends for asnwer for unsopported protocol.

Fixed TCPServer not setting the correct read_chunk_size.

Added support for custom web socket protocols.

Added support for custom web socket protocols.

To add custom protocol implementation user should override get_websocket_protocol_subclass() method in WebSocketHandler subclass.

Ensure that HTTPServerRequest.body is a byte string

HTTPServerRequest.body should be bytes but it is an empty string that
occurs in Python3 when pass no body to HTTPServerRequest.

Skip test if check_hostname functionality not available

Add test to ensure stream start_tls calls use the server_hostname parameter

Merge pull request #1281 from nordaux/master

Fixed error that the web.asynchronous doesn't complete python3 concurrent.Futures

Fixed error that the web.asynchronous doesn't complete python3 concurrent.Futures

Merge pull request #1279 from chrisseto/patch-1

Fix typo in `stream_request_body`

Fix typo in `stream_request_body`

Merge pull request #1261 from lilydjwg/fix-ipv6-host

fix matching an IPv6 address as host

move code to seperate function 'split_host_and_port'

remove executable permission from tornado.web

Merge branch 'master' into fix-ipv6-host