Merge remote-tracking branch 'origin/trunk' into no-more-setup-py

Author: glyph

.github/workflows/ci.yaml

@@ -8,15 +8,15 @@ on:
 
 jobs:
   lint:
-    runs-on: ubuntu-20.04
+    runs-on: ubuntu-24.04
     timeout-minutes: 5
 
     steps:
     - uses: actions/checkout@v4
 
     - uses: actions/setup-python@v5
       with:
-        python-version: '3.12'
+        python-version: "3.12"
 
     - uses: actions/cache@v4
       with:
@@ -34,7 +34,7 @@ jobs:
         TOX_PARALLEL_NO_SPINNER: 1
 
   docs:
-    runs-on: ubuntu-20.04
+    runs-on: ubuntu-24.04
     timeout-minutes: 5
 
     steps:
@@ -60,7 +60,7 @@ jobs:
 
   test:
     name: "Test ${{ matrix.python-version }} with ${{ matrix.twisted-version }} Twisted"
-    runs-on: ubuntu-20.04
+    runs-on: ubuntu-22.04
     timeout-minutes: 10
     continue-on-error: ${{ matrix.experimental }}
     strategy:
@@ -81,6 +81,10 @@ jobs:
             twisted-version: "latest"
             experimental: false
 
+          - python-version: "3.13-dev"
+            twisted-version: "latest"
+            experimental: true
+
           - python-version: "pypy-3.10"
             twisted-version: "latest"
             experimental: false
@@ -116,6 +120,7 @@ jobs:
           "3.10": "py310",
           "3.11": "py311",
           "3.12": "py312",
+          "3.13-dev": "py313",
           "pypy-3.8": "pypy3",
           "pypy-3.9": "pypy3",
           "pypy-3.10": "pypy3",

.github/workflows/release.yaml

@@ -0,0 +1,54 @@
+name: Release
+
+on:
+  push:
+    tags: [ "treq-*" ]
+  pull_request:
+    branches: [ trunk ]
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    runs-on: ubuntu-24.04
+
+    steps:
+    - uses: actions/checkout@v4
+
+    - uses: actions/setup-python@v5
+      with:
+        python-version: '3.12'
+
+    - run: pip install build twine
+
+    - run: python3 -m build
+
+    - run: twine check dist/*.*
+
+    - uses: actions/upload-artifact@v4
+      with:
+        name: dist
+        path: dist/*.*
+        if-no-files-found: error
+
+  pypi-publish:
+    runs-on: ubuntu-24.04
+    if: startsWith(github.ref, 'refs/tags/treq-')
+    needs: [build]
+
+    environment:
+      name: PyPI.org
+      url: https://pypi.org/project/treq
+
+    permissions:
+      id-token: write
+
+    steps:
+
+    - uses: actions/download-artifact@v4
+      with:
+        name: dist
+        path: dist/
+
+    - uses: pypa/gh-action-pypi-publish@release/v1

CHANGELOG.rst

@@ -8,6 +8,37 @@ Changelog
 
 .. towncrier release notes start
 
+24.9.0 (2024-09-17)
+===================
+
+Features
+--------
+
+- treq now ships type annotations. (`#366 <https://github.com/twisted/treq/issues/366>`__)
+- The new :mod:`treq.cookies` module provides helper functions for working with `http.cookiejar.Cookie` and `CookieJar` objects. (`#384 <https://github.com/twisted/treq/issues/384>`__)
+- Python 3.13 is now supported. (`#391 <https://github.com/twisted/treq/issues/391>`__)
+
+
+Bugfixes
+--------
+
+- :mod:`treq.content.text_content()` no longer generates deprecation warnings due to use of the ``cgi`` module. (`#355 <https://github.com/twisted/treq/issues/355>`__)
+
+
+Deprecations and Removals
+-------------------------
+
+- Mixing the *json* argument with *files* or *data* now raises `TypeError`. (`#297 <https://github.com/twisted/treq/issues/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 <https://github.com/twisted/treq/issues/302>`__)
+- Support for Python 3.7 and PyPy 3.8, which have reached end of support, has been dropped. (`#378 <https://github.com/twisted/treq/issues/378>`__)
+
+
+Misc
+----
+
+- `#336 <https://github.com/twisted/treq/issues/336>`__, `#382 <https://github.com/twisted/treq/issues/382>`__, `#395 <https://github.com/twisted/treq/issues/395>`__
+
+
 23.11.0 (2023-11-03)
 ====================
 

changelog.d/297.removal.rst

@@ -92,27 +92,6 @@ The ``auth`` argument should be a tuple of the form ``('username', 'password')``
 
 Full example: :download:`basic_auth.py <examples/basic_auth.py>`
 
-HTTP Digest authentication is supported by passing an instance of
-:py:class:`treq.auth.HTTPDigestAuth` to any of the request functions by using the `auth` keyword argument.
-We support only "auth" QoP as defined at `RFC 2617`_
-or simple `RFC 2069`_ without QoP at the moment. Treq takes care of
-caching HTTP digest credentials — after authorizing any URL/method pair,
-the library will use the initially received HTTP digest credentials on that endpoint
-for subsequent requests, and will not perform any redundant requests to obtain the
-credentials.
-
-:py:class:`treq.auth.HTTPDigestAuth` class accepts ``username`` and ``password``
-as constructor arguments.
-
-.. literalinclude:: examples/digest_auth.py
-    :linenos:
-    :lines: 5-14
-
-Full example: :download:`digest_auth.py <examples/digest_auth.py>`
-
-.. _RFC 2617: http://www.ietf.org/rfc/rfc2617.txt
-.. _RFC 2069: http://www.ietf.org/rfc/rfc2069.txt
-
 Redirects
 ---------
 

changelog.d/302.removal.rst

@@ -71,7 +71,7 @@ Here is a list of `requests`_ features and their status in treq.
 +----------------------------------+----------+----------+
 | Basic Authentication             | yes      | yes      |
 +----------------------------------+----------+----------+
-| Digest Authentication            | yes      | yes      |
+| Digest Authentication            | yes      | no       |
 +----------------------------------+----------+----------+
 | Elegant Key/Value Cookies        | yes      | yes      |
 +----------------------------------+----------+----------+

changelog.d/336.misc.rst

@@ -48,6 +48,7 @@ classifiers = [
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
     "Programming Language :: Python :: Implementation :: CPython",
     "Programming Language :: Python :: Implementation :: PyPy",
 ]

changelog.d/355.bugfix.rst

@@ -3,9 +3,9 @@
 """
 
 # This file is auto-generated! Do not edit!
-# Use `python -m incremental.update treq` to change this file.
+# Use `incremental` to change this file.
 
 from incremental import Version
 
-__version__ = Version("treq", 23, 11, 0)
+__version__ = Version("treq", 24, 9, 0)
 __all__ = ["__version__"]