Replace public usages of functools.wraps

trio/_path.py

@@ -320,6 +320,7 @@ def open(
     ) -> _AsyncIOWrapper[IO[Any]]:
         ...
 
+    # TODO: check the following is AOK with pyright
     @wraps(pathlib.Path.open)  # type: ignore[misc]  # Overload return mismatch.
     async def open(self, *args: Any, **kwargs: Any) -> _AsyncIOWrapper[IO[Any]]:
         """Open the file pointed to by the path, like the :func:`trio.open_file`

trio/_socket.py

@@ -4,7 +4,6 @@
 import select
 import socket as _stdlib_socket
 import sys
-from functools import wraps as _wraps
 from operator import index
 from socket import AddressFamily, SocketKind
 from typing import (
@@ -37,9 +36,17 @@
 
     P = ParamSpec("P")
 
-
 T = TypeVar("T")
 
+# work around a pyright error
+if TYPE_CHECKING:
+    Fn = TypeVar("Fn", bound=Callable[..., object])
+    def _wraps(f: Fn) -> Fn:
+        ...
+
+else:
+    from functools import wraps as _wraps
+
 # must use old-style typing because it's evaluated at runtime
 Address: TypeAlias = Union[
     str, bytes, Tuple[str, int], Tuple[str, int, int], Tuple[str, int, int, int]