python(feat): updated export.protos to support parquet

Author: wei-qlu

python/lib/sift_client/_tests/resources/test_exports.py

@@ -38,6 +38,7 @@
 START = datetime(2025, 1, 1, tzinfo=timezone.utc)
 STOP = datetime(2025, 1, 2, tzinfo=timezone.utc)
 CSV = ExportOutputFormat.CSV
+PARQUET = ExportOutputFormat.PARQUET
 
 
 @pytest.fixture
@@ -240,6 +241,20 @@ def test_export_by_time_range(self, exports_api_sync, sift_client, nostromo_run)
             assert isinstance(job, Job)
 
 
+class TestParquetFormat:
+    @pytest.mark.asyncio
+    async def test_export_parquet_format(self, exports_api):
+        """Test that Parquet output format is accepted."""
+        await exports_api.export(
+            runs=["run-1"],
+            start_time=START,
+            stop_time=STOP,
+            output_format=PARQUET,
+        )
+        call_kwargs = exports_api._low_level_client.export_data.call_args.kwargs
+        assert call_kwargs["output_format"] == PARQUET
+
+
 class TestDictConversion:
     @pytest.mark.asyncio
     async def test_calculated_channel_dict_converted(self, exports_api):

python/lib/sift_client/resources/exports.py

@@ -71,7 +71,7 @@ async def export(
         You cannot provide both ``runs`` and ``assets`` at the same time.
 
         Args:
-            output_format: The file format for the export (CSV or Sun/WinPlot).
+            output_format: The file format for the export (CSV, Parquet, or Sun/WinPlot).
             runs: One or more Run objects or run IDs to export data from.
             assets: One or more Asset objects or asset IDs to export data from.
             start_time: Start of the time range to export. Required when using

python/lib/sift_client/resources/sync_stubs/__init__.pyi

@@ -593,7 +593,7 @@ class DataExportAPI:
         You cannot provide both ``runs`` and ``assets`` at the same time.
 
         Args:
-            output_format: The file format for the export (CSV or Sun/WinPlot).
+            output_format: The file format for the export (CSV, Parquet, or Sun/WinPlot).
             runs: One or more Run objects or run IDs to export data from.
             assets: One or more Asset objects or asset IDs to export data from.
             start_time: Start of the time range to export. Required when using

python/lib/sift_client/sift_types/export.py

@@ -11,7 +11,9 @@ class ExportOutputFormat(Enum):
     Attributes:
         CSV: Comma-separated values format.
         SUN: Sun (WinPlot) format (not used in certain environments).
+        PARQUET: Apache Parquet columnar storage format.
     """
 
     CSV = ExportOutputFormatProto.EXPORT_OUTPUT_FORMAT_CSV
     SUN = ExportOutputFormatProto.EXPORT_OUTPUT_FORMAT_SUN
+    PARQUET = ExportOutputFormatProto.EXPORT_OUTPUT_FORMAT_PARQUET