Update twisted to 17.9.0

[pyup-bot]

This PR updates Twisted from 10.2.0 to 17.9.0.

Changelog

17.9.0

===========================

This is the last Twisted release where Python 3.3 is supported, on any
platform.

Features
--------

- twisted.python.failure.Failure is now a new-style class which subclasses
BaseException. (5519)
- twisted.internet.posixbase.PosixReactorBase.adoptStreamPort and
twisted.internet.posixbase.PosixReactorBase.adoptStreamConnection now support
AF_UNIX SOCK_STREAM sockets. (5573)
-  (8940)
- t.protocol.policies.TimeoutMixin.setTimeout and
t.protocol.policies.TimeoutProtocol.cancelTimeout (used in
t.protocol.policies.TimeoutFactory) no longer raise a
t.internet.error.AlreadyCancelled exception when calling them for an already
cancelled timeout. (9131)
- twisted.web.template.flatten now supports coroutines that yield Deferreds.
(9199)
- twisted.web.client.HTTPConnectionPool passes the repr() of the endpoint to
the client protocol factory, and the protocol factory adds that to its own
repr(). This makes logs more useful. (9235)
- Python 3.6 is now supported (9240)


Bugfixes
--------

- twisted.python.logfile.BaseLogFile and subclasses now always open the file in
binary mode, and will process text as UTF-8. (6938)
- The `ssl:` endpoint now accepts `certKey` PEM files without trailing
newlines. (7530)
- Logger.__init__ sets the namespace to "<unknown>" instead of raising KeyError
when unable to determine the namespace from the calling context. (7930)
- twisted.internet._win32serialport updated to support pySerial 3.x and dropped
pySerial 2.x support. (8159)
- twisted.python.rebuild now works on Python 3. (8213)
- twisted.web.server.Request.notifyFinish will now once again promptly notify
applications of client disconnection (assuming that the client doesn't send a
large amount of pipelined request data) rather than waiting for the timeout;
this fixes a bug introduced in Twisted 16.3.0. (8692)
- twisted.web.guard.HTTPAuthSessionWrapper configured with
DigestCredentialFactory now works on both Python 2 and 3. (9127)
- Detect when we’re being run using “-m twisted” or “-m twisted.trial” and use
it to build an accurate usage message. (9133)
- twisted.protocols.tls.TLSMemoryBIOProtocol now allows unregisterProducer to
be called when no producer is registered, bringing it in line with other
transports. (9156)
- twisted.web web servers no longer print tracebacks when they timeout clients
that do not respond to TLS CLOSE_NOTIFY messages. (9157)
- twisted.mail.imap4 now works on Python 3. (9161)
- twisted.python.shortcut now works on Python 3 in Windows. (9170)
- Fix traceback forwarding with inlineCallbacks on python 3. (9175)
- twisted.mail.imap4.MessageSet now treats * as larger than every message ID,
leading to more consistent and robust behavior. (9177)
- The following plugins can now be used on Python 3 with twistd: dns, inetd,
portforward, procmon, socks, and words. (9184)
- twisted.internet._win32serialport now uses serial.serialutil.to_bytes() to
provide bytes in Python 3. (9186)
- twisted.internet.reactor.spawnProcess() now does not fail on Python 3 in
Windows if passed a bytes-encoded path argument. (9200)
- twisted.protocols.ident now works on Python 3. (9221)
- Ignore PyPy's implementation differences in base object class. (9225)
- twisted.python.test.test_setup now passes with setuptools 36.2.1 (9231)
- twisted.internet._win32serialport SerialPort._clearCommError() no longer
raises AttributeError (9252)
- twisted.trial.unittest.SynchronousTestCase and
twisted.trial.unittest.TestCase now always run their tearDown methods, even
when a test method fails with an exception. They also flush all errors logged
by a test method before running another, ensuring the logged errors are
associated with their originating test method. (9267)


Improved Documentation
----------------------

- Trial's documentation now directly mentions the preferred way of running
Trial, via "python -m twisted.trial". (9052)
- twisted.internet.endpoints.HostnameEndpoint and
twisted.internet.endpoints.TCP4Client endpoint documentation updated to
correctly reflect that the timeout argument takes a float as well as an int.
(9151)
- Badges at top of README now correctly render as links to respective result
pages on GitHub. (9216)
- The example code for the trial tutorial is now compatible with Python3 and
the current version of Twisted. (9223)


Deprecations and Removals
-------------------------

- twisted.protocols.dict is deprecated. (9141)
- gpsfix.py has been removed from the examples. It uses twisted.protocols.gps
which was removed in Twisted 16.5.0. (9253)
- oscardemo.py, which illustrates the use of twisted.words.protocols.oscar, as
been removed. twisted.words.protocols.oscar was removed in Twisted 17.5.0.
(9255)


Misc
----

- 5949, 8566, 8650, 8944, 9159, 9160, 9162, 9196, 9219, 9228, 9229,
9230, 9247, 9248, 9249, 9251, 9254, 9262, 9276, 9308


Conch
-----

Bugfixes
~~~~~~~~

- twisted.conch.ssh.userauth.SSHUserAuthServer now gracefully handles
unsupported authentication key types. (9139)
- twisted.conch.client.default verifyHostKey now opens /dev/tty with no buffer
to be compatible with Python 3. This lets the conch cli work with Python 3.
(9265)


Deprecations and Removals
~~~~~~~~~~~~~~~~~~~~~~~~~

- twisted.conch.ssh._cryptography_backports has been removed in favor of using
int_to_bytes() and int_from_bytes() from cryptography.utils. (9263)


Misc
~~~~

- 9158, 9272


Web
---

Features
~~~~~~~~

- twisted.web.static.File.contentTypes is now documented. (5739)
- twisted.web.server.Request and any Twisted web server using it now support
automatic fast responses to HTTP/1.1 and HTTP/2 OPTIONS * requests, and
reject any other verb using the * URL form. (9190)
- --add-header "HeaderName: Value" can be passed to twist web in order to set
extra headers on all responses (9241)


Bugfixes
~~~~~~~~

- twisted.web.client.HTTPClientFactory(...).gotHeaders(...) now handles a wrong
Set-Cookie header without a traceback. (9136)
- twisted.python.web.http.HTTPFactory now always opens logFile in binary mode
and writes access logs in UTF-8, to avoid encoding issues and newline
differences on Windows. (9143)
- The code examples in "Using the Twisted Web Client" now work on Python 3.
(9172)
- twisted.web.server.Request and all web servers that use it now no longer send
a default Content-Type header on responses that do not have a body (i.e. that
set Content-Length: 0 or that send a 204 status code). (9191)
- twisted.web.http.Request and all subclasses now correctly fire Deferreds
returned from notifyFinish with errbacks when errors are encountered in
HTTP/2 streams. (9208)
- twisted.web.microdom, twisted.web.domhelpers, and twisted.web.sux now work on
Python 3. (9222)


Mail
----

Bugfixes
~~~~~~~~

- Sending a list of recipients with twisted.smtp.SenderFactory has been fixed.
This fixes a problem found when running buildbot. (9180)
- twisted.mail.imap4.IMAP4Server parses empty string literals even when they
are the last argument to a command, such as LOGIN. (9207)


Words
-----

Bugfixes
~~~~~~~~

- twisted.words.tap has been ported to Python 3 (9169)


Misc
~~~~

- 9246


Names
-----

Bugfixes
~~~~~~~~

- Queries for unknown record types no longer incorrectly result in a server
error. (9095)
- Failed TCP connections for AFXR queries no longer raise an AttributeError.
(9174)

17.5.0

===========================

Bugfixes
--------

