Fix IOStream.write() to never orphan Future

The current behaviour is error-prone and makes it difficult to use the
Future-returning variant of IOStream.write().  This change makes sure
the returned Future is triggered as soon as the corresponding write
is issued.

Merge pull request #1985 from bdarnell/websocket-convert-yielded

websocket: Avoid calling convert_yielded twice on the same object

Merge pull request #1864 from leynos/master

Allow specificion of trusted downstream proxies for xheaders

Merge pull request #1716 from seirl/master

gen: handle None in convert_yielded

Merge pull request #1817 from mivade/colorama

Enable color logging on Windows via colorama

Merge pull request #1972 from andreasrosdal/master

Add compression_level and mem_level to WebSocketHandler.get_compression_options()

Merge pull request #1984 from bdarnell/autoreload-no-close

autoreload: Don't close the IOLoop on reload

websocket: Avoid calling convert_yielded twice on the same object

This is not allowed for native coroutines, although for reasons I
can't put my finger on it only fails intermittently (in the one test
we have that uses this with native coroutines).

Replace func directive with double backticks

Use the member variables instead of arguments for self._compression_level and self._mem_level.

autoreload: Don't close the IOLoop on reload

This was a last-ditch effort to close file descriptors that were not
marked as CLOEXEC. However, it was never complete (it didn't touch
file descriptors that were not registered on the IOLoop), and it can't
work with asyncio (which does not allow closing the IOLoop without
stopping it and unwinding the stack first). Since Tornado (and
hopefully all major libraries using the IOLoop) is careful about
setting CLOEXEC when needed, just get rid of the close.

Fixes #1543

Merge pull request #1971 from SuminAndrew/remove-with_statement

remove redundant with_statement feature

Merge pull request #1963 from protonpopsicle/master

HTTPServer pass no_keep_alive option to conn params

Merge pull request #1966 from JZQT/master

Make `tornado.log.LogFormatter` compatible with `logging.config.dictConfig`.

Add parameter compression_options=None.

Make compression options argument optional.

Fix for Python 2.7.

Add compression_level and mem_level to WebSocketHandler.get_compression_options().

remove redundant with_statement feature

Merge pull request #1969 from iver56/patch-1

Fix typo "you app" -> "your app"

Fix typo "you app" -> "your app"

Make `tornado.log.LogFormatter` compatible with `logging.config.dictConfig`.

Leave calling colorama.init to the user

Merge pull request #1909 from ajdavis/on-message-coroutine

websocket: WebSocketHandler.on_message allows coroutines

websocket: WebSocketHandler.on_message allows coroutines

Fixes #1650

Merge pull request #1957 from bdarnell/ws-ping

websocket: Periodic pinging for failure detection

Merge pull request #1964 from dv321/websocket-client-callback

websocket: fix client message callback error

websocket protocol callback error handling uses getattr instead of direct attr access

httpserver: pass no_keep_alive option to connection params

Merge pull request #1873 from pitrou/bytearray_buffers

Use bytearray buffers in IOStream

web: Remove accidentally-set execute bit

Merge commit 'pull/origin/1653'

Merge pull request #1649 from xrmx/docwindows

docs: give more hints on why windows is unsupported

websocket: Support periodic pings from client side

Merge commit 'pull/origin/1938' into ws-ping

websocket: Move periodic pings from handler to protocol

Add a basic test.

Merge pull request #1956 from bdarnell/master

Misc updates

tox: Update some configs to use py36

Closes #1926

setup: Ship LICENSE file in tarball

Fixes #1897

docs: Remove direct tarball links and legacy install instructions

The tarball links were broken for many months without anyone noticing,
so apparently they weren't getting used (and anyone using them would
miss alternate release artifacts like the binary wheels we publish for
windows). Replace the hacks used to generate the tarball links with a
link to pypi and remove legacy manual installation instructions.

testing: Clarify docs of testing.main()

docs: Clarify limitations of native coroutines.

process: Silence "subprocess still running" warnings on python3.6

tcpclient: Close socket on source_ip bind failure

Silences a warning on python 3

Merge pull request #1954 from dinever/patch-1

Fixed a simple typo in websocket.py

Fix a typo

Merge pull request #1948 from jeffhunter/master

add support for HTTP 308 redirects

Merge pull request #1935 from mirceaulinic/SOURCE-IP

TCPClient: connect using specific source IP address and port

