tilebox-grpc 0.38.0__py3-none-any.whl → 0.40.0__py3-none-any.whl

_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.38.0.dist-info → tilebox_grpc-0.40.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tilebox-grpc
-Version: 0.38.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.38.0.dist-info → tilebox_grpc-0.40.0.dist-info}/RECORD

@@ -1,6 +1,6 @@
 _tilebox/grpc/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 _tilebox/grpc/channel.py,sha256=e0Dyn1GqgJScHcwMfNKwfLa1VPalHp_B3li3IEoKmoc,6342
-_tilebox/grpc/error.py,sha256=QVfLuvitYLlhWENE98zdb4m9gx0PGMsR6m1_prwkwj4,3598
+_tilebox/grpc/error.py,sha256=HpxvGgYRCGejjZTPIKBc552-EzM-JuHQUDe1cjmmUyo,5102
 _tilebox/grpc/pagination.py,sha256=-KhkhQ_0IE-BgzjNAmkPac7fH55ZGICstaqRhCLvHGE,1292
 _tilebox/grpc/producer_consumer.py,sha256=NG6gUCcvYOGbplV1Vq9bFro-4cNpTHvT7eL4zlNDkkA,2154
 _tilebox/grpc/replay.py,sha256=_NC76BfmvazNrJI5MovSnPTC7kYwWZn3Au_0yPlOLsc,6006
@@ -10,6 +10,6 @@ _tilebox/grpc/aio/error.py,sha256=Lkf20vuQn9XaLj0MlQ1uqHRaenhYJ_P3rggNZyDMML8,12
 _tilebox/grpc/aio/pagination.py,sha256=6v95yqgC-m87kD96pjfpIsmY41YuxxR0Se1o3NTrkSs,1115
 _tilebox/grpc/aio/producer_consumer.py,sha256=aOZhZHD74GZEvfeZ9OzUsVk5uUIuuMQp1V7l3Y1PQ0w,2679
 _tilebox/grpc/aio/syncify.py,sha256=jhScVqEwsoNP6gLwJpnIIaBqMC3q4XqSkEfIPokYG8c,4035
-tilebox_grpc-0.38.0.dist-info/METADATA,sha256=MFYrj7b-FLd_pL1KR5c2rSQoMmh9LQoF0hNiNIYezOg,2955
-tilebox_grpc-0.38.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-tilebox_grpc-0.38.0.dist-info/RECORD,,
+tilebox_grpc-0.40.0.dist-info/METADATA,sha256=a92tXc0gegZBvP-TpOM99eaaq1ajFuNgh6l_2jCN33I,2955
+tilebox_grpc-0.40.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+tilebox_grpc-0.40.0.dist-info/RECORD,,