- spawnProcess no longer opens an unwanted console on Windows (5726)
- The transition to the hyperlink package adds IPv6 support to
twisted.python.url.URL. This is now deprecated and new code should use
hyperlink directly (see 9126). (8069)
- twisted.logger now buffers only 200 events by default (reduced from 65536)
while waiting for observers to be configured. (8164)
- The transition of twisted.python.url to using the hyperlink package enables a
URL.click() with no arguments (or 0-length string argument) to resolve dot
segments in the path. (8184)
- twisted.protocols.finger now works on Python 3. (8230)
- TLS-related tests now pass when run with OpenSSL 1.1.0. This makes tests pass
again on macOS and Windows, as cryptography 1.8 and later include OpenSSL
1.1.0. (8898)
- UNIX socket endpoints now process all messages from recvmsg's ancillary data
via twisted.internet.unix.Server.doRead/twisted.internet.unix.Client.doRead,
while discarding and logging ones that don't contain file descriptors.
(8912)
- twisted.internet.endpoints.HostnameEndpoint and twisted.web.client.Agent work
again with reactors that do not provide IReactorPluggableNameResolver. This
undoes the changes that broke downstream users such as treq.testing. Note
that passing reactors that do not provide IReactorPluggableNameResolver to
either is deprecated. (9032)
- A Python 3 Perspective Broker server which receives a remote call with
keyword arguments from a Python 2 client will now decode any keys which are
binary to strings instead of crashing. This fixes interoperability between
Python 2 Buildbot clients and Python 3 Buildbot servers. (9047)
- twisted.internet._threadedselect now works on both Python 2 and 3. (9053)
- twisted.internet.interfaces.IResolverSimple implementers will now always be
passed bytes, properly IDNA encoded if required, on Python 2. On Python 3,
they will now be passed correctly IDNA-encoded Unicode forms of the domain,
taking advantage of the idna library from PyPI if possible. This is to avoid
Python's standard library (which has an out of date idna module) from mis-
encoding domain names when non-ASCII Unicode is passed to it. (9137)


Improved Documentation
----------------------

- The examples in Twisted howto "Using the Twisted Application Framework",
section "Customizing twistd logging" have been updated to use latest logging
modules and syntax (9084)


Features
--------

- twisted.internet.defer.Deferred.asFuture and
twisted.internet.defer.Deferred.fromFuture were added, allowing for easy
transitions between asyncio coroutines (which await Futures) and twisted
coroutines (which await Deferreds). (8748)
- twisted.application.internet.ClientService.whenConnected now accepts an
argument "failAfterFailures". If you set this to 1, the Deferred returned by
whenConnected will errback when the connection attempt fails, rather than
retrying forever. This lets you react (probably by stopping the
ClientService) to connection errors that are likely to be persistent, such as
using the wrong hostname, or not being connected to the internet at all.
(9116)
- twisted.protocols.tls.TLSMemoryBIOProtocol and anything that uses it
indirectly including the TLS client and server endpoints now enables TLS 1.3
cipher suites. (9128)


Misc
----

- 8133, 8995, 8997, 9003, 9015, 9021, 9026, 9027, 9049, 9057, 9062,
9065, 9069, 9070, 9072, 9074, 9075, 9111, 9117, 9140, 9144, 9145


Deprecations and Removals
-------------------------

- twisted.runner.inetdconf.InvalidRPCServicesConfError,
twisted.runner.inetdconf.RPCServicesConf, twisted.runner.inetdtap.RPCServer,
and twisted.runner.portmap, deprecated since 16.2.0, have been removed.
(8464)
- twisted.python.url and twisted.python._url were modified to rely on
hyperlink, a new package based on the Twisted URL implementation. Hyperlink
adds support for IPv6 (fixing 8069), correct username/password encoding,
better scheme/netloc inference, improved URL.click() behavior (fixing 8184),
and more. For full docs see hyperlink.readthedocs.io and the CHANGELOG in the
hyperlink GitHub repo. (9126)


Conch
-----

Bugfixes
~~~~~~~~

- History-aware terminal protocols like twisted.conch.manhole.Manhole no longer
raise a TypeError when a user visits a partial line they added to the command
line history by pressing up arrow before return. (9031)
- The telnet_echo.tac example had conflicting port callouts between runtime and
documentation. File was altered to run on documented port, 6023. (9055)


Deprecations and Removals
~~~~~~~~~~~~~~~~~~~~~~~~~

- Remove diffie-hellman-group1-sha1 from twisted.conch. See https://weakdh.org/
(9019)
- Removed small and obscure elliptic curves from conch. The only curves conch
supports now are the ones also supported by OpenSSH. (9088)


Mail
----

Bugfixes
~~~~~~~~

- twisted.mail.smtp has been ported to Python 3. (8770)


Names
-----

Bugfixes
~~~~~~~~

- RRHeader now converts its ttl argument to an integer, raising a TypeError if
it cannot. (8340)


Web
---

Bugfixes
~~~~~~~~

- twisted.web.cgi now works on Python 3 (8009)
- twisted.web.distrib now works on Python 3 (8010)
- twisted.web.http.HTTPFactory now propagates its reactor's callLater method to
the HTTPChannel object, rather than having callLater grab the global reactor.
This prevents the possibility of HTTPFactory logging using one reactor, but
HTTPChannel running timeouts on another. (8904)


Improved Documentation
~~~~~~~~~~~~~~~~~~~~~~

- twisted.web.template.flattenString docstring now correctly references
io.BytesIO (rather than NativeStringIO). (9028)


Features
~~~~~~~~

- twisted.web.client now exposes the RequestGenerationFailed exception type.
(5310)
- twisted.web.client.Agent will now parse responses that begin with a status
line that is missing a phrase. (7673)
- twisted.web.http.HTTPChannel and twisted.web._http2.H2Connection have been
enhanced so that after they time out they wait a small amount of time to
allow the connection to close gracefully and, if it does not, they forcibly
close it to avoid allowing malicious clients to forcibly keep the connection
open. (8902)


Misc
~~~~

- 8981, 9018, 9067, 9090, 9092, 9093, 9096


Words
-----

Deprecations and Removals
~~~~~~~~~~~~~~~~~~~~~~~~~

- twisted.words.protocols.oscar, which is client code for Oscar/ICQ, was
deprecated in 16.2.0 and has now been removed. (9024)


Twisted Core 17.1.0 (2017-02-04)
================================

Features
--------
- Added a new interface,
twisted.internet.interfaces.IHostnameResolver, which is an
improvement to twisted.internet.interfaces.IResolverSimple that
supports resolving multiple addresses as well as resolving IPv6
addresses.  This is a native, asynchronous, Twisted analogue to
getaddrinfo. (4362)
- twisted.web.client.Agent now uses HostnameEndpoint internally; as a
consequence, it now supports IPv6, as well as making connections
faster and more reliably to hosts that have more than one DNS name.
(6712)
- twisted.internet.ssl.CertificateOptions now has the new constructor
argument 'raiseMinimumTo', allowing you to increase the minimum TLS
version to this version or Twisted's default, whichever is higher.
The additional new constructor arguments 'lowerMaximumSecurityTo'
and 'insecurelyLowerMinimumTo' allow finer grained control over
negotiated versions that don't honour Twisted's defaults, for
working around broken peers, at the cost of reducing the security
of the TLS it will negotiate. (6800)
- twisted.internet.ssl.CertificateOptions now sets the OpenSSL
context's mode to MODE_RELEASE_BUFFERS, which will free the
read/write buffers on idle TLS connections to save memory. (8247)
- trial --help-reactors will only list reactors which can be
imported.  (8745)
- twisted.internet.endpoints.HostnameEndpoint now uses the passed
reactor's implementation of
twisted.internet.interfaces.IReactorPluggableResolver to resolve
hostnames rather than its own deferToThread/getaddrinfo wrapper;
this makes its hostname resolution pluggable via a public API.
(8922)
- twisted.internet.reactor.spawnProcess now does not emit a
deprecation warning on Unicode arguments. It will encode Unicode
arguments down to bytes using the filesystem encoding on UNIX and
Python 2 on Windows, and pass Unicode through unchanged on Python 3
on Windows. (8941)
- twisted.trial._dist.test.test_distreporter now works on Python 3.
(8943)

