Merge branch 'master' into fix-view-attr

NeloBlivion · web-flow · commit c4f55143b0af · 2025-12-02T08:37:43.000-05:00
Signed-off-by: Nelo &lt;41271523+NeloBlivion@users.noreply.github.com&gt;
diff --git a/.flake8 b/.flake8
@@ -1,5 +1,5 @@
 [flake8]
-min_python_version = 3.9
+min_python_version = 3.10
 
 # Incompatible with black see https://github.com/ambv/black/issues/315
 ignore =
diff --git a/.github/workflows/codeql.yml b/.github/workflows/codeql.yml
@@ -26,7 +26,7 @@ jobs:
         language: ["python"]
     steps:
       - name: "Checkout repository"
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
       - name: "Initialize CodeQL"
         uses: github/codeql-action/init@v4
         with:
diff --git a/.github/workflows/docs-checks.yml b/.github/workflows/docs-checks.yml
@@ -36,7 +36,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: "Checkout Repository"
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
       - name: "Setup Python"
         uses: actions/setup-python@v6
         with:
diff --git a/.github/workflows/docs-json-export.yml b/.github/workflows/docs-json-export.yml
@@ -13,7 +13,7 @@ jobs:
     steps:
       - name: Checkout repository
         id: checkout
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
       - name: Set up Python
         uses: actions/setup-python@v6
         id: setup-python
@@ -35,7 +35,7 @@ jobs:
         id: generate-json
         run: python scripts/docs_json_exporter.py
       - name: Upload docs.json as artifact
-        uses: actions/upload-artifact@v4.6.2
+        uses: actions/upload-artifact@v5.0.0
         id: artifact-upload
         with:
           name: Pycord Docs JSON
diff --git a/.github/workflows/docs-localization-download.yml b/.github/workflows/docs-localization-download.yml
@@ -15,7 +15,7 @@ jobs:
       pr_id: ${{ steps.convert_outputs.outputs.pr_id }}
     steps:
       - name: "Checkout Repository"
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
         with:
           fetch-tags: true
       - name: "Install Python"
@@ -74,7 +74,7 @@ jobs:
     environment: translations
     steps:
       - name: "Checkout Repository"
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
       - name: "Refresh Pull"
         run: |
           git fetch --all
diff --git a/.github/workflows/docs-localization-upload.yml b/.github/workflows/docs-localization-upload.yml
@@ -20,7 +20,7 @@ jobs:
     environment: translations
     steps:
       - name: "Checkout Repository"
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
         with:
           fetch-tags: true
       - name: "Install Python"
diff --git a/.github/workflows/lib-checks.yml b/.github/workflows/lib-checks.yml
@@ -32,7 +32,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: "Checkout Repository"
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
       - name: "Setup Python"
         uses: actions/setup-python@v6
         with:
@@ -52,7 +52,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: "Checkout Repository"
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
       - name: "Setup Python"
         uses: actions/setup-python@v6
         with:
@@ -70,7 +70,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: "Checkout Repository"
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
       - name: "Setup Python"
         uses: actions/setup-python@v6
         with:
@@ -94,7 +94,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: "Checkout Repository"
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
       - name: "Setup Python"
         uses: actions/setup-python@v6
         with:
@@ -120,18 +120,14 @@ jobs:
     strategy:
       matrix:
         os: [ubuntu-latest, macos-latest, windows-latest]
-        python-version: ["3.9", "3.10", "3.11", "3.12", "3.13"]
-        exclude:
-          - { python-version: "3.9", os: "macos-latest" }
-        include:
-          - { python-version: "3.9", os: "macos-13" }
+        python-version: ["3.10", "3.11", "3.12", "3.13"]
     runs-on: ${{ matrix.os }}
     env:
       OS: ${{ matrix.os }}
       PYTHON: ${{ matrix.python-version }}
     steps:
       - name: "Checkout Repository"
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
       - name: "Setup Python"
         uses: actions/setup-python@v6
         with:
diff --git a/.github/workflows/readthedocs-localization.yml b/.github/workflows/readthedocs-localization.yml
diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
@@ -31,7 +31,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: "Checkout Repository"
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
         with:
           fetch-depth: 0
           fetch-tags: true
@@ -108,7 +108,7 @@ jobs:
       GITHUB_TOKEN: ${{ secrets.ADMIN_GITHUB_TOKEN }}
     steps:
       - name: "Checkout Repository"
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
         with:
           fetch-depth: 0
           fetch-tags: true
@@ -202,7 +202,7 @@ jobs:
           python3 -m build --sdist
           python3 -m build --wheel
       - name: "Create GitHub Release"
-        uses: softprops/action-gh-release@v2.4.1
+        uses: softprops/action-gh-release@v2.4.2
         id: gh-release
         with:
           tag_name: "v${{ inputs.version }}"
@@ -330,7 +330,7 @@ jobs:
       GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
     steps:
       - name: "Checkout Repository"
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
         with:
           fetch-depth: 0
           fetch-tags: true
diff --git a/.github/workflows/todo-checks.yml b/.github/workflows/todo-checks.yml
@@ -21,7 +21,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: "Checkout Repository"
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
       - name: "Track TODO Action"
         uses: ribtoks/tdg-github-action@v0.4.15-beta
         with:
diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
@@ -21,7 +21,7 @@ repos:
   #          - --remove-duplicate-keys
   #          - --remove-unused-variables
   - repo: https://github.com/asottile/pyupgrade
-    rev: v3.21.0
+    rev: v3.21.2
     hooks:
       - id: pyupgrade
         exclude: \.(po|pot|yml|yaml)$
@@ -31,7 +31,7 @@ repos:
       - id: isort
         exclude: \.(po|pot|yml|yaml)$
   - repo: https://github.com/psf/black-pre-commit-mirror
-    rev: 25.9.0
+    rev: 25.11.0
     hooks:
       - id: black
         args: [--safe, --quiet]
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -10,14 +10,22 @@ possible (see our [Version Guarantees] for more info).
 
 These changes are available on the `master` branch, but have not yet been released.
 
+⚠️ **This version removes support for Python 3.9.** ⚠️
+
 ### Added
 
