gooddata-pandas 1.63.1.dev3__tar.gz → 1.63.1.dev4__tar.gz

{gooddata_pandas-1.63.1.dev3 → gooddata_pandas-1.63.1.dev4}/PKG-INFO

@@ -1,8 +1,8 @@
 Metadata-Version: 2.4
 Name: gooddata-pandas
-Version: 1.63.1.dev3
+Version: 1.63.1.dev4
 Summary: GoodData Cloud to pandas
-Project-URL: Documentation, https://gooddata-pandas.readthedocs.io/en/v1.63.1.dev3
+Project-URL: Documentation, https://gooddata-pandas.readthedocs.io/en/v1.63.1.dev4
 Project-URL: Source, https://github.com/gooddata/gooddata-python-sdk
 Author-email: GoodData <support@gooddata.com>
 License-Expression: MIT
@@ -20,7 +20,7 @@ Classifier: Topic :: Scientific/Engineering
 Classifier: Topic :: Software Development
 Classifier: Typing :: Typed
 Requires-Python: >=3.10
-Requires-Dist: gooddata-sdk~=1.63.1.dev3
+Requires-Dist: gooddata-sdk~=1.63.1.dev4
 Requires-Dist: pandas<3.0.0,>=2.0.0
 Provides-Extra: arrow
 Requires-Dist: orjson>=3.11.0; extra == 'arrow'

{gooddata_pandas-1.63.1.dev3 → gooddata_pandas-1.63.1.dev4}/pyproject.toml

@@ -1,7 +1,7 @@
 # (C) 2025 GoodData Corporation
 [project]
 name = "gooddata-pandas"
-version = "1.63.1.dev3"
+version = "1.63.1.dev4"
 description = "GoodData Cloud to pandas"
 readme = "README.md"
 license = "MIT"
@@ -29,7 +29,7 @@ keywords = [
 ]
 requires-python = ">=3.10"
 dependencies = [
-    "gooddata-sdk~=1.63.1.dev3",
+    "gooddata-sdk~=1.63.1.dev4",
     "pandas>=2.0.0,<3.0.0",
 ]
 classifiers = [
@@ -50,7 +50,7 @@ classifiers = [
 arrow = ["pyarrow>=23.0.1", "orjson>=3.11.0"]
 
 [project.urls]
-Documentation = "https://gooddata-pandas.readthedocs.io/en/v1.63.1.dev3"
+Documentation = "https://gooddata-pandas.readthedocs.io/en/v1.63.1.dev4"
 Source = "https://github.com/gooddata/gooddata-python-sdk"
 
 [dependency-groups]

{gooddata_pandas-1.63.1.dev3 → gooddata_pandas-1.63.1.dev4}/src/gooddata_pandas/good_pandas.py

@@ -7,6 +7,7 @@ from gooddata_sdk import GoodDataSdk
 from gooddata_sdk.utils import PROFILES_FILE_PATH, good_pandas_profile_content
 
 from gooddata_pandas import __version__
+from gooddata_pandas.arrow_types import ArrowConfig
 from gooddata_pandas.dataframe import DataFrameFactory
 from gooddata_pandas.series import SeriesFactory
 
@@ -24,6 +25,8 @@ class GoodPandas:
         host: str,
         token: str,
         headers_host: str | None = None,
+        use_arrow: bool = False,
+        arrow_config: ArrowConfig | None = None,
         **custom_headers_: str | None,
     ) -> None:
         """
@@ -33,12 +36,21 @@ class GoodPandas:
             host (str): Host for GoodDataSdk.
             token (str): Token for GoodDataSdk.
             headers_host (Optional[str]): Host header, if needed.
+            use_arrow (bool): When True, every DataFrameFactory created via
+                :meth:`data_frames` uses the Arrow IPC binary endpoint instead of
+                the JSON execution path. Requires pyarrow to be installed
+                (``pip install gooddata-pandas[arrow]``). Defaults to False.
+            arrow_config (Optional[ArrowConfig]): Arrow IPC conversion configuration
+                shared across all DataFrameFactory instances created by this
+                GoodPandas instance. Defaults to ArrowConfig() (safe defaults).
             **custom_headers_ (Optional[str]): Additional headers for GoodDataSdk.
 
         """
         if headers_host is not None:
             custom_headers_["Host"] = headers_host
         self._sdk = GoodDataSdk.create(host, token, USER_AGENT, executions_cancellable=False, **custom_headers_)
+        self._use_arrow = use_arrow
+        self._arrow_config = arrow_config
         self._series_per_ws: dict[str, SeriesFactory] = dict()
         self._frames_per_ws: dict[str, DataFrameFactory] = dict()
 
@@ -56,6 +68,8 @@ class GoodPandas:
 
         """
         content, custom_headers = good_pandas_profile_content(profile, profiles_path)
+        if isinstance(content.get("arrow_config"), dict):
+            content["arrow_config"] = ArrowConfig(**content["arrow_config"])
         return cls(**content, **custom_headers)
 
     @property
@@ -97,6 +111,11 @@ class GoodPandas:
 
         """
         if workspace_id not in self._frames_per_ws:
-            self._frames_per_ws[workspace_id] = DataFrameFactory(sdk=self._sdk, workspace_id=workspace_id)
+            self._frames_per_ws[workspace_id] = DataFrameFactory(
+                sdk=self._sdk,
+                workspace_id=workspace_id,
+                use_arrow=self._use_arrow,
+                arrow_config=self._arrow_config,
+            )
 
         return self._frames_per_ws[workspace_id]