Bugfixes
--------
- trial --help-reactors will now display iocp and win32er reactors
with Python 3. (8745)
- twisted.logger._flatten.flattenEvent now handles log_format being
None instead of assuming the value is always a string. (8860)
- twisted.protocol.ftp is now Python 3 compatible (8865)
- twisted.names.client.Resolver can now resolve names with IPv6 DNS
servers. (8877)
- twisted.application.internet.ClientService now waits for existing
connections to disconnect before trying to connect again when
restarting. (8899)
- twisted.internet.unix.Server.doRead and
twisted.internet.unix.Client.doRead no longer fail if recvmsg's
ancillary data contains more than one file descriptor. (8911)
- twist on Python 3 now correctly prints the help text when given no
plugin to run. (8918)
- twisted.python.sendmsg.sendmsg no longer segfaults on Linux +
Python 2. (8969)
- IHandshakeListener providers connected via SSL4ClientEndpoint will
now have their handshakeCompleted methods called. (8973)
- The twist script now respects the --reactor option. (8983)
- Fix crash when using SynchronousTestCase with Warning object which
does not store a string as its first argument (like
libmysqlclient). (9005)
- twisted.python.compat.execfile() does not open files with the
deprecated 'U' flag on Python 3. (9012)

Deprecations and Removals
-------------------------
- twisted.internet.ssl.CertificateOption's 'method' constructor
argument is now deprecated, in favour of the new 'raiseMinimumTo',
'lowerMaximumSecurityTo', and 'insecurelyLowerMinimumTo' arguments.
(6800)
- twisted.protocols.telnet (not to be confused with the supported
twisted.conch.telnet), deprecated since Twisted 2.5, has been
removed. (8925)
- twisted.application.strports.parse, as well as the deprecated
default arguments in strports.service/listen, deprecated since
Twisted 10.2, has been removed. (8926)
- twisted.web.client.getPage and twisted.web.client.downloadPage have
been deprecated in favour of https://pypi.org/project/treq and
twisted.web.client.Agent. (8960)
- twisted.internet.defer.timeout is deprecated in favor of
twisted.internet.defer.Deferred.addTimeout (8971)

Other
-----
- 7879, 8583, 8764, 8809, 8859, 8906, 8910, 8913, 8916,
8934, 8945, 8949, 8950, 8952, 8953, 8959, 8962, 8963,
8967, 8975, 8976, 8993, 9013


Twisted Conch 17.1.0 (2017-02-04)
=================================

Features
--------
- twisted.conch.manhole now works on Python 3. (8327)
- Twisted Conch now supports ECDH key exchanges. (8730)
- Add support in twisted.conch.ssh for hmac-sha2-384 (8784)
- conch and cftp scripts now work on Python 3. (8791)
- twisted.conch.ssh supports ECDH key exchange. (8811)

Bugfixes
--------
- twisted.conch.ssh.keys.Key.fromString now supports OpenSSL private
keys with Windows line endings (\r\n) again (broken since 16.6.0).
(8928)

Improved Documentation
----------------------
- The documentation for
twisted.conch.endpoints.SSHCommandClientEndpoint.existingConnection
now describes where the value for the connection parameter might
come from. (8892)

Other
-----
- 8890, 8894, 8957, 8958, 8968


Twisted Mail 17.1.0 (2017-02-04)
================================

Deprecations and Removals
-------------------------
- twisted.mail.tap (the twist plugin for mail) no longer accepts the
--pop3s option or implicit port numbers to --pop3 and --smtp. This
functionality has been deprecated since 11.0. (8920)


Twisted Names 17.1.0 (2017-02-04)
=================================

Bugfixes
--------
- twisted.names.authority.BindAuthority has been ported to Python 3.
(8880)


Twisted News 17.1.0 (2017-02-04)
================================

No significant changes have been made for this release.


Twisted Pair 17.1.0 (2017-02-04)
================================

No significant changes have been made for this release.


Twisted Runner 17.1.0 (2017-02-04)
==================================

Bugfixes
--------
- On Python 3, procmon now handles process output without exceptions
(8919)


Twisted Web 17.1.0 (2017-02-04)
===============================

Features
--------
- twisted.web.client.Agent now sets ``Content-Length: 0`` for PUT and
POST requests made without a body producer. (8984)

Bugfixes
--------
- twisted.web.http.HTTPFactory now times connections out after one
minute of no data from the client being received, before the
request is complete, rather than twelve hours. (3746)
- twisted.web.http.HTTPChannel, the server class for Twisted's
HTTP/1.1 server, now exerts backpressure against clients that do
not read responses. This means that if a client stops reading from
a socket for long enough, Twisted will stop reading further
requests from that client until it consumes some responses. (8868)
- twisted.web.http_headers.Headers.getRawHeaders no longer attempts
to decode the default value when called with a unicode header name.
(8974)
- twisted.web.http.HTTPChannel is less likely to leak file
descriptors when timing out clients using HTTPS connections. In
some cases it is still possible to leak a file descriptor when
timing out HTTP clients: further patches will address this issue.
(8992)

Other
-----
- 7744, 8909, 8935


Twisted Words 17.1.0 (2017-02-04)
=================================

No significant changes have been made for this release.


Twisted Core 16.6.0 (2016-11-17)
================================

Features
--------
- The twist script can now be run by invoking python -m twisted.
(8657)
- twisted.protocols.sip has been ported to Python 3. (8669)
- twisted.persisted.dirdbm has been ported to Python 3. (8888)

Bugfixes
--------
- twisted.internet.defer.Deferred now implements send, not __send__,
which means that it is now a conforming generator. (8861)
- The IOCP reactor no longer transmits the contents of uninitialized
memory when writing large amounts of data. (8870)
- Deferreds awaited/yielded from in a
twisted.internet.defer.ensureDeferred wrapped coroutine will now
properly raise exceptions. Additionally, it more closely models
asyncio.ensure_future and will pass through Deferreds. (8878)
- Deferreds that are paused or chained on other Deferreds will now
return a result when yielded/awaited in a twisted.internet.defer
.ensureDeferred-wrapped coroutine, instead of returning the
Deferred it was chained to. (8890)

Improved Documentation
----------------------
- twisted.test.proto_helpers is now explicitly covered by the
compatibility policy. (8857)

Other
-----
- 8281, 8823, 8862


Twisted Conch 16.6.0 (2016-11-17)
=================================

Features
--------
- twisted.conch.ssh.keys supports ECDSA keys (8798)
- scripts/ckeygen can now generate ecdsa keys. (8828)
- ckeygen has been ported to Python 3 (8855)

Deprecations and Removals
-------------------------
- twisted.conch.ssh no longer uses gmpy, if available. gmpy is
unmaintained, does not have binary wheels for any platforms, and an
alternative for higher performance is available in the form of
PyPy. (8079)


Twisted Mail 16.6.0 (2016-11-17)
================================

No significant changes have been made for this release.


Twisted Names 16.6.0 (2016-11-17)
=================================

No significant changes have been made for this release.


Twisted News 16.6.0 (2016-11-17)
================================

No significant changes have been made for this release.


Twisted Pair 16.6.0 (2016-11-17)
================================

No significant changes have been made for this release.


Twisted Runner 16.6.0 (2016-11-17)
==================================

No significant changes have been made for this release.


Twisted Web 16.6.0 (2016-11-17)
===============================

Features
--------
- twisted.web.server.Site's HTTP/2 server support now emits vastly
fewer WINDOW_UPDATE frames than previously. (8681)

Bugfixes
--------
- twisted.web.Agent now tolerates receiving unexpected status codes
in the 100 range by discarding them, which is what RFC 7231
recommends doing. (8885)
- twisted.web._http.H2Stream's getHost and getPeer implementations
now actually return the host and peer instead of None. (8893)


