C.mze cq 105

packages/gooddata-pandas/pyproject.toml

@@ -32,7 +32,6 @@ dependencies = [
     "gooddata-sdk~=1.62.0",
     "pandas>=2.0.0,<3.0.0",
 ]
-
 classifiers = [
     "Development Status :: 5 - Production/Stable",
     "Environment :: Console",
@@ -47,6 +46,9 @@ classifiers = [
     "Typing :: Typed",
 ]
 
+[project.optional-dependencies]
+arrow = ["pyarrow>=23.0.1"]
+
 [project.urls]
 Documentation = "https://gooddata-pandas.readthedocs.io/en/v1.62.0"
 Source = "https://github.com/gooddata/gooddata-python-sdk"
@@ -63,6 +65,7 @@ test = [
     "python-dotenv~=1.0.0",
     "pyyaml",
     "tests_support",
+    "pyarrow>=16.1.0",
 ]
 
 [tool.ty.analysis]

packages/gooddata-pandas/src/gooddata_pandas/__init__.py

@@ -1,6 +1,16 @@
 # (C) 2021 GoodData Corporation
 
+from gooddata_pandas._arrow_types import TypesMapper
 from gooddata_pandas._version import __version__
+
+try:
+    from gooddata_pandas.arrow_convertor import convert_arrow_table_to_dataframe
+except ImportError:
+
+    def convert_arrow_table_to_dataframe(*args, **kwargs):
+        raise ImportError("pyarrow is required for Arrow support. Install it with: pip install gooddata-pandas[arrow]")
+
+
 from gooddata_pandas.dataframe import DataFrameFactory
 from gooddata_pandas.good_pandas import GoodPandas
 from gooddata_pandas.result_convertor import LabelOverrides

packages/gooddata-pandas/src/gooddata_pandas/_arrow_types.py

@@ -0,0 +1,21 @@
+# (C) 2026 GoodData Corporation
+from __future__ import annotations
+
+from enum import Enum
+
+
+class TypesMapper(Enum):
+    """
+    Controls how Arrow column types are mapped to pandas dtypes during conversion.
+
+    DEFAULT       — no remapping; produces float64 and object strings, identical to
+                    the JSON execution path. Safe default, fully backward compatible.
+    ARROW_STRINGS — strings use Arrow-backed StringDtype (lower memory, faster);
+                    all numeric types unchanged. Recommended next step for services.
+    CUSTOM        — use the custom_mapping dict passed alongside. Raises ValueError
+                    if custom_mapping is not provided.
+    """
+
+    DEFAULT = "default"
+    ARROW_STRINGS = "arrow_strings"
+    CUSTOM = "custom"