NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI, #994 most downloaded on PyPI
An asynchronous networking framework written in Python
Latest stable
26.10.0
Last release 14 days ago
30 Oct 2026
Release timing varies
gaps range from 8 days to 11 months
Most releases are documented
notes for 42 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
21 years old
114 releases · first in 2005
Drag across the ruler to compare, or tap a release to open it.
Requests with multiple Content-Length headers were allowed (CVE-2020-10108, thanks to Jake Miller from Bishop Fox and ZeddYu Lu for reporting this) an…
twisted.protocols.amp.BoxDispatcher.callRemote and callRemoteString will no longer return failing Deferreds for requiresAnswer=False commands when the transport they're operating on has been disconnected. (#9756)
Added a missing hyphen to a reference to the --debug option of pdb in the Trial how-to. (#9690)
The documentation of the twisted.cred.checkers module has been extended and corrected. (#9724)
twisted.news is deprecated. (#9405)
#9634, #9701, #9707, #9710, #9715, #9726, #9727, #9728, #9729, #9735, #9737, #9757
twisted.conch.ssh now supports the curve25519-sha256 key exchange algorithm (requires OpenSSL >= 1.1.0). (#6814)
twisted.conch.ssh.keys can now write private keys in the new "openssh-key-v1" format, introduced in OpenSSH 6.5 and made the default in OpenSSH 7.8. ckeygen has a corresponding new --private-key-subtype=v1 option. (#9683)
twisted.conch.keys.Key.privateBlob now returns the correct blob format for ECDSA (i.e. the same as that implemented by OpenSSH). (#9682)
#9760
Fixed return type of twisted.web.http.Request.getUser and twisted.web.http.Request.getPassword to binary if no authorization header was found or an exception was thrown (#9596)
twisted.web.http.HTTPChannel now rejects requests (with status code 400 and a drop) that have malformed headers of the form "Foo : value" or ": value". (#9646)
twisted.web.http.Request now correctly parses multipart-encoded form data submitted as a chunked request on Python 3.7+. (#9678)
twisted.web.client.BrowserLikePolicyForHTTPS is now listed in __all__, since it's a user-facing class that anyone could import and extend. (#9769)
twisted.web.http was subject to several request smuggling attacks. Requests with multiple Content-Length headers were allowed (CVE-2020-10108, thanks to Jake Miller from Bishop Fox and ZeddYu Lu for reporting this) and now fail with a 400; requests with a Content-Length header and a Transfer-Encoding header honored the first header (CVE-2020-10109, thanks to Jake Miller from Bishop Fox for reporting this) and now fail with a 400; requests whose Transfer-Encoding header had a value other than "chunked" and "identity" (thanks to ZeddYu Lu) were allowed and now fail with a 400. (#9770)
#9733
Fixed parsing of streams with Python 3.8 when there are spaces in namespaces or namespaced attributes in twisted.words.xish.domish.ExpatElementStream (#9730)
twisted.names.secondary.SecondaryAuthority now accepts str for its domain parameter, so twist dns --secondary now functions on Python 3. (#9496)
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Nothing published for this version
…data without reading responses. This closes CVE-2019-9512 (Ping Flood), CVE-2019-9514 (Reset Flood), and CVE-2019-9515 (Settings Flood). Thanks to Jon…
twisted.trial.successResultOf, twisted.trial.failureResultOf, and twisted.trial.assertNoResult accept coroutines as well as Deferreds. (#9006)
Fixed circular import in twisted.trial.reporter, introduced in Twisted 16.0.0. (#8267)
The POP3 server implemented by twisted.mail.pop3 now accepts passwords that contain spaces. (#9100)
Incoming HTTP/2 connections will now not time out if they persist for longer than one minute. (#9653)
The serial extra now requires pywin32 on Windows enabling use of twisted.internet.serialport without specifying the windows_platform extra. (#9700)
#8506, #9677, #9684, #9687, #9688
twisted.conch.ssh.keys now correctly writes the "iqmp" parameter in serialized RSA private keys as q^-1 mod p rather than p^-1 mod q. (#9681)
#9689
twisted.web.server.Request will now use twisted.web.server.Site.getContentFile, if it exists, to get a file into which to write request content. If getContentFile is not provided by the site, it will fall back to the previous behavior of using io.BytesIO for small requests and tempfile.TemporaryFile for large ones. (#9655)
twisted.web.client.FileBodyProducer will now stop producing when the Deferred returned by FileBodyProducer.startProducing is cancelled. (#9547)
The HTTP/2 server implementation now enforces TCP flow control on control frame messages and times out clients that send invalid data without reading responses. This closes CVE-2019-9512 (Ping Flood), CVE-2019-9514 (Reset Flood), and CVE-2019-9515 (Settings Flood). Thanks to Jonathan Looney and Piotr Sikora. (#9694)
No significant changes.
No significant changes.
No significant changes.
Nothing published for this version
…that contain invalid characters. This mitigates CVE-2019-12387. Thanks to Alex Brasetvik for reporting this vulnerability.
The callable argument to twisted.internet.task.deferLater() is no longer required. (#9577)
Twisted's minimum Cryptography requirement is now 2.5. (#9592)
twisted.internet.utils.getProcessOutputAndValue now accepts stdinBytes to write to the child process's standard input. (#9607)
Add new twisted.logger.capturedLogs context manager for capturing observed log events in tests. (#9617)
twisted.internet.base.PluggableResolverMixin, which implements the pluggable resolver interfaces for easier re-use in other reactors, has been factored out of ReactorBase. (#9632)
The PyPI page for Twisted has been enhanced to include more information and useful links. (#9648)
twisted.internet.endpoints is now importable on Windows when pywin32 is not installed. (#6032)
twisted.conch.ssh now generates correct keys when using hmac-sha2-512 with SHA1 based KEX algorithms. (#8258)
twisted.internet.iocpreactor.abstract.FileHandle no longer duplicates/looses outgoing data when .write() is called in rapid succession with large payloads (#9446)
twisted.application.backoffPolicy will not fail on connection attempts > 1750 with default settings. (#9476)
Trial on Python 3 will now properly re-raise ImportErrors that occur during the import of a module, rather than saying the module doesn't exist. (#9628)
twisted.internet.process does not fail on import when the process has more than 1024 file descriptors opened. (#9636)
Add the stackLevel keyword argument to twisted.logger.STDLibLogObserver._findCaller to fix an incompatibility with Python 3.8. (#9668)
Fix the incorrect docstring for twisted.python.components.Componentized.addComponent which stated that the function returned a list of interfaces, even though the function doesn't actually do so. (#9637)
twisted.test.proto_helpers has moved to twisted.internet.testing. twisted.test.proto_helpers has been deprecated. (#6435)
twisted.protocols.mice, deprecated since Twisted 16.0, has been removed. (#9602)
twisted.conch.insults.client and twisted.conch.insults.colors, deprecated since Twisted 10.1, have been removed. (#9603)
The __version__ attribute of Twisted submodules that were previously packaged separately, deprecated since Twisted 16.0, has been removed. (#9604)
Python 3.4 is no longer supported. (#9613)
twisted.python.compat.OrderedDict, an alias for collections.OrderedDict and deprecated since Twisted 15.5, has been removed. (#9639)
#9217, #9445, #9454, #9605, #9614, #9615, #9619, #9625, #9633, #9640, #9674
t.c.ssh.connection.SSHConnection now fails channels that are in the process of opening when the connection is lost. (#2782)
#9610
twisted.web.tap, the module that is run by twist web, now accepts --display-tracebacks to render tracebacks on uncaught exceptions. (#9656)
twisted.web.http.Request.write after the channel is disconnected will no longer raise AttributeError. (#9410)
twisted.web.client.Agent.request() and twisted.web.client.ProxyAgent.request() now produce TypeError when the method argument is not bytes, rather than failing to generate the request. (#9643)
twisted.web.http.HTTPChannel no longer raises TypeError internally when receiving a line-folded HTTP header on Python 3. (#9644)
All HTTP clients in twisted.web.client now raise a ValueError when called with a method and/or URL that contain invalid characters. This mitigates CVE-2019-12387. Thanks to Alex Brasetvik for reporting this vulnerability. (#9647)
twisted.web.server.Site's instance variable displayTracebacks is now set to False by default. (#9656)
twisted.web.iweb.IRequest's "prepath" and "postpath" attributes, which have existed for a long time, are now documented. (#5533)
The documented type of t.w.iweb.IRequest's "method" and "uri" attributes on Python 3 has been corrected to match the implementation. (#9091)
t.w.iweb.IRequest's "args" attribute is now correctly documented to be bytes. (#9458)
The API documentation of twisted.web.iweb.IRequest and twisted.web.http.Request has been updated and extended to match the implementation. (#9593)
Passing a path argument to twisted.web.resource.Resource.putChild which is not of type bytes is now deprecated. In the future, passing a non-bytes argument to putChild will return an error. (#9135)
Passing --notracebacks/-n to twisted.web.tap, the module that is run by twist web, is now deprecated due to traceback rendering being disabled by default. (#9656)
#9597
No significant changes.
twisted.words.protocols.jabber.xmlstream.TLSInitiatingInitializer and twisted.words.protocols.jabber.client.XMPPClientFactory now take an optional configurationForTLS for customizing certificate options for StartTLS. (#9561)
twisted.words.protocols.jabber.xmlstream.TLSInitiatingInitializer now properly verifies the server's certificate against platform CAs and the stream's domain, mitigating CVE-2019-12855. (#9561)
twisted.names.client.Resolver will no longer infinite loop if it cannot bind a UDP port to use for resolving. (#9620)
Nothing published for this version
Nothing published for this version
twisted.web.http.Request.cookies, twisted.web.http.HTTPChannel.writeHeaders, and twisted.web.http_headers.Headers were all vulnerable to header inject…
This is the final release that will support Python 3.4.
twisted.internet.ssl.CertificateOptions now uses 32 random bytes instead of an MD5 hash for the ssl session identifier context. (#9463)
DeferredLock and DeferredSemaphore can be used as asynchronous context managers on Python 3.5+. (#9546)
t.i.b.BaseConnector has custom __repr__ (#9548)
twisted.internet.ssl.optionsForClientTLS now supports validating IP addresses from the certificate subjectAltName (#9585)
Twisted's minimum Cryptography requirement is now 2.5. (#9592)
twisted.web.proxy.ReverseProxyResource fixed documentation and example snippet (#9192)
twisted.python.failure.Failure.getTracebackObject now returns traceback objects whose frames can be passed into traceback.print_stack for better debugging of where the exception came from. (#9305)
twisted.internet.ssl.KeyPair.generate: No longer generate 1024-bit RSA keys by default. Anyone who generated a key with this method using the default value should move to replace it immediately. (#9453)
The message of twisted.internet.error.ConnectionAborted is no longer truncated. (#9522)
twisted.enterprise.adbapi.ConnectionPool.connect now logs only the dbapiName and not the connection arguments, which may contain credentials (#9544)
twisted.python.runtime.Platform.supportsINotify no longer considers the result of isDocker for its own result. (#9579)
The documentation for the the twisted.internet.interfaces.IConsumer, IProducer, and IPullProducer interfaces is more detailed. (#2546)
The errback example in the docstring of twisted.logger.Logger.failure has been corrected. (#9334)
The sample code in the "Twisted Web In 60 Seconds" tutorial runs on Python 3. (#9559)
#8921, #9071, #9125, #9428, #9536, #9540, #9580
twisted.conch.ssh.keys can now read private keys in the new "openssh-key-v1" format, introduced in OpenSSH 6.5 and made the default in OpenSSH 7.8. (#9515)
Conch now uses pyca/cryptography for Diffie-Hellman key generation and agreement. (#8831)
#9584
twisted.web.client.HostnameCachingHTTPSPolicy was added as a new contextFactory option. The policy caches a specified number of twisted.internet.interfaces.IOpenSSLClientConnectionCreator instances to to avoid the cost of instantiating a connection creator for multiple requests to the same host. (#9138)
twisted.web.http.Request.cookies, twisted.web.http.HTTPChannel.writeHeaders, and twisted.web.http_headers.Headers were all vulnerable to header injection attacks. They now replace linear whitespace ('r', 'n', and 'rn') with a single space. twisted.web.http.Reqeuest.cookies also replaces semicolons (';') with a single space. (#9420)
twisted.web.client.Request and twisted.web.client.HTTPClient were both vulnerable to header injection attacks. They now replace linear whitespace ('r', 'n', and 'rn') with a single space. (#9421)
No significant changes.
No significant changes.
twisted.names.dns now has IRecord implementations for the SSHFP and TSIG record types. (#9373)
Nothing published for this version
Nothing published for this version
async keyword argument is deprecated in twisted.conch.manhole (ManholeInterpreter.write and Manhole.add) and in twisted.main.imap4.IMAP4Server.sendUnt…
twisted.internet._sslverify.ClientTLSOptions no longer raises IDNAError when given an IPv6 address as a hostname in a HTTPS URL. (#9433)
The repr() of a twisted.internet.base.DelayedCall now encodes the same information as its str(), exposing details of its scheduling and target callable. (#9481)
Python 3.7 is now supported. (#9502)
twisted.logger.LogBeginner's default critical observer now prints tracebacks for new and legacy log system events through the use of the new eventAsText API. This API also does not raise an error for non-ascii encoded data in Python2, it attempts as well as possible to format the traceback. (#7927)
Syntax error under Python 3.7 fixed for twisted.conch.manhole and twisted.main.imap4. (#9384)
trial -j reports tracebacks on test failures under Python 3. (#9436)
Properly format multi-byte and non-ascii encoded data in a traceback. (#9456)
twisted.python.rebuild now functions on Python 3.7. (#9492)
HTTP/2 server connections will no longer time out active downloads that take too long. (#9529)
Several minor formatting problems in the API documentation have been corrected. (#9461)
The documentation of twisted.internet.defer.Deferred.fromFuture() has been updated to reflect upstream changes. (#9539)
async keyword argument is deprecated in twisted.conch.manhole (ManholeInterpreter.write and Manhole.add) and in twisted.main.imap4.IMAP4Server.sendUntaggedResponse, isAsync keyword argument is introduced instead. (#9384)
#9379, #9485, #9489, #9499, #9501, #9511, #9514, #9523, #9524, #9525, #9538
twisted.conch.keys.Key.public returns the same twisted.conch.keys.Key instance when it is already a public key instead of failing with an exception. (#9441)
RSA private keys are no longer corrupted during loading, allowing OpenSSL's fast-path to operate for RSA signing. (#9518)
The documentation for IConchUser.gotGlobalRequest() is more accurate. (#9413)
twisted.conch.ssh.filetransfer.ClientDirectory's use as an iterator has been deprecated. (#9527)
twisted.web.server.Request.getSession now returns a new session if the previous session has expired. (#9288)
#9479, #9480, #9482, #9491
No significant changes.
No significant changes.
No significant changes.
Nothing published for this version
Deprecate direct introspection of ProcMon's processes: processes should not be directly accessed or pickled.
Cancelling a Deferred returned by twisted.internet.defer.inlineCallbacks now cancels the Deferred it is waiting on. (#4632)
twisted.application.internet.ClientService now accepts a function to initialize or validate a connection before it is returned by the whenConnected method as the prepareConnection argument. (#8375)
Traceback generated for twisted.internet.defer.inlineCallbacks now includes the full stack of inlineCallbacks generators between catcher and raiser (before it only contained raiser's stack). (#9176)
Add optional cwd argument to twisted.runner.procmon.ProcMon.addProcess (#9287)
twisted.python.failure.Failure tracebacks generated by coroutines scheduled with twisted.internet.defer.ensureDeferred - i.e. any Deferred-awaiting coroutine - now contain fewer extraneous frames from the trampoline implementation, and correctly indicate the source of exceptions raised in other call stacks - i.e. the function that raised the exception. In other words: if you 'await' a function that raises an exception, you'll be able to see where the error came from. (#9459)
On UNIX-like platforms, Twisted attempts to recover from EMFILE when accepting connections on TCP and UNIX ports by shedding incoming clients. (#5368)
The documentation of IReactorTime.getDelayedCalls() has been corrected to indicate that the method returns a list, not a tuple. (#9418)
"python -m twisted web --help" now refers to "--listen" instead of the non-existing "--http" (#9434)
twisted.python.htmlizer.TokenPrinter now explicitly works on bytestrings. (#9442)
twisted.enterprise.adbapi.ConnectionPool.runWithConnection and runInteraction now use the reactor that is passed to ConnectionPool's constructor. (#9467)
The Twisted Coding Standard now contains examples of how to mark up a feature as added in the next Twisted release. (#9460)
Deprecate direct introspection of ProcMon's processes: processes should not be directly accessed or pickled. (#9287)
twisted.internet.address.IPv4Address._bwHack and twisted.internet.address.UNIXAddress._bwHack, as well as the parameters to the constructors, deprecated since Twisted 11.0, have been removed. (#9450)
#7495, #9399, #9406, #9411, #9425, #9439, #9449, #9450, #9452
twisted.conch.ssh.transport.SSHTransportBase now includes Twisted's version in the software version string it sends to the server, allowing servers to apply compatibility workarounds for bugs in particular client versions. (#9424)
If the command run by twisted.conch.endpoints.SSHCommandClientEndpoint exits because of a delivered signal, the client protocol's connectionLost is now called with a ProcessTerminated exception instead of a ConnectionDone exception. (#9412)
twisted.conch.ssh.transport.SSHTransportBase now correctly handles MSG_DEBUG with a false alwaysDisplay field on Python 2 (broken since 8.0.0). (#9422)
twisted.conch.manhole.lastColorizedLine now does not throw a UnicodeDecodeError on non-ASCII input. (#9442)
Added support for SameSite cookies in http.Request.addCookie. (#9387)
twisted.web.server.GzipEncoderFactory would sometimes fail to gzip requests if the Accept-Encoding header contained whitespace between the comma-separated acceptable encodings. It now trims whitespace before checking if gzip is an acceptable encoding. (#9086)
twisted.web.static.File renders directory listings on Python 2, including those with text paths. (#9438)
twisted.python.http.Request now correcly parses multipart bodies on Python 3.7. (#9448)
twisted.web.http.combinedLogFormatter (used by t.w.http.Server and t.w.server.Site) no longer produces DeprecationWarning about Request.getClientIP. (#9470)
#9432, #9466, #9479, #9480
No significant changes.
No significant changes.
#9398
Nothing published for this version
Nothing published for this version
The --port/--https arguments to web plugin are now deprecated, in favor of --listen. The --listen argument can be given multiple times to listen on mu…
The --port/--https arguments to web plugin are now deprecated, in favor of --listen. The --listen argument can be given multiple times to listen on multiple ports. (#6670)
Twisted now requires zope.interface 4.4.2 or higher across all platforms and Python versions. (#8149)
The osx_platform setuptools extra has been renamed to macos_platform, with the former name being a compatibility alias. (#8848)
Zsh completions are now provided for the twist command. (#9338)
twisted.internet.endpoints.HostnameEndpoint now has a __repr__ method which includes the host and port to which the endpoint connects. (#9341)
twistd now uses the UID's default GID to initialize groups when --uid is given but --gid is not. This prevents an unhandled TypeError from being raised when os.initgroups() is called. (#4442)
twisted.protocols.basic.LineReceiver checks received lines' lengths against its MAX_LENGTH only after receiving a complete delimiter. A line ending in a multi-byte delimiter like 'rn' might be split by the network, with the first part arriving before the rest; previously, LineReceiver erroneously disconnected if the first part, e.g. 'zzzz....r' exceeded MAX_LENGTH. LineReceiver now checks received data against MAX_LENGTH plus the delimiter's length, allowing short reads to complete a line. (#6556)
twisted.protocols.basic.LineOnlyReceiver disconnects the transport after receiving a line that exceeds MAX_LENGTH, like LineReceiver. (#6557)
twisted.web.http.Request.getClientIP now returns the host part of the client's address when connected over IPv6. (#7704)
twisted.application.service.IService is now documented as requiring the 'running', 'name' and 'parent' attributes (the documentation previously implied they were required, but was unclear). (#7922)
twisted.web.wsgi.WSGIResource no longer raises an exception when a client connects over IPv6. (#8241)
When using TLS enable automatic ECDH curve selection on OpenSSL 1.0.2+ instead of only supporting P-256 (#9210)
twisted.trial._dist.worker and twisted.trial._dist.workertrial consistently pass bytes, not unicode to AMP. This fixes "trial -j" on Python 3. (#9264)
twisted.trial.runner now uses the 'importlib' module instead of the 'imp' module on Python 3+. This eliminates DeprecationWarnings caused by importing 'imp' on Python 3. (#9275)
twisted.web.client.HTTP11ClientProtocol now closes the connection when the server is sending a header line which is longer than he line limit of twisted.protocols.basic.LineReceiver.MAX_LENGTH. (#9295)
twisted.python.failure now handles long stacktraces better; in particular it will log tracebacks for stack overflow errors. (#9301)
The "--_shell-completion" argument to twistd now works on Python 3. (#9303)
twisted.python.failure.Failure now raises the wrapped exception in Python3, and self (Failure) n Python2 when trap() is called without a matching exception (#9307)
Writing large amounts of data no longer implies repeated, expensive copying under Python 3. Python 3's write speeds are now as fast as Python 2's. (#9324)
twisted.protocols.postfix now properly encodes errors which are unicode strings to bytes. (#9335)
twisted.protocols.policies.ProtocolWrapper and twisted.protocols.tls.TLSMemoryBIOProtocol no longer create circular references that keep protocol instances in memory after connection is closed. (#9374)
twisted.conch.ssh.transport.SSHTransportBase no longer strips trailing spaces from the SSH version string of the connected peer. (#9377)
trial -j no longer crashes on Python 2 on test failure messages containing non-ASCII bytes. (#9378)
RSA keys replaced with 2048bit ones in twisted.conch.test.keydata in order to be compatible with OpenSSH 7.6. (#9388)
AsyncioSelectorReactor uses the global policy's event loop. asyncio libraries that retrieve the running event loop with get_event_loop() will now receive the one used by AsyncioSelectorReactor. (#9390)
public attributes of twisted.logger.Logger are now documented as attributes. (#8157)
List indentation formatting errors have been corrected throughout the documentation. (#9256)
twisted.protocols.basic.LineOnlyReceiver.lineLengthExceeded no longer returns twisted.internet.error.ConnectionLost. It instead directly disconnects the transport and returns None. (#6557)
twisted.python.win32.getProgramsMenuPath and twisted.python.win32.getProgramFilesPath were deprecated in Twisted 15.3.0 and have now been removed. (#9312)
Python 3.3 is no longer supported. (#9352)
#7033, #8887, #9204, #9289, #9291, #9292, #9293, #9302, #9336, #9355, #9356, #9364, #9375, #9381, #9382, #9389, #9391, #9393, #9394, #9396
twisted.plugins.cred_unix now properly converts a username and password from bytes to str on Python 3. In addition, passwords which are encrypted with SHA512 and SH256 are properly verified. This fixes running a conch server with: "twistd -n conch -d /etc/ssh/ --auth=unix". (#9130)
In twisted.conch.scripts.conch, on Python 3 do not write bytes directly to sys.stderr. On Python 3, this fixes remote SSH execution of a command which fails. (#9344)
twisted.conch.ssh.filetransfer.FileTransferClient.wasAFile attribute has been removed as it serves no purpose. (#9362)
Removed deprecated support for PyCrypto key objects in conch (#9368)
The new twisted.iweb.IRequest.getClientAddress returns the IAddress provider representing the client's address. Callers should check the type of the returned value before using it. (#7707)
Eliminate use of twisted.python.log in twisted.web modules. (#9280)
Scripts ending with .rpy, .epy, and .cgi now execute properly in Twisted Web on Python 3. (#9271)
twisted.web.http.Request and twisted.web.server.Request are once again hashable on Python 2, fixing a regression introduced in Twisted 17.5.0. (#9314)
Correct reactor docstrings for twisted.web.client.Agent and twisted.web.client._StandardEndpointFactory to communicate interface requirements since 17.1. (#9274)
The examples for the "Twisted Web in 60 Seconds" tutorial have been fixed to work on Python 3. (#9285)
twisted.iweb.IRequest.getClientIP is deprecated. Use twisted.iweb.IRequest.getClientAddress instead (see #7707). (#7705)
twisted.web.iweb.IRequest.getClient and its implementations (deprecated in #2552) have been removed. (#9395)
twistd.mail.scripts.mailmail has been ported to Python 3. (#8487)
twisted.mail.bounce now works on Python 3. (#9260)
twisted.mail.pop3 and twisted.mail.pop3client now work on Python 3. (#9269)
SMTP authentication in twisted.mail.smtp now works better on Python 3, due to improved improved bytes vs unicode handling. (#9299)
#9310
No significant changes.
No significant changes.
Nothing published for this version
twisted.protocols.dict is deprecated.
This is the last Twisted release where Python 3.3 is supported, on any platform.
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)
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)
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)
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)
#5949, #8566, #8650, #8944, #9159, #9160, #9162, #9196, #9219, #9228, #9229, #9230, #9247, #9248, #9249, #9251, #9254, #9262, #9276, #9308
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)
twisted.conch.ssh._cryptography_backports has been removed in favor of using int_to_bytes() and int_from_bytes() from cryptography.utils. (#9263)
#9158, #9272
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)
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)
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)
twisted.words.tap has been ported to Python 3 (#9169)
#9246
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)
Nothing published for this version
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…
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)
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)
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)
#8133, #8995, #8997, #9003, #9015, #9021, #9026, #9027, #9049, #9057, #9062, #9065, #9069, #9070, #9072, #9074, #9075, #9111, #9117, #9140, #9144, #9145
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)
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)
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)
twisted.mail.smtp has been ported to Python 3. (#8770)
RRHeader now converts its ttl argument to an integer, raising a TypeError if it cannot. (#8340)
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)
twisted.web.template.flattenString docstring now correctly references io.BytesIO (rather than NativeStringIO). (#9028)
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)
#8981, #9018, #9067, #9090, #9092, #9093, #9096
twisted.words.protocols.oscar, which is client code for Oscar/ICQ, was deprecated in 16.2.0 and has now been removed. (#9024)
twisted.internet.reactor.spawnProcess now does not emit a deprecation warning on Unicode arguments. It will encode Unicode arguments down to bytes usi…
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)
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)
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)
#7879, #8583, #8764, #8809, #8859, #8906, #8910, #8913, #8916, #8934, #8945, #8949, #8950, #8952, #8953, #8959, #8962, #8963, #8967, #8975, #8976, #8993, #9013
Nothing published for this version
Nothing published for this version
Nothing published for this version
The twist script can now be run by invoking python -m twisted.
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)
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)
twisted.test.proto_helpers is now explicitly covered by the compatibility policy. (#8857)
#8281, #8823, #8862
Nothing published for this version
twisted.python.constants is deprecated in preference to constantly on PyPI, which is the same code rolled into its own package.
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)
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)
The twisted.internet.interfaces.IProtocol.dataReceived() method takes one parameter of type bytes. This has been clarified in the doc string. (#8763)
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)
#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
Nothing published for this version
Nothing published for this version
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.s
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)
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)
This is a precursor to formally deprecating the former class in favour of the latter.
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)
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)
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)
Dropped support for pyOpenSSL versions less than 16.0.0. (#8441)
#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
Nothing published for this version
Nothing published for this version
twisted.python.reflect's deprecated functions have been removed. This includes funcinfo (deprecated since Twisted 2.5), allYourBase and accumulateBase…
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)
Development documentation has been updated to refer to Git instead of SVN. (#8335)
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)
#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
Deprecation documentation was extended to include a quick check list for developers.
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)
twisted.application-using applications (trial, twistd, etc) now work with the --reactor option on Python 3. (#8299)
Failures are now logged by STDLibLogObserver. (#8316)
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)
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)
#6266, #8231, #8244, #8256, #8266, #8269, #8275, #8277, #8286, #8291, #8292, #8304, #8315
No significant changes have been made for this release.
No significant changes have been made for this release.
twisted.application.internet.ClientService, a service that maintains a persistent outgoing endpoint-based connection; a replacement for ReconnectingCl
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)
Twisted is now compatible with OpenSSL 1.0.2f. (#8189)
#4543, #8124, #8193, #8210, #8220, #8223, #8226, #8242
twisted.internet.task.LoopingCall.deferred is now deprecated. Use the deferred returned by twisted.internet.task.LoopingCall.start()
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)
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)
The Twisted Project has adopted the Contributor Covenant as its Code of Conduct. (#8173)
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)
#6842, #6978, #7668, #7791, #7881, #7943, #7944, #8050, #8104, #8115, #8119, #8122, #8139, #8144, #8154, #8162, #8180, #8187, #8220
twisted.python.util.OrderedDict is now deprecated, and uses of it in Twisted are replaced with collections.OrderedDict.
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.
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)
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)
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)
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)
#5976, #6628, #6894, #6980, #7228, #7693, #7731, #7997, #8046, #8054, #8056, #8060, #8063, #8064, #8068, #8072, #8091, #8095, #8096, #8098, #8106
This is the last Twisted release where Python 2.6 is supported, on any platform.
This is the last Twisted release where Python 2.6 is supported, on any platform.
Trial has been ported to Python 3. (#5965)
Twisted now requires setuptools for installation. (#7177)
twisted.internet.endpoints.clientFromString is now ported to Python 3. (#7973)
twisted.internet._sslverify now uses SHA256 instead of MD5 for certificate request signing by default. (#7979)
twisted.internet.endpoints.serverFromString is now ported to Python 3. (#7982)
twisted.positioning is now ported to Python 3. (#7987)
twisted.python.failure.Failure's __repr__ now includes the exception message. (#8004)
fixed a bug which could lead to a hang at shutdown in twisted.python.threadpool. (#2673)
twisted.internet.kqreactor on Python 3 now supports EINTR (Control-C) gracefully. (#7887)
Fix a bug introduced in 15.3.0; pickling a lambda function after importing twisted.persisted.styles raises PicklingError rather than AttributeError. (#7989)
#7902, #7980, #7990, #7992
twisted.python.win32.getProgramsMenuPath and twisted.python.win32.getProgramFilesPath are now deprecated.
twisted.application.app is now ported to Python 3 (#6914)
twisted.plugin now supports Python 3 (#7182)
twisted.cred.checkers is now ported to Python 3. (#7834)
twisted.internet.unix is now ported to Python 3. (#7874)
twisted.python.sendmsg has now been ported to Python 3, using the stdlib sendmsg/recvmsg functionality when available. (#7884)
twisted.internet.protocol.Factory now uses the new logging system (twisted.logger) for all its logging statements. (#7897)
twisted.internet.stdio is now ported to Python 3. (#7899)
The isDocker method has been introduced on twisted.python.runtime.Platform to detect if the running Python is inside a Docker container. Additionally, Platform.supportsINotify() now returns False if isDocker() is True, because of many Docker storage layers having broken INotify. (#7968)
twisted.logger.LogBeginner.beginLoggingTo now outputs the correct warning when it is called more than once. (#7916)
twisted.cred.pamauth (providing PAM support) has been removed due to it being unusable in current supported Python versions. (#3728)
twisted.application.app.HotshotRunner (twistd's hotshot profiler module) is removed and twistd now uses cProfile by default. (#5137)
twisted.python.win32.getProgramsMenuPath and twisted.python.win32.getProgramFilesPath are now deprecated. (#7883)
twisted.lore has now been removed, in preference to Sphinx. (#7892)
Deprecated zsh tab-complete files are now removed in preference to twisted.python.usage's tab-complete functionality. (#7898)
twisted.python.hashlib, deprecated since 13.1, has now been removed. (#7905)
twisted.trial.runner.DryRunVisitor, deprecated in Twisted 13.0, has now been removed. (#7919)
twisted.trial.util.getPythonContainers, deprecated since Twisted 12.3, is now removed. (#7920)
Twisted no longer supports being packaged as subprojects. (#7964)
#6136, #7035, #7803, #7817, #7827, #7844, #7876, #7906, #7908, #7915, #7931, #7940, #7967, #7983
twisted.logger now marks the isError key correctly on legacy events generated by writes to stderr.
twisted.logger now marks the isError key correctly on legacy events generated by writes to stderr. (#7903)
twisted.logger's documentation is now correctly listed in the table of contents. (#7904)
tkunzip and tapconvert in twisted.scripts were deprecated in 11.0 and 12.1 respectively, and are now removed.
twisted.internet.process has now been ported to Python 3. (#5987)
twisted.cred.credentials is now ported to Python 3. (#6176)
twisted.trial.unittest.TestCase's assertEqual, assertTrue, and assertFalse methods now pass through the standard library's more informative failure messages. (#6306)
The new package twisted.logger provides a new, fully tested, and feature-rich logging framework. The old module twisted.python.log is now implemented using the new framework. The new logger HOWTO documents the new framework. (#6750)
twisted.python.modules is now ported to Python 3. (#7804)
twisted.python.filepath.FilePath now supports Unicode (text) paths. Like the os module, instantiating it with a Unicode path will return a Unicode-mode FilePath, instantiating with a bytes path will return a bytes-mode FilePath. (#7805)
twisted.internet.kqreactor is now ported to Python 3 (#7823)
twisted.internet.endpoints.ProcessEndpoint is now ported to Python 3. (#7824)
twisted.python.filepath.FilePath now has asBytesMode and asTextMode methods which return a FilePath in the requested mode. (#7830)
twisted.python.components.proxyForInterface now creates method proxies that can be used with functools.wraps. (#7832)
The tls optional dependency will now also install the idna package to validate idna2008 names. (#7853)
Don't raise an exception if DefaultLogObserver.emit() gets an event with a message that raises when repr() is called on it. Specifically: use textFromEventDict() instead of a separate (and inferior) message rendering implementation. (#6569)
twisted.cred.credentials.DigestedCredentials incorrectly handled md5-sess hashing according to the RFC, which has now been fixed. (#7835)
Fixed an issue with twisted.internet.task.LoopingCall.withCount where sometimes the passed callable would be invoked with "0" when we got close to tricky floating point boundary conditions. (#7836)
twisted.internet.defer now properly works with the new logging system. (#7851)
Change messages key to log_io for events generated by LoggingFile. (#7852)
twisted.logger had literal characters in docstrings that are now quoted. (#7854)
twisted.logger now correctly formats a log event with a key named message when passed to a legacy log observer. (#7855)
twisted.internet.endpoints.HostnameEndpoint now uses getaddrinfo properly on Python 3.4 and above. (#7886)
Fix a typo in narrative documentation for logger (#7875)
tkunzip and tapconvert in twisted.scripts were deprecated in 11.0 and 12.1 respectively, and are now removed. (#6747)
twisted.protocols.gps is deprecated in preference to twisted.positioning. (#6810)
twisted.scripts.tap2deb and twisted.scripts.tap2rpm are now deprecated. (#7682)
twisted.trial.reporter.TestResult and twisted.trial.reporter.Reporter contained deprecated methods (since 8.0) which have now been removed. (#7815)
#6027, #7287, #7701, #7727, #7758, #7776, #7786, #7812, #7819, #7831, #7838, #7865, #7866, #7869, #7872, #7877, #7878, #7885
twisted.application.internet.UDPClient, deprecated since Twisted 13.1.0, has been removed.
Optional dependencies can be installed using the extra_requires facility provided by setuptools. (#3696)
Twisted Trial's basics documentation now has a link to the documentation about how Trial finds tests. (#4526)
twisted.application.internet.UDPClient, deprecated since Twisted 13.1.0, has been removed. (#7702)
#6988, #7005, #7006, #7007, #7008, #7044, #7335, #7666, #7723, #7724, #7725, #7748, #7763, #7765, #7766, #7768
twisted.python.filepath.FilePath.statinfo was deprecated.
twisted.internet.protocol.ClientFactory (and subclasses) may now return None from buildProtocol to immediately close the connection. (#710)
twisted.trial.unittest.SynchronousTestCase.assertRaises can now return a context manager. (#5339)
Implementations of twisted.internet.interfaces.IStreamClientEndpoint included in Twisted itself will now handle None being returned from the client factory's buildProtocol method by immediately closing the connection and firing the waiting Deferred with a Failure. (#6976)
inlineCallbacks now supports using the return statement with a value on Python 3 (#7624)
twisted.spread.banana.Banana.sendEncoded() now raises a more informative error message if the user tries to encode objects of unsupported type. (#7663)
twisted.internet.interfaces.IReactorMulticast.listenMultiple works again RHEL 6's python 2.6. (#7159)
Allow much more of the code within Twisted to use ProcessEndpoint by adding IPushProducer and IConsumer interfaces to its resulting transport. (#7436)
twisted.internet.ssl.Certificate(...).getPublicKey().keyHash() now produces a stable value regardless of OpenSSL version. Unfortunately this means that it is different than the value produced by older Twisted versions. (#7651)
twisted.python.reflect.safe_str on Python 3 converts utf-8 encoded bytes to clean str instead of "b'a'" (#7660)
twisted.spread.banana.Banana now raises NotImplementedError when receiving pb messages without pb being the selected dialect (#7662)
The SSL server string endpoint parser (twisted.internet.endpoints.serverFromString) now constructs endpoints which, by default, disable the insecure SSLv3 protocol. (#7684)
The SSL client string endpoint parser (twisted.internet.endpoints.clientFromString) now constructs endpoints which, by default, disable the insecure SSLv3 protocol. (#7686)
inlineCallbacks now has introductory documentation. (#1009)
The echoclient example now uses twisted.internet.task.react. (#7083)
Twisted Trial's how-to documentation now has a link to Twisted's contribution guidelines and has been reformatted. (#7475)
Fixed a path error in the make.bat file for building Sphinx documentation, so that it is now possible to build the documentation using make.bat on Windows. (#7542)
twisted.python.filepath.FilePath.statinfo was deprecated. (#4450)
twisted.internet.defer.deferredGenerator is now deprecated. twisted.internet.defer.inlineCallbacks should be used instead. (#6044)
Pickling twisted.internet.ssl.OptionSSLCertificationOptions and twisted.internet.ssl.Keypair is no longer supported. __getstate__ and __setstate__ methods of these classes have been deprecated. (#6166)
twisted.spread.jelly's support for unjellying "instance" atoms is now deprecated. (#7653)
#3404, #4711, #5730, #6042, #6626, #6947, #6953, #6989, #7032, #7038, #7039, #7097, #7098, #7142, #7143, #7154, #7155, #7156, #7157, #7158, #7160, #7161, #7162, #7164, #7165, #7176, #7234, #7252, #7329, #7333, #7355, #7369, #7370, #7419, #7529, #7531, #7534, #7537, #7538, #7620, #7621, #7633, #7636, #7637, #7638, #7640, #7641, #7642, #7643, #7665, #7667, #7713, #7719
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
One column per quarter.