Twisted Words 16.6.0 (2016-11-17)
=================================

Features
--------
- twisted.words.protocols.irc has been ported to Python 3 (6320)


Twisted Core 16.5.0 (2016-10-28)
================================

Features
--------
- Added twisted.internet.defer.Deferred.addTimeout method to enable
timeouts of deferreds. (5786)
- Perspective Broker (the twisted.spread package) has been ported to
Python 3 (7598)
- 'yield from' can now be used on Deferreds inside generators, when
the generator is wrapped with
twisted.internet.defer.ensureDeferred. (8087)
- twisted.internet.asyncioreactor has been added, which is a Twisted
reactor on top of Python 3.4+'s native asyncio reactor. It can be
selected by passing "--reactor=asyncio" to Twisted tools (twistd,
Trial, etc) on platforms that support it (Python 3.4+). (8367)
- twisted.python.zippath now works on Windows with Python 3. (8747)
- twisted.internet.cfreactor is ported to Python 3 and supported on
2.7 and 3.5+. (8838)

Bugfixes
--------
- twisted.internet.test.test_iocp and twisted.internet.test.test_tcp
have been fixed to work under Python 3 with the Windows IOCP
reactor (8631)
- Arguments to processes on Windows are now passed mbcs-encoded
arguments.  This prevents process-related tests from hanging on
Windows with Python 3. (8735)
- Client and server TLS connections made via the client TLS endpoint
and the server SSL endpoint, as well as any other code that uses
twisted.internet.ssl.CertificateOptions, no longer accept 3DES-
based cipher suites by default, to defend against SWEET32. (8781)
- twisted.logger.jsonFileLogObserver no longer emits non-JSON
tracebacks into its file; additionally,
twisted.logger.formatEventAsClassicLogText now includes traceback
information for the log event it formats. (8858)
- twisted.python.version now exports a version of Incremental that is
16.10.1 or higher, making t.p.v.Version package name comparisons
case-insensitive. (8863)
- twisted.python.reflect.safe_str encodes unicode as ascii with
backslashreplace error handling on Python 2. (8864)

Improved Documentation
----------------------
- The twisted.internet.interfaces.IProtocol.dataReceived() method
takes one parameter of type bytes.  This has been clarified in the
doc string. (8763)

Deprecations and Removals
-------------------------
- twisted.python.constants is deprecated in preference to constantly
on PyPI, which is the same code rolled into its own package.
(7351)
- twisted.python.dist3 has been made private API. (8761)
- When the source code is checked out, bin/trial is no longer in the
tree.  Developers working on the Twisted source code itself should
either (1) run all tests under tox, or (2) run 'python setup.py
develop' to install trial before running any tests. (8765)
- twisted.protocols.gps, deprecated since Twisted 15.2, has been
removed. (8787)

Other
-----
- 4926, 7868, 8209, 8214, 8271, 8308, 8324, 8348, 8367,
8377, 8378, 8379, 8380, 8381, 8383, 8385, 8387, 8388,
8389, 8391, 8392, 8393, 8394, 8397, 8406, 8410, 8412,
8413, 8414, 8421, 8425, 8426, 8430, 8432, 8434, 8435,
8437, 8438, 8439, 8444, 8451, 8452, 8453, 8454, 8456,
8457, 8459, 8462, 8463, 8465, 8468, 8469, 8479, 8482,
8483, 8486, 8490, 8493, 8494, 8496, 8497, 8498, 8499,
8501, 8503, 8504, 8507, 8508, 8510, 8513, 8514, 8515,
8516, 8517, 8520, 8521, 8522, 8523, 8524, 8527, 8528,
8529, 8531, 8532, 8534, 8536, 8537, 8538, 8543, 8544,
8548, 8552, 8553, 8554, 8555, 8557, 8560, 8563, 8565,
8568, 8569, 8572, 8573, 8574, 8580, 8581, 8582, 8586,
8589, 8590, 8592, 8593, 8598, 8603, 8604, 8606, 8609,
8615, 8616, 8617, 8618, 8619, 8621, 8622, 8624, 8627,
8628, 8630, 8632, 8634, 8640, 8644, 8645, 8646, 8647,
8662, 8664, 8666, 8668, 8671, 8672, 8677, 8678, 8684,
8691, 8702, 8705, 8706, 8716, 8719, 8724, 8725, 8727,
8734, 8741, 8749, 8752, 8754, 8755, 8756, 8757, 8758,
8767, 8773, 8776, 8779, 8780, 8785, 8788, 8789, 8790,
8792, 8793, 8799, 8808, 8817, 8839, 8845, 8852


Twisted Conch 16.5.0 (2016-10-28)
=================================

Features
--------
- SSH key fingerprints can be generated using base64 encoded SHA256
hashes. (8701)

Bugfixes
--------
- SSHUserAuthServer does not crash on keyboard interactive
authentication when running on Python 3 (8771)
- twisted.conch.insults.insults.ServerProtocol no longer corrupts a
client's display when attempting to set the cursor position, and
its ECMA-48 terminal manipulation works on Python 3. (8803)

Other
-----
- 8495, 8511, 8715, 8851


Twisted Mail 16.5.0 (2016-10-28)
================================

Deprecations and Removals
-------------------------
- twisted.mail.protocols.DomainSMTP and DomainESMTP, deprecated since
2003, have been removed. (8772)

Other
-----
- 6289, 8525, 8786, 8830


Twisted Names 16.5.0 (2016-10-28)
=================================

No significant changes have been made for this release.

Other
-----
- 8625, 8663


Twisted News 16.5.0 (2016-10-28)
================================

No significant changes have been made for this release.


Twisted Pair 16.5.0 (2016-10-28)
================================

Features
--------
- twisted.pair has been ported to Python 3 (8744)


Twisted Runner 16.5.0 (2016-10-28)
==================================

No significant changes have been made for this release.


Twisted Web 16.5.0 (2016-10-28)
===============================

Bugfixes
--------
- twisted.web.client.HTTPConnectionPool and anything that uses it,
like twisted.web.client.Agent, have had their logic for resuming
transports changed so that transports are resumed after state
machine transitions are complete, rather than before. This change
allows the HTTP client infrastructure to work with alternative HTTP
implementations such as HTTP/2 which may be able to deliver a
complete response synchronously when producing is resumed. (8720)

Other
-----
- 8519, 8530, 8629, 8707, 8777, 8778, 8844


Twisted Words 16.5.0 (2016-10-28)
=================================

No significant changes have been made for this release.

Other
-----
- 8360, 8460


Twisted Core 16.4.1 (2016-09-07)
================================

Features
--------
- Client and server TLS connections made via the client TLS endpoint
and the server SSL endpoint, as well as any other code that uses
twisted.internet.ssl.CertificateOptions, now support ChaCha20
ciphers when available from the OpenSSL on the system. (8760)

Bugfixes
--------
- Client and server TLS connections made via the client TLS endpoint
and the server SSL endpoint, as well as any other code that uses
twisted.internet.ssl.CertificateOptions, no longer accept 3DES-
based cipher suites by default, to defend against SWEET32. (8781)


Twisted Conch 16.4.1 (2016-09-07)
=================================

No significant changes have been made for this release.


Twisted Mail 16.4.1 (2016-09-07)
================================

No significant changes have been made for this release.


Twisted Names 16.4.1 (2016-09-07)
=================================

No significant changes have been made for this release.


Twisted News 16.4.1 (2016-09-07)
================================

No significant changes have been made for this release.


Twisted Pair 16.4.1 (2016-09-07)
================================

No significant changes have been made for this release.


Twisted Runner 16.4.1 (2016-09-07)
==================================

No significant changes have been made for this release.


Twisted Web 16.4.1 (2016-09-07)
===============================

No significant changes have been made for this release.


Twisted Words 16.4.1 (2016-09-07)
=================================

