tilebox-grpc 0.39.0__tar.gz → 0.40.0__tar.gz

{tilebox_grpc-0.39.0 → tilebox_grpc-0.40.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tilebox-grpc
-Version: 0.39.0
+Version: 0.40.0
 Summary: GRPC / Protocol Buffers functions for Tilebox
 Project-URL: Homepage, https://tilebox.com
 Project-URL: Documentation, https://docs.tilebox.com/
@@ -20,11 +20,11 @@ Classifier: Topic :: Scientific/Engineering
 Classifier: Topic :: Software Development
 Requires-Python: >=3.10
 Requires-Dist: anyio>=4
-Requires-Dist: grpcio-status>=1.67
-Requires-Dist: grpcio>=1.67
+Requires-Dist: grpcio-status>=1.70
+Requires-Dist: grpcio>=1.70
 Requires-Dist: lz4>=4
 Requires-Dist: nest-asyncio>=1.5.0
-Requires-Dist: protobuf>=5
+Requires-Dist: protobuf>=6
 Description-Content-Type: text/markdown
 
 <h1 align="center">

{tilebox_grpc-0.39.0 → tilebox_grpc-0.40.0}/_tilebox/grpc/error.py

@@ -9,6 +9,14 @@ from grpc import RpcError, StatusCode
 from grpc.aio import AioRpcError
 
 
+class NetworkError(IOError):
+    """NetworkError indicates that a network error occurred while communicating with the server"""
+
+
+class NetworkTimeoutError(NetworkError, TimeoutError):
+    """TimeoutError indicates that a request timed out"""
+
+
 class AuthenticationError(IOError):
     """AuthenticationError indicates that a server request failed due to a missing or invalid authentication token"""
 
@@ -60,20 +68,42 @@ class AnyRpcError(Protocol):
     def details(self) -> str: ...
 
 
-def translate_rpc_error(err: AnyRpcError) -> Exception:
+def translate_rpc_error(err: AnyRpcError) -> BaseException:  # noqa: PLR0911, C901
     # translate specific error codes to more pythonic errors
+
+    # https://grpc.io/docs/guides/error/
     match err.code():
+        case StatusCode.NOT_FOUND:
+            return NotFoundError(err.details())
+        case StatusCode.INVALID_ARGUMENT:
+            return ArgumentError(err.details())
         case StatusCode.UNAUTHENTICATED:
             return AuthenticationError(f"Unauthenticated: {err.details()}")
         case StatusCode.PERMISSION_DENIED:
             return AuthenticationError(f"Unauthorized: {err.details()}")
-        case StatusCode.NOT_FOUND:
-            return NotFoundError(err.details())
         case StatusCode.RESOURCE_EXHAUSTED:
             return SubscriptionLimitExceededError(err.details())
-        case StatusCode.INVALID_ARGUMENT:
-            return ArgumentError(err.details())
-
+        case StatusCode.DEADLINE_EXCEEDED:
+            # Deadline expired before server returned status
+            return NetworkTimeoutError(f"Request timed out: {err.details()}")
+        case StatusCode.UNAVAILABLE:
+            # Server shutting down, or some data transmitted and then the connection broke
+            return NetworkError(err.details())
+        case StatusCode.ABORTED:
+            return NetworkError(f"Request aborted: {err.details()}")
+        case StatusCode.UNKNOWN:
+            # Server threw an exception (or did something other than returning a status code to terminate the RPC)
+            return InternalServerError(f"Oops, something went wrong: {err.details()}")
+        case StatusCode.INTERNAL:
+            return InternalServerError(f"Oops, something went wrong: {err.details()}")
+        case StatusCode.CANCELLED:
+            # Client application cancelled the request
+            return KeyboardInterrupt(f"Request canceled by user: {err.details()}")
+        case StatusCode.UNIMPLEMENTED:
+            # Method not found on server
+            return NotImplementedError(err.details())
+
+    # for all other errors we raise a generic internal server error
     return InternalServerError(f"Oops, something went wrong: {err.details()}")
 
 

{tilebox_grpc-0.39.0 → tilebox_grpc-0.40.0}/pyproject.toml

@@ -24,9 +24,9 @@ dependencies = [
     # our version of the protobuf compiler generates code that requires grpcio 1.63.0 or higher
     # grpcio 1.65.1 contains a bug that produces lots of logging noise: https://github.com/grpc/grpc/issues/37178
     # grpcio 1.66 also has this bug on MacOS still: https://github.com/grpc/grpc/issues/37642
-    "grpcio>=1.67",
-    "grpcio-status>=1.67",
-    "protobuf>=5",
+    "grpcio>=1.70",
+    "grpcio-status>=1.70",
+    "protobuf>=6",
     # for the libraries below we specify a minimum, tested to be working version
     "lz4>=4",
     "anyio>=4",