+- Added `Attachment.read_chunked` and added optional `chunksize` argument to
+  `Attachment.save` for retrieving attachments in chunks.
+  ([#2956](https://github.com/Pycord-Development/pycord/pull/2956))
+
 ### Changed
 
 ### Fixed
 
 - Fixed the `view` attribute on many view items being incorrect.
   ([#2981](https://github.com/Pycord-Development/pycord/pull/2981))
+- Fixed breaking change in `ui.Select` Generic typing by adding default values to
+  TypeVars. ([#3002](https://github.com/Pycord-Development/pycord/pull/3002))
 
 ### Deprecated
 
@@ -26,6 +34,9 @@ These changes are available on the `master` branch, but have not yet been releas
 
 ### Removed
 
+- ⚠️ **Removed support for Python 3.9.**
+  ([#2986](https://github.com/Pycord-Development/pycord/pull/2986))
+
 ## [2.7.0rc2] - 2025-10-22
 
 ### Added
diff --git a/README.rst b/README.rst
@@ -32,7 +32,7 @@ Pycord is a modern, easy to use, feature-rich, and async ready API wrapper for D
 Note
 ----
 
-Pycord supports Python ``3.9`` - ``3.13``
+Pycord supports Python ``3.10`` - ``3.13``
 
 Key Features
 ------------
@@ -45,7 +45,7 @@ Key Features
 Installing
 ----------
 
-**Python 3.9 or higher is required**
+**Python 3.10 or higher is required**
 
 To install the library without full voice support, run the following command:
 
diff --git a/discord/http.py b/discord/http.py
@@ -29,7 +29,15 @@
 import logging
 import sys
 import weakref
-from typing import TYPE_CHECKING, Any, Coroutine, Iterable, Sequence, TypeVar
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    AsyncGenerator,
+    Coroutine,
+    Iterable,
+    Sequence,
+    TypeVar,
+)
 from urllib.parse import quote as _uriquote
 
 import aiohttp
@@ -406,6 +414,21 @@ async def get_from_cdn(self, url: str) -> bytes:
             else:
                 raise HTTPException(resp, "failed to get asset")
 
+    async def stream_from_cdn(self, url: str, chunksize: int) -> AsyncGenerator[bytes]:
+        if not isinstance(chunksize, int) or chunksize < 1:
+            raise InvalidArgument("The chunksize must be a positive integer.")
+
+        async with self.__session.get(url) as resp:
+            if resp.status == 200:
+                async for chunk in resp.content.iter_chunked(chunksize):
+                    yield chunk
+            elif resp.status == 404:
+                raise NotFound(resp, "asset not found")
+            elif resp.status == 403:
+                raise Forbidden(resp, "cannot retrieve asset")
+            else:
+                raise HTTPException(resp, "failed to get asset")
+
     # state management
 
     async def close(self) -> None:
diff --git a/discord/message.py b/discord/message.py
@@ -32,6 +32,7 @@
 from typing import (
     TYPE_CHECKING,
     Any,
+    AsyncGenerator,
     Callable,
     ClassVar,
     Sequence,
@@ -290,6 +291,7 @@ async def save(
         *,
         seek_begin: bool = True,
         use_cached: bool = False,
+        chunksize: int | None = None,
     ) -> int:
         """|coro|
 
@@ -311,6 +313,8 @@ async def save(
             after the message is deleted. Note that this can still fail to download
             deleted attachments if too much time has passed, and it does not work
             on some types of attachments.
+        chunksize: Optional[:class:`int`]
+            The maximum size of each chunk to process.
 
         Returns
         -------
@@ -323,16 +327,33 @@ async def save(
             Saving the attachment failed.
         NotFound
             The attachment was deleted.
+        InvalidArgument
+            Argument `chunksize` is less than 1.
         """
-        data = await self.read(use_cached=use_cached)
+        if chunksize is not None:
+            data = self.read_chunked(use_cached=use_cached, chunksize=chunksize)
+        else:
+            data = await self.read(use_cached=use_cached)
+
         if isinstance(fp, io.BufferedIOBase):
-            written = fp.write(data)
+            if chunksize:
+                written = 0
+                async for chunk in data:
+                    written += fp.write(chunk)
+            else:
+                written = fp.write(data)
             if seek_begin:
                 fp.seek(0)
             return written
         else:
             with open(fp, "wb") as f:
-                return f.write(data)
+                if chunksize:
+                    written = 0
+                    async for chunk in data:
+                        written += f.write(chunk)
+                    return written
+                else:
+                    return f.write(data)
 
     async def read(self, *, use_cached: bool = False) -> bytes:
         """|coro|
@@ -369,6 +390,45 @@ async def read(self, *, use_cached: bool = False) -> bytes:
         data = await self._http.get_from_cdn(url)
         return data
 
+    async def read_chunked(
+        self, chunksize: int, *, use_cached: bool = False
+    ) -> AsyncGenerator[bytes]:
+        """|coro|
+
+        Retrieves the content of this attachment in chunks as a :class:`AsyncGenerator` object of bytes.
+
+        Parameters
+        ----------
+        chunksize: :class:`int`
+            The maximum size of each chunk to process.
+        use_cached: :class:`bool`
+            Whether to use :attr:`proxy_url` rather than :attr:`url` when downloading
+            the attachment. This will allow attachments to be saved after deletion
+            more often, compared to the regular URL which is generally deleted right
+            after the message is deleted. Note that this can still fail to download
+            deleted attachments if too much time has passed, and it does not work
+            on some types of attachments.
+
+        Yields
+        ------
+        :class:`bytes`
+            A chunk of the file.
+
+        Raises
+        ------
+        HTTPException
+            Downloading the attachment failed.
+        Forbidden
+            You do not have permissions to access this attachment
+        NotFound
+            The attachment was deleted.
+        InvalidArgument
+            Argument `chunksize` is less than 1.
+        """
+        url = self.proxy_url if use_cached else self.url
+        async for chunk in self._http.stream_from_cdn(url, chunksize):
+            yield chunk
+
     async def to_file(self, *, use_cached: bool = False, spoiler: bool = False) -> File:
         """|coro|
 
diff --git a/discord/permissions.py b/discord/permissions.py
@@ -684,7 +684,7 @@ def pin_messages(self) -> int:
     def bypass_slowmode(self) -> int:
         """:class:`bool`: Returns ``True`` if a user can bypass slowmode.
 
-        .. versionadded:: tbd
+        .. versionadded:: 2.7
         """
         return 1 << 52
 
diff --git a/discord/ui/select.py b/discord/ui/select.py
diff --git a/docs/installing.rst b/docs/installing.rst
diff --git a/pyproject.toml b/pyproject.toml
diff --git a/requirements/dev.txt b/requirements/dev.txt
diff --git a/requirements/docs.txt b/requirements/docs.txt
diff --git a/requirements/speed.txt b/requirements/speed.txt