Merge pull request #1949 from ajdavis/asyncio-async-deprecated

Avoid deprecated asyncio.async() in test

Avoid deprecated asyncio.async() in test

add support for HTTP 308 redirects

Merge pull request #1945 from brianmego/patch-1

Documentation Typo

Documentation Typo

I kept misspelling "response" in my own project's docstrings and upon grepping to make sure it was totally wiped out, discovered it was also misspelled in here. Clearly the word has been misspelled since it's inception, but since we can't change English, let's update it here.

Skip port test if not unix

web: Remove obsolete doc about stream_request_body and async prepare

Fixes #1933

queues: Call out thread-unsafety in docs

Fixes #1923

Add tests for source_ip and source_port

Added option for triggering callbacks when PING frame is received
In order to implement proper application-level handling of disconnections
a developer may want to hook up into the standard "ping" mechanism
of the websocket protocol. This is important for systems where
both the client and the server need to keep track of disconnections,
but based on client-intiated pings only.

Support also source_port

Remove source_ip from _Connector init kwargs

Move bindin into _create_stream

TCPClient: connect using specific source IP address

Merge pull request #1932 from tao12345666333/master

Fix document PyPI download url

Fix document download url on pypi.

Merge pull request #1924 from duboviy/master

Add Python 3.6 support

Merge pull request #1899 from mr-ping/master

Rewrite url_concat function using PythonStandardLibrary

Add Python 3.6 support

Merge pull request #1916 from SuminAndrew/routing-docs

improve routing module docs and tests

improve routing module docs and tests

Merge pull request #1806 from SuminAndrew/routing

implement routing mechanism

Merge pull request #1906 from ajdavis/handle-stream-native-coro

tcpserver: handle_stream can be a native coroutine

Merge pull request #1911 from medariox/patch-1

Catch AttributeError in cpu_count()

Merge branch 'master' into handle-stream-native-coro

Merge pull request #1910 from ajdavis/preload-latin1

netutil: Preload the "latin1" codec

Merge pull request #1908 from takluyver/i1907

Use errno_from_exception on error caught in Waker

Merge pull request #1902 from pitrou/tcpserver_stop_twice

Fix #1901: fix TCPServer.stop() when called twice

Catch AttributeError in cpu_count()

Running
```Python 2.7.12 (v2.7.12:d33e0cf91556, Jun 27 2016, 15:24:40) [MSC v.1500 64 bit (AMD64)] on win32```
on Windows 10 64 Bit

Noticed this issue while running ```tox``` with ```pytest tornado 0.4.5``` and ```tornado 4.4.2```.

netutil: Preload the "latin1" codec

For reasons not yet understood, some Solaris users get intermittent
"LookupError: unknown encoding: latin1", this has been reported to
fix it.

Fixes #584

Use errno_from_exception on error caught in Waker

Addresses part of gh-1907

tcpserver: handle_stream can be a native coroutine

Fix #1901: fix TCPServer.stop() when called twice

allow HTTPServerConnectionDelegate as routing targets

Rewrite url_concat function using PythonStandardLibrary

Merge pull request #1889 from pitrou/future_warnings_at_shutdown

Avoid spurious warnings at shutdown

Update warning config to fix tests on python 3.6 nightly

Merge pull request #1893 from pitrou/coverage_failure_py3_c_locale

Fix error in coverage runs under Py3 with a C locale

Merge pull request #1890 from pitrou/coroutine_introspection

Improve introspection of coroutines

Merge pull request #1881 from ajdavis/file-example

docs: Demonstrate uploading and receiving files

add docs for web module

Fix error in coverage runs under Py3 with a C locale

Fix for PyPy

Improve introspection of coroutines

Avoid referencing globals in emulated is_finalizing()

Avoid spurious warnings at shutdown

When there are still active coroutines at interpreter shutdown, you can
see sometimes warnings such as:

Exception ignored in: <bound method Future.__del__ of <tornado.concurrent.Future object at 0x7f56a8b142e8>>
Traceback (most recent call last):
  File "/home/antoine/tornado/tornado/concurrent.py", line 338, in __del__
TypeError: 'NoneType' object is not callable

These are distracting and don't bear any useful information, so silence them.

add docs for routing module

[WIP] routing mechanism draft

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

Add comments and a docstring

Merge pull request #1867 from ajdavis/redirecthandler-url-pattern

web: Add regex support to RedirectHandler

docs: Demonstrate uploading and receiving files