No significant changes have been made for this release.


Twisted Core 16.4.0 (2016-08-25)
================================

Features
--------
- Add twisted.application.twist, meant to eventually replace twistd
with a simpler interface.  Add twisted.application.runner API,
currently private, which twist is built on. (5705)
- The new interface IHandshakeListener that can be implemented by any
Protocol provides a callback that is called when the TLS handshake
has been completed, allowing Protocols to make decisions about the
TLS configuration before application data is sent. (6024)
- twisted.python.syslog has been ported to Python 3. (7957)
- twisted.internet.defer.ensureDeferred has been added, similar to
asyncio's ensure_future. Wrapping a coroutine (the result of a
function defined using async def, available only on Python 3.5+)
with it allows you to use the "await" keyword with Deferreds inside
the coroutine, similar to "yield" when using inlineCallbacks.
(8088)
- twisted.internet.inotify have been ported to Python 3 (8211)
- twisted.enterprise has been ported to Python 3. The third-party
pysqlite2 package has not been ported to Python 3, so any database
connector based on pysqlite2 cannot be used. Instead the sqlite3
module included with Python 3 should be used. (8303)
- Scripts such as cftp, ckeygen, conch, mailmail, pyhtmlizer,
tkconch, twistd and trial have been updated to be setuptools
console scripts.  (8491)
- twisted.pair.raw and twisted.pair.rawudp have been ported to Python
3 (8545)
- twisted.internet.baseprocess has been ported to Python 3. (8546)
- twisted.python.dist has been ported to Python 3 (8556)
- twisted.internet.interfaces.IOpenSSLContextFactory has been added,
which defines the interface provided both by the old-style
twisted.internet.ssl.ContextFactory class and the newer
twisted.interface.ssl.CertificateOptions class. This is a precursor
to formally deprecating the former class in favour of the latter.
(8597)
- twisted.python.zipstream has been ported to Python 3 (8607)
- Zip file entries returned by ChunkingZipFile.readfile() are now
context managers. (8641)
- twisted.protocols.socks has been ported to Python 3 (8665)
- twisted.spread.banana has been ported to Python 3 (8667)
- Trial can now be invoked via "python -m twisted.trial". (8712)
- twisted.protocols.postfix has been ported to Python 3 (8713)
- twisted.protocols.wire and twisted.protocols.portforwarding have
been ported to Python 3 (8717)
- twisted.protocols.stateful has been ported to Python 3 (8718)
- twisted.protocols.memcache is now compatible with Python 3. (8726)
- twisted.protocols.dict has been ported to Python 3 (8732)

Bugfixes
--------
- pip install -e ".[dev]" now works on Python 3, but it will not
install twistedchecker or pydoctor, which have not yet been ported.
(7807)
- twistd can now properly daemonize on Linux/Unix when run under
Python3 and will not hang indefinitely. (8155)
- tox can now be used to run Twisted's tests on Windows (8578)
- twisted.python.filepath.setContent() and
twisted.python.filepath.moveTo() now work on Windows with Python 3
(8610)
- twisted.internet.win32eventreactor works on Python 3 in Windows
(8626)
- The TLS payload buffer size was reduced in
twisted.protocols.tls.TLSMemoryBIOProtocol.  This fixes writing of
very long strings using the TLSv1_1 method from the OpenSSL
library. (8693)
- twisted.logger._flatten.flattenEvent() now does not crash if passed
a unicode string. (8699)
- twisted.application.strports.service (and thus twistd) no longer
swallow asynchronous exceptions from IStreamServerEndpoint.listen.
(8710)
- _twistd_unix now reports the name and encoded message of an
exception raised during daemonization on Python 2 and 3. (8731)
- twisted.protocols.amp now handles floats on Python 3. Previously,
sending a float would raise a ValueError. (8746)

Improved Documentation
----------------------
- Some broken links to xprogramming in the unit test documentation
have been fixed. (8579)
- The Twisted Tutorial "The Evolution of Finger" has been updated to
use endpoints throughout. (8588)
- Updated the mail examples to use endpoints and better TLS. (8595)
- Changed the Twisted Web howto to use endpoints and modern TLS.
(8596)
- Updated bug report URL in man pages. (8600)
- In twisted.internet.udp.Port, write() takes a parameter of type
bytes.  This is clarified in the docstring. (8635)
- twisted.internet.interfaces.ITransport.write() and
twisted.internet.interfaces.ITransport.writeSequence() take bytes
parameters. (8636)
- twisted.python.filepath.AbstractFilePath.getContent() returns
bytes.  The docstring was updated to clarify this. (8637)
- Updated release notes to reflect that 15.4 is the last version that
supported Python 2.6, not 15.5. (8651)
- A missing space in defer.rst resulted in badly rendered output. The
space was added. (8723)

Deprecations and Removals
-------------------------
- Dropped support for pyOpenSSL versions less than 16.0.0. (8441)

Other
-----
- 4926, 7868, 8209, 8271, 8276, 8308, 8324, 8348, 8367,
8377, 8378, 8379, 8380, 8381, 8383, 8385, 8386, 8387,
8388, 8389, 8391, 8392, 8393, 8394, 8397, 8406, 8410,
8412, 8413, 8414, 8421, 8425, 8426, 8428, 8429, 8430,
8432, 8434, 8435, 8437, 8438, 8439, 8444, 8451, 8452,
8453, 8454, 8456, 8457, 8459, 8462, 8463, 8465, 8468,
8469, 8479, 8482, 8483, 8486, 8490, 8493, 8494, 8496,
8497, 8498, 8499, 8501, 8503, 8504, 8507, 8508, 8510,
8513, 8514, 8515, 8516, 8517, 8520, 8521, 8522, 8523,
8524, 8527, 8528, 8529, 8531, 8532, 8534, 8536, 8537,
8538, 8540, 8541, 8543, 8548, 8552, 8553, 8554, 8555,
8557, 8560, 8563, 8565, 8568, 8569, 8572, 8573, 8574,
8577, 8580, 8581, 8582, 8584, 8586, 8589, 8590, 8592,
8593, 8598, 8603, 8604, 8606, 8609, 8615, 8616, 8617,
8618, 8619, 8621, 8624, 8627, 8628, 8630, 8632, 8634,
8640, 8644, 8645, 8646, 8647, 8648, 8662, 8664, 8666,
8668, 8671, 8672, 8684, 8691, 8702, 8703, 8705, 8706,
8716, 8719, 8724, 8725, 8727, 8733, 8734, 8741


Twisted Conch 16.4.0 (2016-08-25)
=================================

Features
--------
- twisted.conch.ssh.address is now ported to Python 3. (8495)
- twisted.conch.ssh.transport is now ported to Python 3. (8638)
- twisted.conch.ssh.channel is now ported to Python 3. (8649)
- twisted.conch.ssh.userauth is now ported to Python 3. (8654)
- twisted.conch.ssh.connection is now ported to Python 3. (8660)
- twisted.conch.ssh.session is now ported to Python 3. (8661)
- twisted.conch.ssh.filetransfer is now ported to Python 3. (8675)
- twisted.conch.ssh.agent is now ported to Python 3. (8686)
- twisted.conch.ssh is now ported to Python 3. (8690)
- twisted.conch.openssh_compat.* is now ported to Python 3. (8694)
- twisted.conch.client.knownhosts is now ported to Python 3. (8697)
- twisted.conch.insults.insults has been ported to Python 3 (8698)
- twisted.conch.client.default is now ported to Python 3. (8700)
- twisted.conch.recvline has been ported to Python 3 (8709)
- twisted.conch.endpoints is now ported to Python 3. (8722)

Bugfixes
--------
- The SSHService is now a bytestring (8653)
- The name field in SShChannel is now a bytestring (8683)

Improved Documentation
----------------------
- Fixed syntax errors in cftp man page. (8601)

Other
-----
- 8495, 8511, 8715


