feldera 0.128.0__tar.gz → 0.130.0__tar.gz

{feldera-0.128.0 → feldera-0.130.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: feldera
-Version: 0.128.0
+Version: 0.130.0
 Summary: The feldera python client
 Author-email: Feldera Team <dev@feldera.com>
 License: MIT
@@ -28,19 +28,19 @@ Feldera Python is the Feldera SDK for Python developers.
 ## Installation
 
 ```bash
-pip install feldera
+uv pip install feldera
 ```
 
 ### Installing from Github
 
 ```bash
-pip install git+https://github.com/feldera/feldera#subdirectory=python
+uv pip install git+https://github.com/feldera/feldera#subdirectory=python
 ```
 
 Similarly, to install from a specific branch:
 
 ```bash
-$ pip install git+https://github.com/feldera/feldera@{BRANCH_NAME}#subdirectory=python
+uv pip install git+https://github.com/feldera/feldera@{BRANCH_NAME}#subdirectory=python
 ```
 
 Replace `{BRANCH_NAME}` with the name of the branch you want to install from.
@@ -51,7 +51,18 @@ If you have cloned the Feldera repo, you can install the python SDK as follows:
 
 ```bash
 # the Feldera Python SDK is present inside the python/ directory
-pip install python/
+cd python
+# If you don't have a virtual environment, create one
+uv venv
+source .venv/activate
+# Install the SDK in editable mode
+uv pip install .
+```
+
+You also have to install the `pytest` module:
+
+```bash
+python3 -m pip install pytest
 ```
 
 ## Documentation
@@ -61,7 +72,7 @@ The Python SDK documentation is available at
 
 To build the html documentation run:
 
-Ensure that you have sphinx installed. If not, install it using `pip install sphinx`.
+Ensure that you have sphinx installed. If not, install it using `uv pip install sphinx`.
 
 Then run the following commands:
 
@@ -92,7 +103,13 @@ To run tests from a specific file:
 (cd python && python3 -m pytest ./tests/path-to-file.py)
 ```
 
-#### Running Tests
+To run a specific test:
+
+```bash
+uv run python -m pytest tests/test_shared_pipeline.py::TestPipeline::test_adhoc_query_hash -v
+```
+
+#### Running All Tests
 
 The tests validate end-to-end correctness of SQL functionality.  To
 run the tests use:

{feldera-0.128.0 → feldera-0.130.0}/README.md

@@ -5,19 +5,19 @@ Feldera Python is the Feldera SDK for Python developers.
 ## Installation
 
 ```bash
-pip install feldera
+uv pip install feldera
 ```
 
 ### Installing from Github
 
 ```bash
-pip install git+https://github.com/feldera/feldera#subdirectory=python
+uv pip install git+https://github.com/feldera/feldera#subdirectory=python
 ```
 
 Similarly, to install from a specific branch:
 
 ```bash
-$ pip install git+https://github.com/feldera/feldera@{BRANCH_NAME}#subdirectory=python
+uv pip install git+https://github.com/feldera/feldera@{BRANCH_NAME}#subdirectory=python
 ```
 
 Replace `{BRANCH_NAME}` with the name of the branch you want to install from.
@@ -28,7 +28,18 @@ If you have cloned the Feldera repo, you can install the python SDK as follows:
 
 ```bash
 # the Feldera Python SDK is present inside the python/ directory
-pip install python/
+cd python
+# If you don't have a virtual environment, create one
+uv venv
+source .venv/activate
+# Install the SDK in editable mode
+uv pip install .
+```
+
+You also have to install the `pytest` module:
+
+```bash
+python3 -m pip install pytest
 ```
 
 ## Documentation
@@ -38,7 +49,7 @@ The Python SDK documentation is available at
 
 To build the html documentation run:
 
-Ensure that you have sphinx installed. If not, install it using `pip install sphinx`.
+Ensure that you have sphinx installed. If not, install it using `uv pip install sphinx`.
 
 Then run the following commands:
 
@@ -69,7 +80,13 @@ To run tests from a specific file:
 (cd python && python3 -m pytest ./tests/path-to-file.py)
 ```
 
-#### Running Tests
+To run a specific test:
+
+```bash
+uv run python -m pytest tests/test_shared_pipeline.py::TestPipeline::test_adhoc_query_hash -v
+```
+
+#### Running All Tests
 
 The tests validate end-to-end correctness of SQL functionality.  To
 run the tests use:

{feldera-0.128.0 → feldera-0.130.0}/feldera/pipeline.py

@@ -809,6 +809,25 @@ pipeline '{self.name}' to sync checkpoint '{uuid}'"""
 
         return self.client.query_as_text(self.name, query)
 
+    def query_hash(self, query: str):
+        """
+        Executes an ad-hoc SQL query on this pipeline and returns the result
+        as a hash of the result set. This is useful for quickly checking
+        if the result set has changed without retrieving the entire result.
+
+        Note:
+            For a stable hash, the query must be deterministic which means
+            it should be sorted.
+
+        :param query: The SQL query to be executed.
+
+        :raises FelderaAPIError: If the pipeline is not in a RUNNING or PAUSED
+            state.
+        :raises FelderaAPIError: If querying a non materialized table or view.
+        :raises FelderaAPIError: If the query is invalid.
+        """
+        return self.client.query_as_hash(self.name, query)
+
     def execute(self, query: str):
         """
         Executes an ad-hoc SQL query on the current pipeline, discarding its

{feldera-0.128.0 → feldera-0.130.0}/feldera/rest/_httprequests.py

@@ -57,6 +57,7 @@ class HttpRequests:
         self.headers["Content-Type"] = content_type
 
         try:
+            conn_timeout = self.config.connection_timeout
             timeout = self.config.timeout
             headers = self.headers
 
@@ -74,7 +75,7 @@ class HttpRequests:
                 if http_method.__name__ == "get":
                     request = http_method(
                         request_path,
-                        timeout=timeout,
+                        timeout=(conn_timeout, timeout),
                         headers=headers,
                         params=params,
                         stream=stream,
@@ -83,7 +84,7 @@ class HttpRequests:
                 elif isinstance(body, bytes):
                     request = http_method(
                         request_path,
-                        timeout=timeout,
+                        timeout=(conn_timeout, timeout),
                         headers=headers,
                         data=body,
                         params=params,
@@ -93,7 +94,7 @@ class HttpRequests:
                 else:
                     request = http_method(
                         request_path,
-                        timeout=timeout,
+                        timeout=(conn_timeout, timeout),
                         headers=headers,
                         data=json_serialize(body) if serialize else body,
                         params=params,
@@ -118,9 +119,18 @@ class HttpRequests:
                             time.sleep(2)  # backoff, adjust as needed
                             continue
                     raise  # re-raise for all other errors or if out of retries
+                except requests.exceptions.Timeout as err:
+                    if attempt < max_retries:
+                        logging.warning(
+                            "HTTP Connection Timeout for %s, retrying (%d/%d)...",
+                            path,
+                            attempt + 1,
+                            max_retries,
+                        )
+                        time.sleep(2)
+                        continue
+                    raise FelderaTimeoutError(str(err)) from err
 
-        except requests.exceptions.Timeout as err:
-            raise FelderaTimeoutError(str(err)) from err
         except requests.exceptions.ConnectionError as err:
             raise FelderaCommunicationError(str(err)) from err
 

{feldera-0.128.0 → feldera-0.130.0}/feldera/rest/config.py

@@ -12,6 +12,7 @@ class Config:
         api_key: Optional[str] = None,
         version: Optional[str] = None,
         timeout: Optional[float] = None,
+        connection_timeout: Optional[float] = None,
         requests_verify: bool = True,
     ) -> None:
         """
@@ -19,6 +20,7 @@ class Config:
         :param api_key: The optional API key to access Feldera
         :param version: The version of the API to use
         :param timeout: The timeout for the HTTP requests
+        :param connection_timeout: The connection timeout for the HTTP requests
         :param requests_verify: The `verify` parameter passed to the requests
             library. `True` by default.
         """
@@ -27,4 +29,5 @@ class Config:
         self.api_key: Optional[str] = api_key
         self.version: Optional[str] = version or "v0"
         self.timeout: Optional[float] = timeout
+        self.connection_timeout: Optional[float] = connection_timeout
         self.requests_verify: bool = requests_verify

{feldera-0.128.0 → feldera-0.130.0}/feldera/rest/feldera_client.py

@@ -46,20 +46,26 @@ class FelderaClient:
         url: str,
         api_key: Optional[str] = None,
         timeout: Optional[float] = None,
+        connection_timeout: Optional[float] = None,
         requests_verify: bool = True,
     ) -> None:
         """
         :param url: The url to Feldera API (ex: https://try.feldera.com)
         :param api_key: The optional API key for Feldera
-        :param timeout: (optional) The amount of time in seconds that the client
-            will wait for a response before timing
-            out.
+        :param timeout: (optional) The amount of time in seconds that the
+            client will wait for a response before timing out.
+        :param connection_timeout: (optional) The amount of time in seconds that
+            the client will wait to establish connection before timing out.
         :param requests_verify: The `verify` parameter passed to the requests
             library. `True` by default.
         """
 
         self.config = Config(
-            url, api_key, timeout=timeout, requests_verify=requests_verify
+            url,
+            api_key,
+            timeout=timeout,
+            connection_timeout=connection_timeout,
+            requests_verify=requests_verify,
         )
         self.http = HttpRequests(self.config)
 
@@ -895,6 +901,27 @@ Reason: The pipeline is in a STOPPED state due to the following error:
             if chunk:
                 yield chunk.decode("utf-8")
 
+    def query_as_hash(self, pipeline_name: str, query: str) -> str:
+        """
+        Executes an ad-hoc query on the specified pipeline and returns a hash of the result.
+
+        :param pipeline_name: The name of the pipeline to query.
+        :param query: The SQL query to be executed.
+        :return: A string containing the hash of the query result.
+        """
+        params = {
+            "pipeline_name": pipeline_name,
+            "sql": query,
+            "format": "hash",
+        }
+
+        resp = self.http.get(
+            path=f"/pipelines/{pipeline_name}/query",
+            params=params,
+            stream=False,
+        )
+        return resp
+
     def query_as_parquet(self, pipeline_name: str, query: str, path: str):
         """
         Executes an ad-hoc query on the specified pipeline and saves the result to a parquet file.

{feldera-0.128.0 → feldera-0.130.0}/feldera/stats.py

@@ -26,8 +26,8 @@ class PipelineStatistics:
         pipeline.inputs = [
             InputEndpointStatus.from_dict(input) for input in d["inputs"]
         ]
-        pipeline.inputs = [
-            OutputEndpointStatus().from_dict(output) for output in d["outputs"]
+        pipeline.outputs = [
+            OutputEndpointStatus.from_dict(output) for output in d["outputs"]
         ]
         return pipeline
 
@@ -46,7 +46,7 @@ class GlobalPipelineMetrics:
         self.rss_bytes: Optional[int] = None
         self.cpu_msecs: Optional[int] = None
         self.start_time: Optional[datetime] = None
-        self.incarnation_uuid: Optional[uuid] = None
+        self.incarnation_uuid: Optional[uuid.UUID] = None
         self.storage_bytes: Optional[int] = None
         self.storage_mb_secs: Optional[int] = None
         self.runtime_elapsed_msecs: Optional[int] = None

{feldera-0.128.0 → feldera-0.130.0}/feldera.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: feldera
-Version: 0.128.0
+Version: 0.130.0
 Summary: The feldera python client
 Author-email: Feldera Team <dev@feldera.com>
 License: MIT
@@ -28,19 +28,19 @@ Feldera Python is the Feldera SDK for Python developers.
 ## Installation
 
 ```bash
-pip install feldera
+uv pip install feldera
 ```
 
 ### Installing from Github
 
 ```bash
-pip install git+https://github.com/feldera/feldera#subdirectory=python
+uv pip install git+https://github.com/feldera/feldera#subdirectory=python
 ```
 
 Similarly, to install from a specific branch:
 
 ```bash
-$ pip install git+https://github.com/feldera/feldera@{BRANCH_NAME}#subdirectory=python
+uv pip install git+https://github.com/feldera/feldera@{BRANCH_NAME}#subdirectory=python
 ```
 
 Replace `{BRANCH_NAME}` with the name of the branch you want to install from.
@@ -51,7 +51,18 @@ If you have cloned the Feldera repo, you can install the python SDK as follows:
 
 ```bash
 # the Feldera Python SDK is present inside the python/ directory
-pip install python/
+cd python
+# If you don't have a virtual environment, create one
+uv venv
+source .venv/activate
+# Install the SDK in editable mode
+uv pip install .
+```
+
+You also have to install the `pytest` module:
+
+```bash
+python3 -m pip install pytest
 ```
 
 ## Documentation
@@ -61,7 +72,7 @@ The Python SDK documentation is available at
 
 To build the html documentation run:
 
-Ensure that you have sphinx installed. If not, install it using `pip install sphinx`.
+Ensure that you have sphinx installed. If not, install it using `uv pip install sphinx`.
 
 Then run the following commands:
 
@@ -92,7 +103,13 @@ To run tests from a specific file:
 (cd python && python3 -m pytest ./tests/path-to-file.py)
 ```
 
-#### Running Tests
+To run a specific test:
+
+```bash
+uv run python -m pytest tests/test_shared_pipeline.py::TestPipeline::test_adhoc_query_hash -v
+```
+
+#### Running All Tests
 
 The tests validate end-to-end correctness of SQL functionality.  To
 run the tests use:

{feldera-0.128.0 → feldera-0.130.0}/feldera.egg-info/SOURCES.txt

@@ -25,7 +25,9 @@ feldera/rest/pipeline.py
 feldera/rest/sql_table.py
 feldera/rest/sql_view.py
 tests/test_checkpoint_sync.py
+tests/test_issue4457.py
 tests/test_pipeline_builder.py
 tests/test_shared_pipeline.py
 tests/test_shared_pipeline_stress.py
+tests/test_uda.py
 tests/test_udf.py

{feldera-0.128.0 → feldera-0.130.0}/pyproject.toml

@@ -6,7 +6,7 @@ build-backend = "setuptools.build_meta"
 name = "feldera"
 readme = "README.md"
 description = "The feldera python client"
-version = "0.128.0"
+version = "0.130.0"
 license = { text = "MIT" }
 requires-python = ">=3.10"
 authors = [