♻️ move SequenceProxy to private module

Author: Paillat-dev

discord/client.py

@@ -64,6 +64,7 @@
 from .ui.view import View
 from .user import ClientUser, User
 from .utils import MISSING
+from .utils.private import SequenceProxy
 from .voice_client import VoiceClient
 from .webhook import Webhook
 from .widget import Widget
@@ -385,7 +386,7 @@ def cached_messages(self) -> Sequence[Message]:
 
         .. versionadded:: 1.1
         """
-        return utils.SequenceProxy(self._connection._messages or [])
+        return SequenceProxy(self._connection._messages or [])
 
     @property
     def private_channels(self) -> list[PrivateChannel]:

discord/utils/__init__.py

@@ -25,7 +25,6 @@
 
 from __future__ import annotations
 
-import collections.abc
 import json
 from typing import (
     TYPE_CHECKING,
@@ -36,7 +35,6 @@
     Iterator,
     Mapping,
     Protocol,
-    Sequence,
     TypeVar,
     Union,
     overload,
@@ -172,34 +170,6 @@ def decorator(func: Callable[[T], T_co]) -> CachedSlotProperty[T, T_co]:
     return decorator
 
 
-class SequenceProxy(Generic[T_co], collections.abc.Sequence):
-    """Read-only proxy of a Sequence."""
-
-    def __init__(self, proxied: Sequence[T_co]):
-        self.__proxied = proxied
-
-    def __getitem__(self, idx: int) -> T_co:
-        return self.__proxied[idx]
-
-    def __len__(self) -> int:
-        return len(self.__proxied)
-
-    def __contains__(self, item: Any) -> bool:
-        return item in self.__proxied
-
-    def __iter__(self) -> Iterator[T_co]:
-        return iter(self.__proxied)
-
-    def __reversed__(self) -> Iterator[T_co]:
-        return reversed(self.__proxied)
-
-    def index(self, value: Any, *args, **kwargs) -> int:
-        return self.__proxied.index(value, *args, **kwargs)
-
-    def count(self, value: Any) -> int:
-        return self.__proxied.count(value)
-
-
 async def get_or_fetch(obj, attr: str, id: int, *, default: Any = MISSING) -> Any:
     """|coro|
 

discord/utils/private.py

@@ -2,6 +2,7 @@
 
 import array
 import asyncio
+import collections.abc
 import datetime
 import functools
 import re
@@ -26,8 +27,12 @@
     Coroutine,
     Awaitable,
     reveal_type,
+    Generic,
+    Sequence,
+    Iterator,
 )
 
+from . import T_co
 from ..errors import InvalidArgument, HTTPException
 
 if TYPE_CHECKING:
@@ -456,3 +461,31 @@ def decorator(overridden: T) -> T:
         return overridden
 
     return decorator
+
+
+class SequenceProxy(collections.abc.Sequence, Generic[T_co]):
+    """Read-only proxy of a Sequence."""
+
+    def __init__(self, proxied: Sequence[T_co]):
+        self.__proxied = proxied
+
+    def __getitem__(self, idx: int) -> T_co:
+        return self.__proxied[idx]
+
+    def __len__(self) -> int:
+        return len(self.__proxied)
+
+    def __contains__(self, item: Any) -> bool:
+        return item in self.__proxied
+
+    def __iter__(self) -> Iterator[T_co]:
+        return iter(self.__proxied)
+
+    def __reversed__(self) -> Iterator[T_co]:
+        return reversed(self.__proxied)
+
+    def index(self, value: Any, *args, **kwargs) -> int:
+        return self.__proxied.index(value, *args, **kwargs)
+
+    def count(self, value: Any) -> int:
+        return self.__proxied.count(value)