Twisted Mail 16.4.0 (2016-08-25)
================================

Deprecations and Removals
-------------------------
- twisted.mail.mail.DomainWithDefaultDict.has_key is now deprecated
in favor of the `in` keyword. (8361)
- twisted.mail.protocols.SSLContextFactory, deprecated since Twisted
12.0, has been removed. (8591)

Other
-----
- 8525


Twisted Names 16.4.0 (2016-08-25)
=================================

Features
--------
- twisted.names.srvconnect is now ported to Python 3. (8262)
- twisted.names.resolve and twisted.names.tap have been ported to
Python 3 (8550)

Other
-----
- 8625, 8663


Twisted News 16.4.0 (2016-08-25)
================================

No significant changes have been made for this release.


Twisted Pair 16.4.0 (2016-08-25)
================================

No significant changes have been made for this release.


Twisted Runner 16.4.0 (2016-08-25)
==================================

Features
--------
- twisted.runner has been ported to Python 3. (8739)


Twisted Web 16.4.0 (2016-08-25)
===============================

Features
--------
- Twisted web HTTP/2 servers now time out HTTP/2 connections in the
same manner as HTTP/1.1 connections. (8480)

Bugfixes
--------
- A bug in twisted.web.server.Site.makeSession which may lead to
predictable session IDs was fixed.  Session IDs are now generated
securely using `os.urandom`. (3460)
- twisted.web.server.Request.getSession will now, for a request sent
over HTTPS, set a "Secure" cookie, preventing the secure session
from being sent over plain-text HTTP. (3461)
- If called multiple times, twisted.web.http.Request.setLastModified
now correctly observes the greatest supplied value. (3807)
- The HTTP server now correctly times connections out. (broken in
16.2) (8481)
- Twisted's HTTP/2 support no longer throws priority exceptions when
WINDOW_UDPATE frames are received after a response has been
completed. (8558)
- twisted.web.twcgi.CGIScript will now not pass the "Proxy" header to
CGI scripts, as a mitigation to CVE-2016-1000111. (8623)
- Twisted Web's HTTP/2 server can now tolerate streams being reset by
the client midway through a data upload without throwing
exceptions. (8682)
- twisted.web.http.Request now swallows header writes on reset HTTP/2
streams, rather than erroring out. (8685)
- twisted.web's HTTP/2 server now tolerates receiving WINDOW_UPDATE
frames for streams for which it has no outstanding data to send.
(8695)
- twisted.web.http.HTTPChannel now resumes producing on finished,
non-persistent connections. This prevents HTTP/1 servers using TLS
from leaking a CLOSE_WAIT socket per request. (8766)

Other
-----
- 8519, 8530, 8629, 8707


Twisted Words 16.4.0 (2016-08-25)
=================================

Features
--------
- twisted.words.xish is now ported to Python 3 (8337)
- twisted.words.protocols.jabber is now ported to Python 3 (8423)
- twisted.words.protocols.irc.ERR_TOOMANYMATCHES was introduced
according to the RFC 2812 errata. (8585)

Bugfixes
--------
- twisted.words.protocols.irc.RPL_ADMINLOC was removed and replaced
with twisted.words.protocols.irc.RPL_ADMINLOC1 and
twisted.words.protocols.irc.RPL_ADMINLOC2 to match the admin
commands defined in RFC 2812. (8585)
- twisted.words.protocols.jabber.sasl_mechanisms has been fixed for
Python 3.3 (8738)

Improved Documentation
----------------------
- The XMPP client example now works on Python 3. (8509)

Other
-----
- 8360, 8460


Twisted Core 16.3.0 (2016-07-05)
================================

Features
--------
- Defined a new interface, IProtocolNegotiationFactory, that can be
implemented by IOpenSSLClientConnectionCreator or
IOpenSSLServerConnectionCreator factories to allow them to offer
protocols for negotiation using ALPN or NPN during the TLS
handshake. (8188)
- twisted.trial.unittest.SynchronousTestCase.assertRegex is now
available to provide Python 2.7 and Python 3 compatibility. (8372)

Improved Documentation
----------------------
- Development documentation has been updated to refer to Git instead
of SVN. (8335)

Deprecations and Removals
-------------------------
- twisted.python.reflect's deprecated functions have been removed.
This includes funcinfo (deprecated since Twisted 2.5), allYourBase
and accumulateBases (deprecated since Twisted 11.0), getcurrent and
isinst (deprecated since Twisted 14.0). (8293)
- twisted.scripts.tap2deb and twisted.scripts.tap2rpm (along with the
associated executables), deprecated since Twisted 15.2, have now
been removed. (8326)
- twisted.spread.ui has been removed. (8329)
- twisted.manhole -- not to be confused with manhole in Conch -- has
been removed. This includes the semi-functional Glade reactor, the
manhole application, and the manhole-old twistd plugin. (8330)
- twisted.protocols.sip.DigestAuthorizer, BasicAuthorizer, and
related functions have been removed. (8445)

Other
-----
- 7229, 7826, 8290, 8323, 8331, 8336, 8341, 8344, 8345,
8347, 8351, 8363, 8365, 8366, 8374, 8382, 8384, 8390,
8395, 8396, 8398, 8399, 8400, 8401, 8403, 8404, 8405,
8407, 8408, 8409, 8415, 8416, 8417, 8418, 8419, 8420,
8427, 8433, 8436, 8461


Twisted Conch 16.3.0 (2016-07-05)
=================================

No significant changes have been made for this release.


Twisted Mail 16.3.0 (2016-07-05)
================================

No significant changes have been made for this release.


Twisted Names 16.3.0 (2016-07-05)
=================================

Bugfixes
--------
- twisted.names.client.Resolver as well as all resolvers inheriting
from twisted.names.common.ResolverBase can now understand DNS
answers that come back in a different case than the query. Example:
querying for www.google.com and the answer comes back with an A
record for www.google.COM will now work. (8343)


Twisted News 16.3.0 (2016-07-05)
================================

No significant changes have been made for this release.


Twisted Pair 16.3.0 (2016-07-05)
================================

No significant changes have been made for this release.


Twisted Runner 16.3.0 (2016-07-05)
==================================

No significant changes have been made for this release.


Twisted Web 16.3.0 (2016-07-05)
===============================

Features
--------
- twisted.web.http.HTTPChannel now implements ITransport. Along with
this change, twisted.web.http.Request now directs all its writes to
the HTTPChannel, rather than to the backing transport. This change
is required for future HTTP/2 work. (8191)
- twisted.web.http.HTTPChannel now has a HTTP/2 implementation which
will be used if the transport has negotiated using it through
ALPN/NPN (see 8188). (8194)

Bugfixes
--------
- twisted.web.client.Agent and twisted.web.client.ProxyAgent now add
brackets to IPv6 literal addresses in the host header they send.
(8369)
- The HTTP server now correctly times connections out. (broken in
16.2) (8481)

Deprecations and Removals
-------------------------
- twisted.web would previously dispatch pipelined requests
simultaneously and queue the responses. This behaviour did not
enforce any of the guarantees required by RFC 7230 or make it
possible for users to enforce those requirements. For this reason,
the parallel dispatch of requests has been removed. Pipelined
requests are now processed serially. (8320)


Twisted Words 16.3.0 (2016-07-05)
=================================

No significant changes have been made for this release.


Twisted Core 16.2.0 (2016-05-18)
================================

Features
--------
- twisted.protocols.haproxy.proxyEndpoint provides an endpoint that
wraps any other stream server endpoint with the PROXY protocol that
retains information about the original client connection handled by
the proxy; this wrapper is also exposed via the string description
prefix 'haproxy'; for example 'twistd web --port haproxy:tcp:8765'.
(8203)
- twisted.application.app.AppLogger (used by twistd) now uses the new
logging system. (8235)

