Return normalized file paths from file utility helper

Co-authored-by: Shri Sukhani <shrisukhani@users.noreply.github.com>

Author: cursoragent

hyperbrowser/client/file_utils.py

@@ -1,15 +1,19 @@
 import os
+from os import PathLike
+from typing import Union
 
 from hyperbrowser.exceptions import HyperbrowserError
 
 
 def ensure_existing_file_path(
-    file_path: str,
+    file_path: Union[str, PathLike[str]],
     *,
     missing_file_message: str,
     not_file_message: str,
-) -> None:
-    if not os.path.exists(file_path):
+) -> str:
+    normalized_path = os.fspath(file_path)
+    if not os.path.exists(normalized_path):
         raise HyperbrowserError(missing_file_message)
-    if not os.path.isfile(file_path):
+    if not os.path.isfile(normalized_path):
         raise HyperbrowserError(not_file_message)
+    return normalized_path

hyperbrowser/client/managers/async_manager/session.py

@@ -115,11 +115,11 @@ async def upload_file(
         self, id: str, file_input: Union[str, PathLike[str], IO]
     ) -> UploadFileResponse:
         if isinstance(file_input, (str, PathLike)):
-            file_path = os.fspath(file_input)
-            ensure_existing_file_path(
-                file_path,
-                missing_file_message=f"Upload file not found at path: {file_path}",
-                not_file_message=f"Upload file path must point to a file: {file_path}",
+            raw_file_path = os.fspath(file_input)
+            file_path = ensure_existing_file_path(
+                raw_file_path,
+                missing_file_message=f"Upload file not found at path: {raw_file_path}",
+                not_file_message=f"Upload file path must point to a file: {raw_file_path}",
             )
             try:
                 with open(file_path, "rb") as file_obj:

hyperbrowser/client/managers/sync_manager/session.py

@@ -107,11 +107,11 @@ def upload_file(
         self, id: str, file_input: Union[str, PathLike[str], IO]
     ) -> UploadFileResponse:
         if isinstance(file_input, (str, PathLike)):
-            file_path = os.fspath(file_input)
-            ensure_existing_file_path(
-                file_path,
-                missing_file_message=f"Upload file not found at path: {file_path}",
-                not_file_message=f"Upload file path must point to a file: {file_path}",
+            raw_file_path = os.fspath(file_input)
+            file_path = ensure_existing_file_path(
+                raw_file_path,
+                missing_file_message=f"Upload file not found at path: {raw_file_path}",
+                not_file_message=f"Upload file path must point to a file: {raw_file_path}",
             )
             try:
                 with open(file_path, "rb") as file_obj: