Changelog

25.5.0 (2025-05-31)

Features

  • treq is packaged with Hatchling, and consequently no longer directly depends on setuptools. (#388)

Improved Documentation

  • Update documentation to use async/await syntax (#409)

Deprecations and Removals

  • Support for Python 3.8, which has reached end of support, is deprecated. This is the last release with support for Python 3.8. (#407)

24.9.1 (2024-09-19)

Bugfixes

  • treq has vendored its dependency on the multipart library to avoid import conflicts with python-multipart; it should now be installable alongside that library. (#399)

24.9.0 (2024-09-17)

Features

  • treq now ships type annotations. (#366)

  • The new treq.cookies module provides helper functions for working with http.cookiejar.Cookie and CookieJar objects. (#384)

  • Python 3.13 is now supported. (#391)

Bugfixes

  • treq.content.text_content() no longer generates deprecation warnings due to use of the cgi module. (#355)

Deprecations and Removals

  • Mixing the json argument with files or data now raises TypeError. (#297)

  • Passing non-string (str or bytes) values as part of a dict to the headers argument now results in a TypeError, as does passing any collection other than a dict or Headers instance. (#302)

  • Support for Python 3.7 and PyPy 3.8, which have reached end of support, has been dropped. (#378)

Misc

23.11.0 (2023-11-03)

Features

  • When the collector passed to treq.collect(response, collector) throws an exception, that error will now be returned to the caller of collect() via the result Deferred, and the underlying HTTP transport will be closed. (#347)

  • Python 3.11 is now supported. (#364)

  • Python 3.12 is now supported. (#375)

  • PyPy 3.9 is now supported. (#365)

  • PyPy 3.10 is now supported. (#374)

Deprecations and Removals

  • The minimum supported Twisted version has increased to 22.10.0. Older versions are no longer tested in CI. (#374)

  • Support for Python 3.6, which has reached end of support, has been dropped. (#363)

  • Support for Python 3.7, which reaches end of support 2023-06-27, is deprecated. This is the last release with support for Python 3.7. (#361)

  • Support for PyPy 3.7, which has reached end of support, has been removed. (#365)

  • Support for PyPy 3.8, which has reached end of support, is deprecated. This is the last release with support for PyPy 3.8. (#374)

Misc

22.2.0 (2022-02-08)

Features

  • Python 3.10 and PyPy 3.8 are now supported. (#338)

Bugfixes

  • Address a regression introduced in Treq 22.1.0 that prevented transmission of cookies with requests to ports other than 80, including HTTPS (443). (#343)

Deprecations and Removals

  • Support for Python 3.6, which has reached end of support, is deprecated. This is the last release with support for Python 3.6. (#338)

22.1.0 (2022-01-29)

Bugfixes

  • Cookies specified as a dict were sent to every domain, not just the domain of the request, potentially exposing them on redirect. See GHSA-fhpf-pp6p-55qc. (#339, CVE-2022-23607)

21.5.0 (2021-05-24)

Features

  • PEP 517/518 build-system metadata is now provided in pyproject.toml. (#329)

Bugfixes

  • treq.testing.StubTreq now persists twisted.web.server.Session instances between requests. (#327)

Improved Documentation

  • The dependency on Sphinx required to build the documentation has been moved from the dev extra to the new docs extra. (#296)

Deprecations and Removals

  • Support for Python 2.7 and 3.5 has been dropped. treq no longer depends on six or mock. (#318)

21.1.0 (2021-01-14)

Features

  • Support for Python 3.9: treq is now tested with CPython 3.9. (#305)

  • The auth parameter now accepts arbitrary text and bytes for usernames and passwords. Text is encoded as UTF-8, per RFC 7617. Previously only ASCII was allowed. (#268)

  • treq produces a more helpful exception when passed a tuple of the wrong size in the files parameter. (#299)

Bugfixes

  • The params argument once more accepts non-ASCII bytes, fixing a regression first introduced in treq 20.4.1. (#303)

  • treq request APIs no longer mutates a http_headers.Headers passed as the headers parameter when the auth parameter is also passed. (#314)

  • The agent returned by treq.auth.add_auth() and treq.auth.add_basic_auth() is now marked to provide twisted.web.iweb.IAgent. (#312)

  • treq’s package metadata has been updated to require six >= 1.13, noting a dependency introduced in treq 20.9.0. (#295)

Improved Documentation

  • The documentation of the params argument has been updated to more accurately describe its type-coercion behavior. (#281)

  • The treq.auth module has been documented. (#313)

Deprecations and Removals

  • Support for Python 2.7, which has reached end of support, is deprecated. This is the last release with support for Python 2.7. (#309)

  • Support for Python 3.5, which has reached end of support, is deprecated. This is the last release with support for Python 3.5. (#306)

  • Deprecate tolerance of non-string values when passing headers as a dict. They have historically been silently dropped, but will raise TypeError in the next treq release. Also deprecate passing headers other than dict, Headers, or None. Historically falsy values like [] or () were accepted. (#294)

  • treq request functions and methods like treq.get() and HTTPClient.post() now issue a DeprecationWarning when passed unknown keyword arguments, rather than ignoring them. Mixing the json argument with files or data is also deprecated. These warnings will change to a TypeError in the next treq release. (#297)

  • The minimum supported Twisted version has increased to 18.7.0. Older versions are no longer tested in CI. (#307)

20.9.0 (2020-09-27)

Features

  • The url parameter of HTTPClient.request() (and shortcuts like get()) now accept hyperlink.DecodedURL and hyperlink.URL in addition to str and bytes. (#212)

  • Compatibility with the upcoming Twisted 20.9.0 release (#290).

Improved Documentation

  • An example of sending and receiving JSON has been added. (#278)

20.4.1 (2020-04-16)

Bugfixes

  • Correct a typo in the treq 20.4.0 package metadata that prevented upload to PyPI (pypa/twine#589)

20.4.0 (2020-04-16)

Features

  • Support for Python 3.8 and PyPy3: treq is now tested with these interpreters. (#271)

Bugfixes

  • treq.client.HTTPClient.request() and its aliases no longer raise UnicodeEncodeError when passed a Unicode url and non-empty params. Now the URL and query parameters are concatenated as documented. (#264)

  • In treq 20.3.0 the params argument didn’t accept parameter names or values that contain the characters & or #. Now these characters are properly escaped. (#282)

Improved Documentation

  • The treq documentation has been revised to emphasize use of treq.client.HTTPClient over the module-level convenience functions in the treq module. (#276)

20.3.0 (2020-03-15)

Features

  • Python 3.7 support. (#228)

Bugfixes

  • treq.testing.RequestTraversalAgent now passes its memory reactor to the twisted.web.server.Site it creates, preventing the Site from polluting the global reactor. (#225)

  • treq.testing no longer generates deprecation warnings about twisted.test.proto_helpers.MemoryReactor. (#253)

Improved Documentation

  • The download_file.py example has been updated to do a streaming download with unbuffered=True. (#233)

  • The agent parameter to treq.request() has been documented. (#235)

  • The type of the headers element of a response tuple passed to treq.testing.RequestSequence is now correctly documented as str. (#237)

Deprecations and Removals

  • Drop support for Python 3.4. (#240)

Misc