Bugfixes
--------
- twisted.application-using applications (trial, twistd, etc) now
work with the --reactor option on Python 3. (8299)
- Failures are now logged by STDLibLogObserver. (8316)

Improved Documentation
----------------------
- Deprecation documentation was extended to include a quick check
list for developers. (5645)
- The Twisted Deprecation Policy is now documented in the Twisted
Development Policy. (8082)
- The documentation examples for UDP now work on Python 3. (8280)

Deprecations and Removals
-------------------------
- Passing a factory that produces log observers that do not implement
twisted.logger.ILogObserver or twisted.python.log.ILogObserver to
twisted.application.app.AppLogger has been deprecated. This is
primarily used by twistd's --logger option. Please use factories
that produce log observers implementing twisted.logger.ILogObserver
or the legacy twisted.python.log.ILogObserver. (8235)
- twisted.internet.qtreactor, a stub that imported the external
qtreactor, has been removed. (8288)

Other
-----
- 6266, 8231, 8244, 8256, 8266, 8269, 8275, 8277, 8286,
8291, 8292, 8304, 8315


Twisted Conch 16.2.0 (2016-05-18)
=================================

No significant changes have been made for this release.

Other
-----
- 8279


Twisted Mail 16.2.0 (2016-05-18)
================================

No significant changes have been made for this release.


Twisted Names 16.2.0 (2016-05-18)
=================================

Features
--------
- twisted.names.server is now ported to Python 3 (8195)
- twisted.names.authority and twisted.names.secondary have been
ported to Python 3 (8259)


Twisted News 16.2.0 (2016-05-18)
================================

No significant changes have been made for this release.


Twisted Pair 16.2.0 (2016-05-18)
================================

No significant changes have been made for this release.


Twisted Runner 16.2.0 (2016-05-18)
==================================

Deprecations and Removals
-------------------------
- twisted.runner.inetdtap and twisted.runner.inetdconf RPC support
was deprecated as it was broken for a long time. (8123)


Twisted Web 16.2.0 (2016-05-18)
===============================

Features
--------
- twisted.web.http.HTTPFactory's constructor now accepts a reactor
argument, for explicit reactor selection. (8246)

Bugfixes
--------
- twisted.web.http.HTTPChannel.headerReceived now respond with 400
and disconnect when a malformed header is received. (8101)
- twisted.web.http.Request once again has a reference to the
HTTPFactory which created it, the absence of which was preventing
log messages from being created.  (8272)
- twisted.web.http.HTTPChannel no longer processes requests that have
invalid headers as the final header in their header block. (8317)
- twisted.web.client.HTTPClientFactory (and the getPage and
downloadPage APIs) now timeouts correctly on TLS connections where
the remote party is not responding on the connection. (8318)

Other
-----
- 8300


Twisted Words 16.2.0 (2016-05-18)
=================================

Deprecations and Removals
-------------------------
- twisted.words.protocols.msn, deprecated since Twisted 15.1, has
been removed. (8253)
- twisted.words.protocols.oscar is deprecated. (8260)


Twisted Core 16.1.1 (2016-04-08)
================================

No significant changes have been made for this release.


Twisted Conch 16.1.1 (2016-04-08)
=================================

No significant changes have been made for this release.


Twisted Mail 16.1.1 (2016-04-08)
================================

No significant changes have been made for this release.


Twisted Names 16.1.1 (2016-04-08)
=================================

No significant changes have been made for this release.


Twisted News 16.1.1 (2016-04-08)
================================

No significant changes have been made for this release.


Twisted Pair 16.1.1 (2016-04-08)
================================

No significant changes have been made for this release.


Twisted Runner 16.1.1 (2016-04-08)
==================================

No significant changes have been made for this release.


Twisted Web 16.1.1 (2016-04-08)
===============================

Bugfixes
--------
- twisted.web.http.Request once again has a reference to the
HTTPFactory which created it, the absence of which was preventing
log messages from being created.  (8272)


Twisted Words 16.1.1 (2016-04-08)
=================================

No significant changes have been made for this release.


Twisted Core 16.1.0 (2016-04-04)
================================

Features
--------
- twisted.application.internet.ClientService, a service that
maintains a persistent outgoing endpoint-based connection; a
replacement for ReconnectingClientFactory that uses modern APIs.
(4735)
- Twisted now uses setuptools' sdist to build tarballs. (7985)

Bugfixes
--------
- Twisted is now compatible with OpenSSL 1.0.2f. (8189)

Other
-----
- 4543, 8124, 8193, 8210, 8220, 8223, 8226, 8242


Twisted Conch 16.1.0 (2016-04-04)
=================================

Features
--------
- twisted.conch.checkers is now ported to Python 3. (8225)
- twisted.conch.telnet is now ported to Python 3. (8228)
- twisted.conch.manhole_ssh.ConchFactory (used by `twistd manhole`)
no longer uses a hardcoded SSH server key, and will generate a
persistent one, saving it in your user appdir. If you use
ConchFactory, you will now need to provide your own SSH server key.
(8229)

Other
-----
- 8237, 8240


Twisted Mail 16.1.0 (2016-04-04)
================================

No significant changes have been made for this release.


Twisted Names 16.1.0 (2016-04-04)
=================================

No significant changes have been made for this release.


Twisted News 16.1.0 (2016-04-04)
================================

No significant changes have been made for this release.


Twisted Pair 16.1.0 (2016-04-04)
================================

No significant changes have been made for this release.


Twisted Runner 16.1.0 (2016-04-04)
==================================

No significant changes have been made for this release.


Twisted Web 16.1.0 (2016-04-04)
===============================

Features
--------
- twisted.web.http.Request.addCookie now supports both unicode and
bytes arguments, with unicode arguments being encoded to UTF-8.
(8067)

Bugfixes
--------
- twisted.web.util.DeferredResource no longer causes spurious
"Unhandled error in Deferred" log messages. (8192)
- twisted.web.server.site.makeSession now generates an uid of type
bytes on both Python 2 and 3. (8215)

Other
-----
- 8238


Twisted Words 16.1.0 (2016-04-04)
=================================

No significant changes have been made for this release.


Twisted Core 16.0.0 (2016-03-10)
================================

Features
--------
- todo parameter for IReporter.addExpectedSuccess and
IReporter.addUnexpectedSuccess is no longer required. If not
provided, a sensible default will be used instead. (4811)
- A new string endpoint type, "tls:", allows for properly-verified
TLS (unlike "ssl:", always matching hostname resolution with
certificate hostname verification) with faster IPv4/IPv6
connections.  This comes with an accompanying function,
twisted.internet.endpoints.wrapClientTLS, which can wrap an
arbitrary client endpoint with client TLS. (5642)
- twisted.python.filepath.makedirs accepts an ignoreExistingDirectory
flag which ignore the OSError raised by os.makedirs if requested
directory already exists. (5704)
- twisted.protocols.amp has been ported to Python 3. (6833)
- twisted.internet.ssl.trustRootFromCertificates returns an object
suitable for use as trustRoot= to
twisted.internet.ssl.optionsForClientTLS that trusts multiple
certificates. (7671)
- twisted.python.roots is now ported to Python 3. (8131)
- twisted.cred.strports has been ported to Python 3. (8216)

Bugfixes
--------
- Expected failures from standard library unittest no longer fail
with Trial reporters. (4811)
- twisted.internet.endpoints.HostnameEndpoint.connect no longer fails
with an AlreadyCalledError when the Deferred it returns is
cancelled after all outgoing connection attempts have been made but
none have yet succeeded or failed. (8014)
- twisted.internet.task.LoopingCall.withCount when run with internal
of 0, now calls the countCallable with 1, regardless of the time
passed between calls. (8125)
- twisted.internet.endpoints.serverFromString, when parsing a SSL
strports definition, now gives the correct error message when an
empty chain file is given. (8222)

Improved Documentation
----------------------
- The Twisted Project has adopted the Contributor Covenant as its
Code of Conduct. (8173)

