Twisted 24.3.0

Twisted 24.3.0 (2024-03-01)

This release supports PyPy v7.3.14.

Bugfixes

• twisted.logger.formatEvent now honors dotted method names, not just
  flat function names, in format strings, as it has long been
  explicitly documented to do. So, you will now get the expected
  result from [formatEvent("here's the result of calling a method at
  log-format time: {obj.method()}", obj=...)]{.title-ref} (#9347)
• twisted.web.http.HTTPChannel now ignores the trailer headers
  provided in the last chunk of a chunked encoded response, rather
  than raising an exception. (#11997)
• twisted.protocols.tls.BufferingTLSTransport, used by default by
  twisted.protocols.tls.TLSMemoryBIOFactory, was refactored for
  improved performance when doing a high number of small writes.
  (#12011)
• twisted.python.failure.Failure now throws exception for generators
  without triggering a deprecation warnings on Python 3.12. (#12026)
• twisted.internet.process.Process, used by reactor.spawnProcess,
  now copies the parent environment when the [env=None]{.title-ref}
  argument is passed on Posix systems and os.posix_spawnp is used
  internally. (#12068)
• twisted.internet.defer.inlineCallbacks.returnValue's stack
  introspection was adjusted for the latest PyPy 7.3.14 release,
  allowing legacy @inlineCallbacks to run on new PyPY versions.
  (#12084)

Deprecations and Removals

• twisted.trial.reporter.TestRun.startTest() is no longer called for
  tests with skip annotation or skip attribute for Python 3.12.1 or
  newer. This is the result of upstream Python gh-106584 change. The
  behavior is not change in 3.12.0 or older. (#12052)

Misc

• #11902, #12018, #12023, #12031, #12032, #12052, #12056,
  #12067, #12076, #12078, #12087, #12095

Conch

No significant changes.

Web

Bugfixes

• The documentation for twisted.web.client.CookieAgent no longer
  references long-deprecated cookielib and urllib2 standard
  library modules. (#12044)

Deprecations and Removals

• twisted.web.http.Request now parses the
  [multipart/form-data]{.title-ref} using
  [email.message_from_bytes]{.title-ref}. The usage of
  [cgi.parse_multipart]{.title-ref} was removed as the
  [cgi]{.title-ref} module will be removed in Python 3.13. (#11848)

Misc

• #12015

Mail

No significant changes.

Words

Improved Documentation

• The documented IRC example was updated for Python3 usage. (#12070)

Names

No significant changes.

Trial

No significant changes.

Twisted 24.2.0rc1

Twisted 24.2.0.rc1 (2024-02-21)

Bugfixes

• twisted.logger.formatEvent now honors dotted method names, not just flat
  function names, in format strings, as it has long been explicitly documented to
  do. So, you will now get the expected result from formatEvent("here's the result of calling a method at log-format time: {obj.method()}", obj=...) (#9347)
• twisted.web.http.HTTPChannel now ignores the trailer headers provided in the last chunk of a chunked encoded response, rather than raising an exception. (#11997)
• twisted.protocols.tls.BufferingTLSTransport, used by default by twisted.protocols.tls.TLSMemoryBIOFactory, was refactored for improved performance when doing a high number of small writes. (#12011)
• twisted.python.failure.Failure now throws exception for generators without triggering a deprecation warnings on Python 3.12. (#12026)
• twisted.internet.process.Process, used by reactor.spawnProcess, now copies the parent environment when the env=None argument is passed on Posix systems and os.posix_spawnp is used internally. (#12068)
• twisted.internet.defer.inlineCallbacks.returnValue's stack introspection was adjusted for the latest PyPy 7.3.14 release, allowing legacy @inlineCallbacks to run on new PyPY versions. (#12084)

Deprecations and Removals

• twisted.trial.reporter.TestRun.startTest() is no longer called for tests
  with skip annotation or skip attribute for Python 3.12.1 or newer.
  This is the result of upstream Python gh-106584 change.
  The behavior is not change in 3.12.0 or older. (#12052)

Misc

• #11902, #12018, #12023, #12031, #12032, #12052, #12056, #12067, #12076, #12078, #12087, #12095

Conch

No significant changes.

Web

Bugfixes

• The documentation for twisted.web.client.CookieAgent no longer references
  long-deprecated cookielib and urllib2 standard library modules. (#12044)

Deprecations and Removals

• twisted.web.http.Request now parses the multipart/form-data using email.message_from_bytes.
  The usage of cgi.parse_multipart was removed as the cgi module will be removed in Python 3.13. (#11848)

Misc

• #12015

Mail

No significant changes.

Words

Improved Documentation

• The documented IRC example was updated for Python3 usage. (#12070)

Names

No significant changes.

Trial

No significant changes.

Twisted 23.10.0

Twisted 23.10.0 (2023-10-31)

No changes since 23.10.0.rc1.

Features

• twisted.python.filepath.FilePath and related classes (twisted.python.filepath.IFilepath, twisted.python.filepath.AbstractFilePath, twisted.python.zippath.ZipPath, and twisted.python.zippath.ZipArchive) now have type annotations. Additionally, FilePath is now generic, describing its mode, so you can annotate variables as FilePath[str] or FilePath[bytes] depending on the types that you wish to get back from the 'path' attribute and related methods like 'basename'. (#11822)
• When using CPython, functions wrapped by twisted.internet.defer.inlineCallbacks can have their arguments and return values freed immediately after completion (due to there no longer being circular references). (#11885)

Bugfixes

• Fix TypeError on t.i.cfreactor due to 3.10 type annotation syntax (#11965)
• Fix the type annotations of DeferredLock.run, DeferredSemaphore.run, maybeDeferred, ensureDeferred, inlineCallbacks and fromCoroutine that used to return Deferred[Any] to return the result of the passed Coroutine/Coroutine function (#11985)
• Fixed significant performance overhead (CPU and bandwidth) when doing small writes to a TLS transport. Specifically, small writes to a TLS transport are now buffered until the next reactor iteration. (#11989)
• fix mypy due to hypothesis 6.85 (#11995)

Improved Documentation

• The search and version navigation for the documentation hosted on
  Read The Docs was fixed.
  This was a regression introduced with 23.8.0. (#12012)

Deprecations and Removals

• Drop support for Python 3.7. Remove twisted[contextvars] extra (contextvars are always available in Python 3.7+) (#11913)

Misc

• #5206, #11583, #11787, #11871, #11912, #11921, #11922, #11926, #11932, #11934, #11936, #11938, #11940, #11942, #11945, #11948, #11952, #11953, #11955, #11957, #11959, #11961, #11964, #11973, #11977, #11980, #11982, #11993, #11999, #12004, #12005, #12009

Conch

No significant changes.

Web

Bugfixes

- In Twisted 16.3.0, we changed twisted.web to stop dispatching HTTP/1.1
  pipelined requests to application code.  There was a bug in this change which
  still allowed clients which could send multiple full HTTP requests in a single
  TCP segment to trigger asynchronous processing of later requests, which could
  lead to out-of-order responses.  This has now been corrected and twisted.web
  should never process a pipelined request over HTTP/1.1 until the previous
  request has fully completed. (CVE-2023-46137, GHSA-cq7q-gv5w-rwx2) (#11976)


Deprecations and Removals

• twisted.dom.microdom and twisted.web.domhelpers are now deprecated. (#3651)

Mail

No significant changes.

Words

No significant changes.

Names

No significant changes.

Trial

Misc

- #10115

Twisted 23.10.0.rc1

Twisted 23.10.0.rc1 (2023-10-24)

Features

• twisted.python.filepath.FilePath and related classes (twisted.python.filepath.IFilepath, twisted.python.filepath.AbstractFilePath, twisted.python.zippath.ZipPath, and twisted.python.zippath.ZipArchive) now have type annotations. Additionally, FilePath is now generic, describing its mode, so you can annotate variables as FilePath[str] or FilePath[bytes] depending on the types that you wish to get back from the 'path' attribute and related methods like 'basename'. (#11822)
• When using CPython, functions wrapped by twisted.internet.defer.inlineCallbacks can have their arguments and return values freed immediately after completion (due to there no longer being circular references). (#11885)

Bugfixes

• Fix TypeError on t.i.cfreactor due to 3.10 type annotation syntax (#11965)
• Fix the type annotations of DeferredLock.run, DeferredSemaphore.run, maybeDeferred, ensureDeferred, inlineCallbacks and fromCoroutine that used to return Deferred[Any] to return the result of the passed Coroutine/Coroutine function (#11985)
• Fixed significant performance overhead (CPU and bandwidth) when doing small writes to a TLS transport. Specifically, small writes to a TLS transport are now buffered until the next reactor iteration. (#11989)
• fix mypy due to hypothesis 6.85 (#11995)

Improved Documentation

• The search and version navigation for the documentation hosted on
  Read The Docs was fixed.
  This was a regression introduced with 23.8.0. (#12012)

Deprecations and Removals

• Drop support for Python 3.7. Remove twisted[contextvars] extra (contextvars are always available in Python 3.7+) (#11913)

Misc

• #5206, #11583, #11787, #11871, #11912, #11921, #11922, #11926, #11932, #11934, #11936, #11938, #11940, #11942, #11945, #11948, #11952, #11953, #11955, #11957, #11959, #11961, #11964, #11973, #11977, #11980, #11982, #11993, #11999, #12004, #12005, #12009

Conch

No significant changes.

Web

Bugfixes

- In Twisted 16.3.0, we changed twisted.web to stop dispatching HTTP/1.1
  pipelined requests to application code.  There was a bug in this change which
  still allowed clients which could send multiple full HTTP requests in a single
  TCP segment to trigger asynchronous processing of later requests, which could
  lead to out-of-order responses.  This has now been corrected and twisted.web
  should never process a pipelined request over HTTP/1.1 until the previous
  request has fully completed. (#11976)


Deprecations and Removals

• twisted.dom.microdom and twisted.web.domhelpers are now deprecated. (#3651)

Mail

No significant changes.

Words

No significant changes.

Names

No significant changes.

Trial

Misc

- #10115

Twisted 23.8.0

Twisted 23.8.0. (2023-08-28)

This is the last release with support for Python 3.7.

No changes since 23.8.0.rc1.

Features

• reactor.spawnProcess() now uses posix_spawnp when possible, making it much more efficient (#5710)
• Twisted now officially supports Python 3.11. (#10343)
• twisted.internet.defer.Deferred.fromFuture now has a more precise type annotation. (#11753)
• twisted.internet.defer._ConcurrencyPrimitive.aexit now has a more precise type annotation. (#11795)
• twisted.internet.defer.race has been added as a way to get the first available result from a list of Deferreds. (#11817)
• The CI suite was updated to execute the tests using a Python 3.12 pre-release (#11857)

Bugfixes

• twisted.conch.scripts.ckeygen now substitutes a default of "~/.ssh/id_rsa" if no keyfile is specified. (#6607)
• Correct type hints for IHostnameResolver.resolveHostName and IResolverSimple.getHostByName. (#10276)
• twist conch --auth=sshkey can now authenticate users without a traceback again, thanks to twisted.conch.unix.UnixConchUser no longer being incorrectly instantiated with bytes. In the course of this fix, some type hinting has also been applied to twisted.cred.portal. (#11626)
• twisted.internet.gireactor now works with Gtk4, and is tested and supported in CI again. (#11705)
• When interrupted with control-C, trial -j no longer obscures tracebacks for
  any errors caused by that interruption with an UnboundLocalError due to a bug
  in its own implementation. Note that there are still several internal
  tracebacks that will be emitted upon exiting, because tearing down the test
  runner mid-suite is still not an entirely clean operation, but it should at
  least be possible to see errors reported from, for example, a test that is
  hanging more clearly. (#11707)
• PortableGIReactor and PortableGtkReactor are no longer necessary and are now aliases of GIReactor and Gtk2Reactor respectively, improving the performance of any applications using them. (#11738)
• The Twisted package dependencies were updated to minimum versions that
  will work with latest Twisted codebase. (#11740)
• Deferred's type annotations have been made more comprehensive, precise, correct, and strict. You may notice new type errors in your applications; be sure to check on those because they may represent real type errors! (#11772)
• To prevent parsing errors and ensure validity when serializing HTML comments, twisted.web.template.flattenString has been updated to escape the --> sequence within comments. (#11804)
• BadZipfile (with a small f) has been deprecated since Python 3.2,
  use BadZipFile (big F) instead, added in 3.2. (#11821)
• twisted.web.template now avoids unnecessary copying and is faster, particularly for templates with deep nesting. (#11834)
• twisted.web.template now avoids some unecessary evaluation of type annotations and is faster. (#11835)
• utcfromtimestamp has been deprecated since Python 3.12,
  use fromtimestamp(x, timezone.utc).replace(tzinfo=None) instead. (#11908)

Deprecations and Removals

• Optional dependency "extras" names like conch_nacl now use hyphens rather than underscores to comply with PEP 685. The old names will be supported until the end of 2023. (#11655)
• twisted.internet.gtk2reactor, twisted.internet.gtk3reactor, and twisted.internet.glib2reactor are now deprecated in favor of twisted.internet.gireactor. (#11705)
• The minimum supported version of PyPy has been updated to 3.9. (#11836)

Misc

• #10149, #10310, #10345, #11708, #11723, #11742, #11746, #11748, #11751, #11764, #11766, #11768, #11776, #11788, #11799, #11806, #11824, #11828, #11830, #11856, #11859, #11877, #11894

Conch

Deprecations and Removals

- PyAsn1 has been removed as a conch dependency.

  twisted.conch.ssh.keys.Key no longer supports loading "alternate" OpenSSH private keys.
  These are some private keys that at some point were handled by OpenSSH but for which no specification exists.
  For more info about these OpenSSH keys see https://github.com/twisted/twisted/issues/3008. (#11843)
- Due to changes in the way raw private key byte serialization are handled in Cryptography, and widespread support for Ed25519 in current versions of OpenSSL, we no longer support PyNaCl as a fallback for Ed25519 keys in Conch. (#11871)


Web
---

Misc
~~~~

- #11815, #11879


Mail
----

No significant changes.


Words
-----

No significant changes.


Names
-----

No significant changes.


Trial
-----

No significant changes.

Twisted 23.8.0rc1

Twisted 23.8.0.rc1 (2023-08-17)

This is the last release with support for Python 3.7.

Features

• reactor.spawnProcess() now uses posix_spawnp when possible, making it much more efficient (#5710)
• Twisted now officially supports Python 3.11. (#10343)
• twisted.internet.defer.Deferred.fromFuture now has a more precise type annotation. (#11753)
• twisted.internet.defer._ConcurrencyPrimitive.__aexit__ now has a more precise type annotation. (#11795)
• twisted.internet.defer.race has been added as a way to get the first available result from a list of Deferreds. (#11817)
• The CI suite was updated to execute the tests using a Python 3.12 pre-release (#11857)

Bugfixes

• twisted.conch.scripts.ckeygen now substitutes a default of "~/.ssh/id_rsa" if no keyfile is specified. (#6607)
• Correct type hints for IHostnameResolver.resolveHostName and IResolverSimple.getHostByName. (#10276)
• twist conch --auth=sshkey can now authenticate users without a traceback again, thanks to twisted.conch.unix.UnixConchUser no longer being incorrectly instantiated with bytes. In the course of this fix, some type hinting has also been applied to twisted.cred.portal. (#11626)
• twisted.internet.gireactor now works with Gtk4, and is tested and supported in CI again. (#11705)
• When interrupted with control-C, trial -j no longer obscures tracebacks for
  any errors caused by that interruption with an UnboundLocalError due to a bug
  in its own implementation. Note that there are still several internal
  tracebacks that will be emitted upon exiting, because tearing down the test
  runner mid-suite is still not an entirely clean operation, but it should at
  least be possible to see errors reported from, for example, a test that is
  hanging more clearly. (#11707)
• PortableGIReactor and PortableGtkReactor are no longer necessary and are now aliases of GIReactor and Gtk2Reactor respectively, improving the performance of any applications using them. (#11738)
• The Twisted package dependencies were updated to minimum versions that
  will work with latest Twisted codebase. (#11740)
• Deferred's type annotations have been made more comprehensive, precise, correct, and strict. You may notice new type errors in your applications; be sure to check on those because they may represent real type errors! (#11772)
• To prevent parsing errors and ensure validity when serializing HTML comments, twisted.web.template.flattenString has been updated to escape the --> sequence within comments. (#11804)
• BadZipfile (with a small f) has been deprecated since Python 3.2,
  use BadZipFile (big F) instead, added in 3.2. (#11821)
• twisted.web.template now avoids unnecessary copying and is faster, particularly for templates with deep nesting. (#11834)
• twisted.web.template now avoids some unecessary evaluation of type annotations and is faster. (#11835)
• utcfromtimestamp has been deprecated since Python 3.12,
  use fromtimestamp(x, timezone.utc).replace(tzinfo=None) instead. (#11908)

Deprecations and Removals

• Optional dependency "extras" names like conch_nacl now use hyphens rather than underscores to comply with PEP 685. The old names will be supported until the end of 2023. (#11655)
• twisted.internet.gtk2reactor, twisted.internet.gtk3reactor, and twisted.internet.glib2reactor are now deprecated in favor of twisted.internet.gireactor. (#11705)
• The minimum supported version of PyPy has been updated to 3.9. (#11836)

Misc

• #10149, #10310, #10345, #11708, #11723, #11742, #11746, #11748, #11751, #11764, #11766, #11768, #11776, #11788, #11799, #11806, #11824, #11828, #11830, #11856, #11859, #11877, #11894

Conch

Deprecations and Removals

- PyAsn1 has been removed as a conch dependency.

  twisted.conch.ssh.keys.Key no longer supports loading "alternate" OpenSSH private keys.
  These are some private keys that at some point were handled by OpenSSH but for which no specification exists.
  For more info about these OpenSSH keys see https://github.com/twisted/twisted/issues/3008. (#11843)
- Due to changes in the way raw private key byte serialization are handled in Cryptography, and widespread support for Ed25519 in current versions of OpenSSL, we no longer support PyNaCl as a fallback for Ed25519 keys in Conch. (#11871)


Web
---

Misc
~~~~

- #11815, #11879


Mail
----

No significant changes.


Words
-----

No significant changes.


Names
-----

No significant changes.


Trial
-----

No significant changes.

Twisted 22.10.0

Twisted 22.10.0 (2022-10-30)

This release contains a security fix for CVE-2022-39348.
This is a low-severity security bug.

Twisted 22.10.0rc1 release candidate was released on 2022-10-26 and there are
no changes between the release candidate and the final release.

Features

• The systemd: endpoint parser now supports "named" file descriptors. This is a more reliable mechanism for choosing among several inherited descriptors. (#8147)

Improved Documentation

• The systemd endpoint parser's index parameter is now documented as leading to non-deterministic results in which descriptor is selected. The new name parameter is now documented as preferred. (#8146)
• The implementers of Zope interfaces are once more displayed in the documentations. (#11690)

Deprecations and Removals

• twisted.protocols.dict, which was deprecated in 17.9, has been removed. (#11725)

Misc

• #11573, #11599, #11616, #11628, #11631, #11640, #11645, #11647, #11652, #11664, #11674, #11679, #11686, #11692, #11694, #11696, #11700, #11702, #11713, #11715, #11721

Conch

Bugfixes

- twisted.conch.manhole.ManholeInterpreter now captures tracebacks even if sys.excepthook has been modified. (#11638)


Web
---

Features

• The twisted.web.pages.errorPage, notFound, and forbidden each return an IResource that displays an HTML error pages safely rendered using twisted.web.template. (#11716)

Bugfixes

- twisted.web.error.Error.__str__ no longer raises an exception when the error's message attribute is None. Additionally, it validates that code is a plausible 3-digit HTTP status code. (#10271)
- The typing of the twisted.web.http_headers.Headers methods addRawHeader() and setRawHeaders() now allow mixing str and bytes, matching the runtime behavior. (#11635)
- twisted.web.vhost.NameVirtualHost no longer echoes HTML received in the Host header without escaping it (CVE-2022-39348, GHSA-vg46-2rrj-3647). (#11716)


Deprecations and Removals

• twisted.web.resource.Resource.putChild now raises TypeError when the path argument is not bytes, rather than issuing a deprecation warning. (#8985)
• The twisted.web.resource.ErrorPage, NoResource, and ForbiddenResource classes have been deprecated in favor of new implementations twisted.web.pages module because they permit HTML injection. (#11716)

Mail

Bugfixes

- emailserver.tac now runs under python3.x (#11634)


Words
-----

No significant changes.


Names
-----

No significant changes.


Trial
-----

Features

• twisted.trial.unittest.SynchronousTestCase.successResultOf is now annotated as accepting coroutines. (#11657)

Bugfixes

- The implementation of ``trial -jN ...`` now handles test errors and failures larger than 64 kB.  It also handles other internal communication errors by logging them in the worker and attempting to send them to the parent process -- instead of crashing with ``UnknownRemoteError`` and no additional details. (#10314)
- `trial -jN --logfile path` no longer hangs if *path* contains a directory separator. (#11580)


Misc
~~~~

- #11649, #11661, #11677, #11710

Twisted 22.10.0rc1

Twisted 22.10.0.rc1 (2022-10-26)

Features

• The systemd: endpoint parser now supports "named" file descriptors. This is a more reliable mechanism for choosing among several inherited descriptors. (#8147)

Bugfixes

• test.yaml workflow permissions restricted. (#11631)

Improved Documentation

• The systemd endpoint parser's index parameter is now documented as leading to non-deterministic results in which descriptor is selected. The new name parameter is now documented as preferred. (#8146)
• The implementers of Zope interfaces are once more displayed in the documentations. (#11690)

Deprecations and Removals

• twisted.protocol.dict, which was deprecated in 17.9, was now removed. (#11725)

Misc

• #11573, #11599, #11616, #11628, #11640, #11645, #11647, #11652, #11664, #11674, #11679, #11686, #11692, #11694, #11696, #11700, #11702, #11713, #11715, #11721

Conch

Bugfixes

• twisted.conch.manhole.ManholeInterpreter now captures tracebacks even if sys.excepthook has been modified. (#11638)

Web

Features

• The twisted.web.pages.errorPage, notFound, and forbidden each return an IResource that displays an HTML error pages safely rendered using twisted.web.template. (#11716)

Bugfixes

• twisted.web.error.Error.str no longer raises an exception when the error's message attribute is None. Additionally, it validates that code is a plausible 3-digit HTTP status code. (#10271)
• The typing of the twisted.web.http_headers.Headers methods addRawHeader() and setRawHeaders() now allow mixing str and bytes, matching the runtime behavior. (#11635)
• twisted.web.vhost.NameVirtualHost no longer echoes HTML received in the Host header without escaping it (CVE-2022-39348, GHSA-vg46-2rrj-3647). (#11716)

Deprecations and Removals

• twisted.web.resource.Resource.putChild now raises TypeError when the path argument is not bytes, rather than issuing a deprecation warning. (#8985)
• The twisted.web.resource.ErrorPage, NoResource, and ForbiddenResource classes have been deprecated in favor of new implementations twisted.web.pages module because they permit HTML injection. (#11716)

Mail

Bugfixes

• emailserver.tac now runs under python3.x (#11634)

Words

No significant changes.

Names

No significant changes.

Trial

Features

• twisted.trial.unittest.SynchronousTestCase.successResultOf is now annotated as accepting coroutines. (#11657)

Bugfixes

• The implementation of trial -jN ... now handles test errors and failures larger than 64 kB. It also handles other internal communication errors by logging them in the worker and attempting to send them to the parent process -- instead of crashing with UnknownRemoteError and no additional details. (#10314)
• trial -jN --logfile path no longer hangs if path contains a directory separator. (#11580)

Misc

• #11649, #11661, #11677, #11710

Twisted 22.8.0

Twisted 22.8.0 (2022-09-06)

Twisted 22.8.0rc1 release candidate was released on 2022-08-28 and there are
no changes between the release candidate and the final release.

Features

• twisted.internet.defer.maybeDeferred will now schedule a coroutine result as asynchronous operation and return a Deferred that fires with the result of the coroutine. (#10327)
• Twisted now works with Cryptography versions 37 and above, and as a result, its minimum TLS protocol version has been upgraded to TLSv1.2. (#10377)

Bugfixes

• twisted.internet.base.DelayedCall.__repr__ will no longer raise AttributeError if the DelayedCall was created before debug mode was enabled. As a side-effect, twisted.internet.base.DelayedCall.creator is now defined as None in cases where previously it was undefined. (#8306)
• twisted.internet.iocpreactor.udp now properly re-queues its listener when there is a failure condition on the read from the socket. (#10052)
• twisted.internet.defer.inlineCallbacks no longer causes confusing StopIteration tracebacks to be added to the top of tracebacks originating in triggered callbacks (#10260)
• The typing of twisted.internet.task.react no longer constrains the type of argv. (#10289)
• ContextVar.reset() now works correctly inside inlineCallbacks functions and coroutines. (#10301)
• Implement twisted.python.failure._Code.co_positions for compatibility with Python 3.11. (#10336)
• twisted.pair.tuntap._TUNSETIFF and ._TUNGETIFF values are now correct parisc, powerpc and sparc architectures. (#10339)

Improved Documentation

• The release process documentation was updated to include information about
  doing a security release. (#10324)
• The development and policy documentation pages were moved into the same
  directory that is now placed inside the documentation root directory. (#11575)

Deprecations and Removals

• Python 3.6 is no longer supported.
  Twisted 22.4.0 was the last version with support for Python 3.6. (#10304)

Misc

• #9437, #9495, #10066, #10275, #10318, #10325, #10328, #10329, #10331, #10349, #10350, #10352, #10353, #11561, #11564, #11567, #11569, #11585, #11592, #11600, #11606, #11610, #11612, #11614

Conch

Bugfixes

- twisted.conch.checkers.UNIXAuthorizedKeysFiles now uses the filesystem encoding to decode usernames before looking them up in the password database, so it works on Python 3. (#10286)
- twisted.conch.ssh.SSHSession.request_env no longer gives a warning if the session does not implement ISessionSetEnv. (#10347)
- The cftp command line (and `twisted.conch.scripts.cftp.SSHSession.extReceived`) no longer raises an unhandled error when receiving data on stderr from the server. (#10351)


Misc
~~~~

- #10330


Web
---

Features

• twisted.web.template.renderElement now combines consecutive, sychronously-available bytes up to a fixed size limit into a single string to pass to IRequest.write instead of passing them all separately. This greatly reduces the number of chunks in the response. (#10348)

Misc

- #11604


Mail
----

Bugfixes

• twisted.mail.maildir.MaildirMessage now use byte header to avoid incompatibility with the FileMessage which writes bytes not strings lines to a message file (#10244)

Words

Bugfixes

- twisted.words.protocols.irc.IRCClient now splits overly long NOTICEs and NOTICEs containing \n before sending. (#10285)


Names
-----

Bugfixes

• twisted.names.dns logs unparsable messages rather than generating a Failure instance (#9723)

Trial

Features

- ``trial --jobs=N --exitfirst`` is now supported. (#9654)


Bugfixes

• trial --jobs=N --until-failure ... now reports the correct number of tests run after each iteration. (#10311)
• trial -jN ... will now pass errors and failures to IReporter methods as instances of WorkerException instead of str. (#10333)

Misc

- #10319, #10338, #11571

Twisted 22.8.0rc1

Twisted 22.8.0.rc1 (2022-08-28)

Features

• twisted.internet.defer.maybeDeferred will now schedule a coroutine result as asynchronous operation and return a Deferred that fires with the result of the coroutine. (#10327)
• Twisted now works with Cryptography versions 37 and above, and as a result its minimum TLS protocol version has been upgraded to TLSv1.2. (#10377)

Bugfixes

• twisted.internet.base.DelayedCall.__repr__ will no longer raise AttributeError if the DelayedCall was created before debug mode was enabled. As a side-effect, twisted.internet.base.DelayedCall.creator is now defined as None in cases where previously it was undefined. (#8306)
• twisted.internet.iocpreactor.udp now properly re-queues its listener when there is a failure condition on the read from the socket. (#10052)
• twisted.internet.defer.inlineCallbacks no longer causes confusing StopIteration tracebacks to be added to the top of tracebacks originating in triggered callbacks (#10260)
• The typing of twisted.internet.task.react no longer constrains the type of argv. (#10289)
• ContextVar.reset() now works correctly inside inlineCallbacks functions and coroutines. (#10301)
• Implement twisted.python.failure._Code.co_positions for compatibility with Python 3.11. (#10336)
• twisted.pair.tuntap._TUNSETIFF and ._TUNGETIFF values are now correct parisc, powerpc and sparc architectures. (#10339)

Improved Documentation

• The release process documentation was updated to include information about
  doing a security release. (#10324)
• The development and policy documentation pages were moved into the same
  directory that is now placed inside the documentation root directory. (#11575)

Deprecations and Removals

• Python 3.6 is no longer supported.
  Twisted 22.4.0 was the last version with support for Python 3.6. (#10304)

Misc

• #9437, #9495, #10066, #10275, #10318, #10325, #10328, #10329, #10331, #10349, #10350, #10352, #10353, #11561, #11564, #11567, #11569, #11585, #11592, #11600, #11606, #11610, #11612, #11614

Conch

Bugfixes

- twisted.conch.checkers.UNIXAuthorizedKeysFiles now uses the filesystem encoding to decode usernames before looking them up in the password database, so it works on Python 3. (#10286)
- twisted.conch.ssh.SSHSession.request_env no longer gives a warning if the session does not implement ISessionSetEnv. (#10347)
- The cftp command line (and `twisted.conch.scripts.cftp.SSHSession.extReceived`) no longer raises an unhandled error when receiving data on stderr from the server. (#10351)


Misc
~~~~

- #10330


Web
---

Features

• twisted.web.template.renderElement now combines consecutive, sychronously-available bytes up to a fixed size limit into a single string to pass to IRequest.write instead of passing them all separately. This greatly reduces the number of chunks in the response. (#10348)

Misc

- #11604


Mail
----

Bugfixes

• twisted.mail.maildir.MaildirMessage now use byte header to avoid incompatibility with the FileMessage which writes bytes not strings lines to a message file (#10244)

Words

Bugfixes

- twisted.words.protocols.irc.IRCClient now splits overly long NOTICEs and NOTICEs containing \n before sending. (#10285)


Names
-----

Bugfixes

• twisted.names.dns logs unparsable messages rather than generating a Failure instance (#9723)

Trial

Features

- ``trial --jobs=N --exitfirst`` is now supported. (#9654)


Bugfixes

• trial --jobs=N --until-failure ... now reports the correct number of tests run after each iteration. (#10311)
• trial -jN ... will now pass errors and failures to IReporter methods as instances of WorkerException instead of str. (#10333)

Misc

- #0, #10319, #10338, #11571