Remove twisted version comment in module docstring

Let the documentation in `TwistedResolver` specify the minimum
version.

Merge pull request #2612 from bdarnell/download-script

Add script to download wheels from appveyor

Add script to download wheels from appveyor

Merge pull request #2606 from ploxiln/travis_update_xenial

travis-ci tests: always use dist xenial

Merge pull request #2609 from fchapoton/patch-1

remove duplicate import of gettext

remove duplicate import of gettext

travis-ci tests: always use dist xenial

Travis-CI Trusty Container-based environment was available
between July, 2017 and December, 2018.
https://docs.travis-ci.com/user/reference/overview/#deprecated-virtualization-environments

Merge pull request #2605 from bdarnell/python-352

Fix importability on python 3.5.2

Fix importability on python 3.5.2

The "provisional" typing module in 3.5.2 is kind of broken/incomplete
so we need to use more forward references to avoid confusing it. The
significance of this version in particular is that it was the one
included in ubuntu 16.04.

Fixes #2604

Merge pull request #2603 from bdarnell/version-bump

Bump master branch to 6.1.dev1

Bump master branch to 6.1.dev1

Merge pull request #2602 from bdarnell/version-6.0

Set version to 6.0

Set version to 6.0

Merge pull request #2588 from bdarnell/6.0b1

Set version to 6.0b1

Set version to 6.0b1

Merge pull request #2587 from bdarnell/opt

ioloop: Micro-optimize IOLoop.add_future

Merge pull request #2586 from sadielbartholomew/minor-docs-improvements

docs: assorted minor e.g. formatting improvements

Merge pull request #2580 from bdarnell/remove-log

httputil: Remove a noisy log line

Merge pull request #2581 from bdarnell/websocket-open-catch

websocket: Catch errors in async open() correctly

Minor formatting & grammatical etc. edits to docs

ioloop: Micro-optimize IOLoop.add_future

Asyncio Futures always schedule their callbacks on a future iteration
of the IOLoop, so routing the callbacks through IOLoop.add_callback
again was redundant and causing unnecessary delays in callback
execution.

websocket: Catch errors in async open() correctly

Previously if open() was a coroutine and raised an error, the
connection would be left open.

Fixes #2570

httputil: Downgrade a noisy log line

Only complain about unsupported content encodings if it's a
content-type we'd otherwise try to parse.

Fixes #2578

Merge pull request #2566 from BoboTiG/fix-resource-leaks

Fix ResourceWarning: unclosed file

Fix ResourceWarning: unclosed file

Signed-off-by: Mickaël Schoentgen <contact@tiger-222.fr>

Merge pull request #2565 from bdarnell/docs-6.0a1

Release notes for 6.0a1

init: set version to 6.0a1

setup: Don't repeat version number in setup.py

docs: More 6.0 release notes

First part of 6.0 release notes: note all deprecated removals

docs: Update homepage for 6.0

Merge pull request #2440 from bdarnell/validate-redirect

httpclient: Validate redirect location header and method

simple_httpclient: Only convert POST requests to GETs on redirect

Convert POST to GET on 301 in addition to 302 and 303.

http1connection: Fix a bug with redirects and chunked requests

After a redirect, the chunked-encoding header is already set and would
not be detected correctly. This affects empty bodies with
allow_nonstandard_methods and any use of body_producer.