Deprecations and Removals
-------------------------
- twisted.internet.task.LoopingCall.deferred is now deprecated. Use
the deferred returned by twisted.internet.task.LoopingCall.start()
(8116)
- twisted.internet.gtkreactor, the GTK+ 1 reactor deprecated since
Twisted 10.1, has been removed. This does not affect the GTK2,
GLib, GTK3, or GObject-Introspection reactors. (8145)
- twisted.protocols.mice, containing a Logitech MouseMan serial
driver, has been deprecated. (8148)
- The __version__ attribute of former subprojects (conch, mail,
names, news, pair, runner, web, and words) is deprecated in
preference to the central twisted.__version__. (8219)

Other
-----
- 6842, 6978, 7668, 7791, 7881, 7943, 7944, 8050, 8104,
8115, 8119, 8122, 8139, 8144, 8154, 8162, 8180, 8187,
8220


Twisted Conch 16.0.0 (2016-03-10)
=================================

Features
--------
- twisted.conch now uses cryptography instead of PyCrypto for its
underlying crypto operations. (7413)
- twisted.conch.ssh.keys is now ported to Python 3. (7998)

Bugfixes
--------
- twisted.conch.ssh.channel.SSHChannel's getPeer and getHost methods
now return an object which provides IAddress instead of an old-
style tuple address. (5999)
- twisted.conch.endpoint.SSHCommandClientEndpoint, when
authentication is delegated to an SSH agent, no longer leaves the
agent connection opened when connection to the server is lost.
(8138)

Other
-----
- 7037, 7715, 8200, 8208


Twisted Mail 16.0.0 (2016-03-10)
================================

No significant changes have been made for this release.


Twisted Names 16.0.0 (2016-03-10)
=================================

No significant changes have been made for this release.


Twisted News 16.0.0 (2016-03-10)
================================

No significant changes have been made for this release.


Twisted Pair 16.0.0 (2016-03-10)
================================

No significant changes have been made for this release.


Twisted Runner 16.0.0 (2016-03-10)
==================================

No significant changes have been made for this release.


Twisted Web 16.0.0 (2016-03-10)
===============================

Features
--------
- twisted.web.http_headers._DictHeaders now correctly handles
updating via keyword arguments in Python 3 (therefore
twisted.web.http_headers is now fully ported to Python 3). (6082)
- twisted.web.wsgi has been ported to Python 3. (7993)
- twisted.web.http_headers.Headers now accepts both Unicode and
bytestring keys and values, encoding to iso-8859-1 and utf8
respectively. (8129)
- twisted.web.vhost ported to Python 3. (8132)

Bugfixes
--------
- twisted.web.http.HTTPChannel now correctly handles non-ascii method
name by returning 400. Previously non-ascii method name was causing
unhandled exceptions. (8102)
- twisted.web.static.File on Python 3 now redirects paths to
directories without a trailing slash, to a path with a trailing
slash, as on Python 2. (8169)

Deprecations and Removals
-------------------------
- twisted.web.http.Request's headers and received_headers attributes,
deprecated since Twisted 13.2, have been removed. (8136)
- twisted.web.static.addSlash is deprecated. (8169)

Other
-----
- 8140, 8182


Twisted Words 16.0.0 (2016-03-10)
=================================

No significant changes have been made for this release.


Twisted Core 15.5.0 (2015-11-28)
================================

Python 3.5 (on POSIX) support has been added.

This release introduces changes that are required for Conch's SSH
implementation to work with OpenSSH 6.9+ servers.

Features
--------
- twisted.python.url is a new abstraction for URLs, supporting RFC
3987 IRIs. (5388)
- twisted.python.logfile is now ported to Python 3. (6749)
- twisted.python.zippath has been ported to Python 3. (6917)
- twisted.internet.ssl.CertificateOptions and
twisted.internet.ssl.optionsForClientTLS now take a
acceptableProtocols parameter that enables negotiation of the next
protocol to speak after the TLS handshake has completed. This field
advertises protocols over both NPN and ALPN. Also added new
INegotiated interface for TLS interfaces that support protocol
negotiation. This interface adds a negotiatedProtocol property that
reports what protocol, if any, was negotiated in the TLS handshake.
(7860)
- twisted.python.urlpath.URLPath now operates correctly on Python 3,
using bytes instead of strings, and introduces the fromBytes
constructor to assist with creating them cross-version. (7994)
- twisted.application.strports is now ported to Python 3. (8011)
- twistd (the Twisted Daemon) is now ported to Python 3. (8012)
- Python 3.5 is now supported on POSIX platforms. (8042)
- twisted.internet.serialport is now ported on Python 3. (8099)

Bugfixes
--------
- twisted.logger.formatEvent now can format an event if it was
flattened (twisted.logger.eventAsJSON does this) and has text after
the last replacement field. (8003)
- twisted.cred.checkers.FilePasswordDB now logs an error if the
credentials db file does not exist, no longer raises an unhandled
error. (8028)
- twisted.python.threadpool.ThreadPool now properly starts enough
threads to do any work scheduled before ThreadPool.start() is
called, such as when work is scheduled in the reactor via
reactor.callInThread() before reactor.run(). (8090)

Improved Documentation
----------------------
- Twisted Development test standard documentation now contain
information about avoiding test data files. (6535)
- The documentation for twisted.internet.defer.DeferredSemaphore now
describes the actual usage for limit and tokens instance
attributes. (8024)

Deprecations and Removals
-------------------------
- twisted.python._initgroups, a C extension, has been removed and
stdlib support is now always used instead. (5861)
- Python 2.6 is no longer supported. (8017)
- twisted.python.util.OrderedDict is now deprecated, and uses of it
in Twisted are replaced with collections.OrderedDict. (8051)
- twisted.persisted.sob.load, twisted.persisted.sob.loadValueFromFile
and twisted.persisted.sob.Persistent.save() are now deprecated when
used with a passphrase. The encyption used by these methods are
weak. (8081)
- twisted.internet.interfaces.IStreamClientEndpointStringParser has
been removed and Twisted will no longer use parsers implementing
this interface. (8094)

Other
-----
- 5976, 6628, 6894, 6980, 7228, 7693, 7731, 7997, 8046,
8054, 8056, 8060, 8063, 8064, 8068, 8072, 8091, 8095,
8096, 8098, 8106


Twisted Conch 15.5.0 (2015-11-18)
=================================

Features
--------
- twisted.conch.ssh now supports the diffie-hellman-group-exchange-
sha256 key exchange algorithm. (7672)
- twisted.conch.ssh now supports the diffie-hellman-group14-sha1 key
exchange algorithm. (7717)
- twisted.conch.ssh.transport.SSHClientTransport now supports Diffie-
Hellman key exchange using MSG_KEX_DH_GEX_REQUEST as described in
RFC 4419. (8100)
- twisted.conch.ssh now supports the hmac-sha2-256 and hmac-sha2-512
MAC algorithms. (8108)

Deprecations and Removals
-------------------------
- twisted.conch.ssh.keys.objectType is now deprecated. Use
twisted.conch.ssh.keys.Key.sshType. (8080)
- twisted.conch.ssh.transport.SSHClientTransport no longer supports
Diffie-Hellman key exchange using MSG_KEX_DH_GEX_REQUEST_OLD for
pre RFC 4419 servers. (8100)


Twisted Mail 15.5.0 (2015-11-18)
================================

No significant changes have been made for this release.


Twisted Names 15.5.0 (2015-11-18)
=================================

No significant changes have been made for this release.


Twisted News 15.5.0 (2015-11-18)
================================

No significant changes have been made for this release.


Twisted Pair 15.5.0 (2015-11-18)
================================

No significant changes have been made for this release.


Twisted Runner 15.5.0 (2015-11-18)
==================================

No significant changes have been made for this release.


Twisted Web 15.5.0 (2015-11