feldera 0.29.0__py3-none-any.whl → 0.31.0__py3-none-any.whl

feldera/enums.py

@@ -175,6 +175,12 @@ class PipelineStatus(Enum):
     `PipelineStatus.SHUTDOWN` state.
     """
 
+    UNAVAILABLE = 9
+    """
+    The pipeline was at least once initialized, but in the most recent status check either
+    could not be reached or returned it is not yet ready.
+    """
+
     @staticmethod
     def from_str(value):
         for member in PipelineStatus:

feldera/pipeline.py

@@ -233,10 +233,13 @@ class Pipeline:
         status = self.status()
         if status != PipelineStatus.SHUTDOWN:
             raise RuntimeError(
-                f"pipeline {self.name} in state: {str(status.name)} cannot be started"
+                f"pipeline {self.name} in state {str(status.name)} cannot be started\n"
+                + self.client.get_pipeline(self.name).deployment_error.get(
+                    "message", ""
+                )
             )
 
-        self.pause()
+        self.client.pause_pipeline(self.name, "Unable to START the pipeline.")
         self.__setup_output_listeners()
         self.resume()
 

feldera/rest/feldera_client.py

@@ -200,35 +200,49 @@ class FelderaClient:
         )
 
         while True:
-            status = self.get_pipeline(pipeline_name).deployment_status
+            resp = self.get_pipeline(pipeline_name)
+            status = resp.deployment_status
 
             if status == "Running":
                 break
             elif status == "Failed":
-                raise RuntimeError("Failed to start pipeline")
+                raise RuntimeError(
+                    f"""Unable to START the pipeline.
+Reason: The pipeline is in a FAILED state due to the following error:
+{resp.deployment_error.get("message", "")}"""
+                )
 
             logging.debug(
                 "still starting %s, waiting for 100 more milliseconds", pipeline_name
             )
             time.sleep(0.1)
 
-    def pause_pipeline(self, pipeline_name: str):
+    def pause_pipeline(self, pipeline_name: str, error_message: str = None):
         """
         Stop a pipeline
 
         :param pipeline_name: The name of the pipeline to stop