Revert "Revert "_HTTPConnection: check location on _should_follow_redirect() and retain safe request when following redirects (#2409)""

This reverts commit dda77f2ca3365bd031a0c56dd19c8ed781a0695a.

Merge pull request #2564 from bdarnell/queue-warning

queues: Add a note to Queue.get about difference from stdlib

queues: Add a note to Queue.get about difference from stdlib

Tornado's interpretation of the timeout argument differs from the
stdlib's queue.

Fixes #2370

Merge pull request #2563 from bdarnell/docs-update

docs: Various updates

concurrent: Update docs

auth: Update docs

queues: Update docs

locks: Update docs

gen: Update docs

iostream: Update docs

ioloop: Update docs

httpclient: Update docs

httpserver: Update docs

docs: Add sphinxcontrib-asyncio

This adds a "coroutine" marker to native coroutines

websocket: Change some Future type annotations to Awaitables

This conforms with usage elsewhere, that methods returning None use
Futures (self-starting in case the result is not awaited) and others
use Awaitable (reserving the option to use more efficient native
coroutines).

escape: Update docs

Replace to_basestring with an alias for to_unicode, since the two are
equivalent on py3.

web: Update docs

Merge pull request #2562 from bdarnell/docs-update

docs: Minor updates

docs: Remove year from copyright variable

Computing this dynamically is wrong and it doesn't seem worth the
trouble to maintain manually.

Closes #2258
Closes #2259

docs: Use python 3.7 via conda for readthedocs builds

The typing module in python 3.5 has problems with some type
annotations so we need to build with 3.7. RTD doesn't yet support py37
natively but we can get it with conda following an example at
https://github.com/rtfd/readthedocs-docker-images/pull/73

docs: Blacken conf.py

docs: Upgrade sphinx to 1.8

The bug that kept us on 1.7 was fixed in 1.8.2.

Merge pull request #2561 from bdarnell/contextvars-test

gen_test: Verify that contextvars work as expected

gen_test: Verify that contextvars work as expected

Merge pull request #2560 from bdarnell/websocket-cleanup

websocket: Convert to native coroutines, refactor

websocket: Convert legacy coroutines to native

websocket: Make WSH.get a coroutine

This is necessary to convert accept_connection to native coroutines -
the handshake no longer completes within a single IOLoop iteration
with this change due to coroutine scheduling.

This has the side effect of keeping the HTTP1Connection open for the
lifetime of the websocket connection. That's not great for memory, but
might help streamline close handling. Either way, it'll be refactored
in a future change.

websocket: Narrow the websocket handler interface

Pass close arguments via a new method instead of setting attributes.
Extract a "params" struct.

websocket: Merge close detection into receive_frame_loop

This avoids races between message handling and the close callback.

testing: Cancel all pending coroutines in tearDown

It's difficult to synchronize test shutdown with the exits of all
coroutines, so explicitly cancel all native coroutines (which are
spammy when allowed to be GC'd).

Suppress logging of CancelledErrors in IOLoop.

Release app references in AsyncHTTPTestCase tearDown method (#2554)

Releasing the application and HTTP server references in tearDown helps
encourage the GC to clean up resources passed through the application
settings.

Merge pull request #2549 from garenchan/bugfix-#2448

web: Use 'future_add_done_callback' to add callback.

Use 'future_add_done_callback' to add callback.
The PR #2449 was incomplete, it omited consideration of another
branch of the 'flush' method. In short, the future returned by
'RequestHandler.finish()' may also be the return value of
'HTTP1Connection.write()'. So we should make the same change to
'HTTP1Connection.write()'.

Fix #2448.

websocket_test: Remove most manual closes

At one time this was necessary to prevent spurious warnings at
shutdown, but not any more (and I intend to address warnings like this
with a more general solution).

Merge pull request #2545 from bdarnell/future-exception-cancel

concurrent: Add future_set_exception_unless_cancelled

Merge pull request #2544 from bdarnell/httpclient-del

httpclient: Fix warning logged by sync HTTPClient destructor

httpclient: Fix warning logged by sync HTTPClient destructor

If an HTTPClient is closed from its destructor instead of an explicit
close() call, it sometimes logs an "inconsistent AsyncHTTPClient
cache" error because the weakrefs appear to get cleaned up in an
unexpected order. Relax the checks in AsyncHTTPClient.close to allow
for a missing value in the instance cache.

Fixes #2539

concurrent: Remove some pre-6.0 compatibility code

concurrent: Add future_set_exception_unless_cancelled

Tornado's limited support for cancellation means that errors after a
Future is cancelled could get raised (and probably logged) as
InvalidStateErrors.

This new function effectively changes the behavior to log the real
exception instead of the InvalidStateError. We log them instead of
ignoring them because it's generally not a good idea to let errors
pass silently even if they're after the point that no one is listening
for them (this is consistent with the way gen.multi() handles multiple
errors, for example).

Fixes #2540

Merge pull request #2524 from kinow/define-xsrf-expires-day

Define XSRF cookie expires_day via settings

Use kwargs for expires_days, and remove default of 30 days

Merge pull request #2528 from zejn/master

Add support for source IP address to SimpleAsyncHTTPClient.

Merge pull request #2512 from dhiltonp/master

allow configurable max_restarts in TCPServer.start

Fix #2521: Serve full file when range start is negative and exceeds the total length (#2522)

* Serve full file while range negative past start.

Fix issue #2521.

* Return 416 while range end less than start.

When range end less than start, the content length will be negative and
HTTPOutputError will be raised.

Merge pull request #2530 from bdarnell/requirements

maint: Update requirements

Merge pull request #2529 from bdarnell/blacken-demos

demos: Format all the demos with `black`

maint: Update requirements

Pick up a security fix in `requests`, and add mypy and black to the list.

http1connection: Fix some weird formatting

`black` refused to move the operator across the comment, leaving it
stranded on a line by its own. The most recent version of pycodestyle
complains about this.

demos: Format all the demos with `black`

Add support for source IP address to SimpleAsyncHTTPClient.

Extend support for HTTPRequest's network_interface parameter to
SimpleAsyncHTTPClient. This enables binding to specific local IP and
enables connecting to WebSockets via a specific IP address.

To use it you create a HTTPRequest with network_interface parameter set
to local IP address to be used as source IP. websocket_connect then
passes the request to SimpleAsyncHTTPClient.

Note that even though the parameter name is `network_interface`, the
CurlAsyncHTTPClient may support (OS dependant) passing in interface
name, resolvable hostname or IP address, while this patch only adds
IP address support to SimpleAsyncHTTPClient.

allow configurable max_restarts in TCPServer.start

Merge pull request #2520 from bdarnell/native-coro

*: Convert most non-test coroutines to native

*: Convert most non-test coroutines to native

The websocket module is an exception; it needs a little more work to
change things without breaking tests.

Merge pull request #2519 from bdarnell/escape-nightly

web: Fix "invalid escape sequence" error on nightly python

ci: Enable warnings-as-errors earlier

This catches import-time warnings in more modules, including a warning
about invalid escape sequences that is now an error on nightly python.

Merge commit 'pull/origin/2506'

Merge pull request #2518 from bdarnell/iostream-ssl-error-log

iostream: Add errno 0 to the list of silent errors in TLS handshakes

iostream: Add errno 0 to the list of silent errors in TLS handshakes

This error is possible for some connections that don't follow through
with the TLS handshake.

Fixes #2504

Merge pull request #2509 from onovy/new-ssl-cert

Regenerate test crt

locks: Convert to native coroutines

web: Convert RequestHandler._execute to a native coroutine

http1connection: Convert to native coroutines

Merge pull request #2514 from bdarnell/mypy

*: Finish adding type annotations

travis: Run docs CI on py37

We were running it on py36 as a bit of manual bin-packing to optimize
total CI runtime, but sphinx-on-py36 has some bugs in annotation
introspection that we run into.

web,template: Work around test failures on pypy3

pypy3 doesn't yet have the typing.ContextManager type, and
https://bitbucket.org/pypy/pypy/issues/2868/segfault-with-args-type-annotation-in

Merge remote-tracking branch 'origin/master' into mypy