+        :param error_message: The error message to show if the pipeline is in FAILED state
         """
         self.http.post(
             path=f"/pipelines/{pipeline_name}/pause",
         )
 
+        if error_message is None:
+            error_message = "Unable to PAUSE the pipeline.\n"
+
         while True:
-            status = self.get_pipeline(pipeline_name).deployment_status
+            resp = self.get_pipeline(pipeline_name)
+            status = resp.deployment_status
 
             if status == "Paused":
                 break
             elif status == "Failed":
-                raise RuntimeError("Failed to pause pipeline")
+                raise RuntimeError(
+                    error_message
+                    + f"""Reason: The pipeline is in a FAILED state due to the following error:
+{resp.deployment_error.get("message", "")}"""
+                )
 
             logging.debug(
                 "still pausing %s, waiting for 100 more milliseconds", pipeline_name
@@ -286,6 +300,17 @@ class FelderaClient:
 
         raise RuntimeError(f"Failed to shutdown pipeline {pipeline_name}")
 
+    def checkpoint_pipeline(self, pipeline_name: str):
+        """
+        Checkpoint a fault-tolerant pipeline
+
+        :param pipeline_name: The name of the pipeline to checkpoint
+        """
+
+        self.http.post(
+            path=f"/pipelines/{pipeline_name}/checkpoint",
+        )
+
     def push_to_pipeline(
         self,
         pipeline_name: str,

{feldera-0.29.0.dist-info → feldera-0.31.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: feldera
-Version: 0.29.0
+Version: 0.31.0
 Summary: The feldera python client
 Author-email: Abhinav <abhinav.gyawali@feldera.com>
 License: MIT

{feldera-0.29.0.dist-info → feldera-0.31.0.dist-info}/RECORD

@@ -1,20 +1,20 @@
 feldera/__init__.py,sha256=PxkgCtEAuFwo4u8NGEDio-bF3M-GnbeV45tAQVoBbqE,297
 feldera/_callback_runner.py,sha256=Tdf6BXN4zppyoy8t_y-Ooa3B0wEfvyezMHU9jxY2ZhA,4713
 feldera/_helpers.py,sha256=TuaJPQdAnRV9K5bG7-DCAr45b2JxsZyrwkZBJf1806M,2684
-feldera/enums.py,sha256=ZPQa-RE2G2qb9YsDSQOOyo87yisQ0SsOv7yyFh9cGzU,6061
+feldera/enums.py,sha256=pdidN0KsYDruQRIDusdcklVsx2NW9sMXYfo9-kUqtak,6247
 feldera/output_handler.py,sha256=64J3ljhOaKIhxdjOKYi-BUz_HnMwROfmN8eE-btYygU,1930
-feldera/pipeline.py,sha256=jwgpF4zNwNU0ca7TluFfALq19Z495LuM9tTujapuG_A,15940
+feldera/pipeline.py,sha256=-ReBWeDGed-o9V0uG5RKk21RtD_TBaehomrBiMape4E,16127
 feldera/pipeline_builder.py,sha256=FzpoBlMGPmN76uxLQ768ISI6f3N5jkGriune8jZMkJA,3688
 feldera/runtime_config.py,sha256=PfYXsrLrs5Duty-7x3dGDf2uvp5hwp3Yb5n3bRQtLVk,2898
 feldera/rest/__init__.py,sha256=Eg-EKUU3RSTDcdxTR_7wNDnCly8VpXEzsZCQUmf-y2M,308
 feldera/rest/_httprequests.py,sha256=y3RxFn4BCTKbUztO1LN2CWXgGA93dIIV5VLdyiWQWuQ,6181
 feldera/rest/config.py,sha256=84Lj2QX6SYNZJdBfrCHPMh29Nj4MY7nRB-uddytx_ok,795
 feldera/rest/errors.py,sha256=b4i2JjrbSmej7jdko_FL8UeXklLKenSipwMT80jowaM,1720
-feldera/rest/feldera_client.py,sha256=wQLcRDo0thPx90_9T2vNzMEhx_gixwwLLIjkSEhnP9w,16629
+feldera/rest/feldera_client.py,sha256=SEG6DLlyZjzckRIx7Dd0hCOYoIb2h8nWJuXy6i6wdKU,17534
 feldera/rest/pipeline.py,sha256=W5Oo_bwVduae-alF3g69RyDwQcuSUsWh-rL6cfvvunQ,2786
 feldera/rest/sql_table.py,sha256=qrw-YwMzx5T81zDefNO1KOx7EyypFz1vPwGBzSUB7kc,652
 feldera/rest/sql_view.py,sha256=hN12mPM0mvwLCIPYywpb12s9Hd2Ws31IlTMXPriMisw,644
-feldera-0.29.0.dist-info/METADATA,sha256=iBu_kQP7PNHDaXrhPH9MDj1eXXTnytqhPAUX6l9E3sY,2582
-feldera-0.29.0.dist-info/WHEEL,sha256=P9jw-gEje8ByB7_hXoICnHtVCrEwMQh-630tKvQWehc,91
-feldera-0.29.0.dist-info/top_level.txt,sha256=fB6yTqrQiO6RCbY1xP2T_mpPoTjDFtJvkJJodiee7d0,8
-feldera-0.29.0.dist-info/RECORD,,
+feldera-0.31.0.dist-info/METADATA,sha256=nlmQAlxhdaXPyLh5dY3LNrsvCmI0ZgmVHd6pgmn0VuM,2582
+feldera-0.31.0.dist-info/WHEEL,sha256=PZUExdf71Ui_so67QXpySuHtCi3-J3wvF4ORK6k_S8U,91
+feldera-0.31.0.dist-info/top_level.txt,sha256=fB6yTqrQiO6RCbY1xP2T_mpPoTjDFtJvkJJodiee7d0,8
+feldera-0.31.0.dist-info/RECORD,,

{feldera-0.29.0.dist-info → feldera-0.31.0.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (75.3.0)
+Generator: setuptools (75.6.0)
 Root-Is-Purelib: true
 Tag: py3-none-any