gooddata-sdk 1.68.0__tar.gz → 1.68.1.dev2__tar.gz

{gooddata_sdk-1.68.0 → gooddata_sdk-1.68.1.dev2}/PKG-INFO

@@ -1,8 +1,8 @@
 Metadata-Version: 2.4
 Name: gooddata-sdk
-Version: 1.68.0
+Version: 1.68.1.dev2
 Summary: GoodData Cloud Python SDK
-Project-URL: Documentation, https://www.gooddata.ai/docs/python-sdk/1.68.0
+Project-URL: Documentation, https://www.gooddata.ai/docs/python-sdk/1.68.1.dev2
 Project-URL: Source, https://github.com/gooddata/gooddata-python-sdk
 Author-email: GoodData <support@gooddata.com>
 License-Expression: MIT
@@ -23,7 +23,7 @@ Requires-Python: <4.0,>=3.10
 Requires-Dist: attrs<=24.2.0,>=21.4.0
 Requires-Dist: brotli==1.2.0
 Requires-Dist: cattrs<=24.1.1,>=22.1.0
-Requires-Dist: gooddata-api-client~=1.68.0
+Requires-Dist: gooddata-api-client~=1.68.1.dev2
 Requires-Dist: gooddata-code-convertors>=11.35.0a2
 Requires-Dist: python-dateutil>=2.5.3
 Requires-Dist: python-dotenv<2.0.0,>=1.0.0
@@ -49,7 +49,7 @@ At the moment the SDK provides services to inspect and interact with the Semanti
 * Compute Service
 * Table Service
 
-See [DOCUMENTATION](https://www.gooddata.ai/docs/python-sdk/1.68.0) for more details.
+See [DOCUMENTATION](https://www.gooddata.ai/docs/python-sdk/1.68.1.dev2) for more details.
 
 ## Requirements
 

{gooddata_sdk-1.68.0 → gooddata_sdk-1.68.1.dev2}/README.md

@@ -14,7 +14,7 @@ At the moment the SDK provides services to inspect and interact with the Semanti
 * Compute Service
 * Table Service
 
-See [DOCUMENTATION](https://www.gooddata.ai/docs/python-sdk/1.68.0) for more details.
+See [DOCUMENTATION](https://www.gooddata.ai/docs/python-sdk/1.68.1.dev2) for more details.
 
 ## Requirements
 

{gooddata_sdk-1.68.0 → gooddata_sdk-1.68.1.dev2}/pyproject.toml

@@ -1,7 +1,7 @@
 # (C) 2025 GoodData Corporation
 [project]
 name = "gooddata-sdk"
-version = "1.68.0"
+version = "1.68.1.dev2"
 description = "GoodData Cloud Python SDK"
 readme = "README.md"
 license = "MIT"
@@ -26,7 +26,7 @@ keywords = [
 ]
 requires-python = ">=3.10,<4.0"
 dependencies = [
-    "gooddata-api-client~=1.68.0",
+    "gooddata-api-client~=1.68.1.dev2",
     "python-dateutil>=2.5.3",
     "pyyaml>=6.0",
     "attrs>=21.4.0,<=24.2.0",
@@ -54,7 +54,7 @@ classifiers = [
 arrow = ["pyarrow>=23.0.1"]
 
 [project.urls]
-Documentation = "https://www.gooddata.ai/docs/python-sdk/1.68.0"
+Documentation = "https://www.gooddata.ai/docs/python-sdk/1.68.1.dev2"
 Source = "https://github.com/gooddata/gooddata-python-sdk"
 
 [project.scripts]

{gooddata_sdk-1.68.0 → gooddata_sdk-1.68.1.dev2}/src/gooddata_sdk/__init__.py

@@ -221,6 +221,7 @@ from gooddata_sdk.catalog.workspace.declarative_model.workspace.analytics_model.
     CatalogDeclarativeAnalytics,
     CatalogDeclarativeMemoryItem,
     CatalogDeclarativeMetric,
+    CatalogDeclarativeParameter,
 )
 from gooddata_sdk.catalog.workspace.declarative_model.workspace.analytics_model.export_definition import (
     CatalogDeclarativeExportDefinition,

{gooddata_sdk-1.68.0 → gooddata_sdk-1.68.1.dev2}/src/gooddata_sdk/catalog/data_source/action_model/sql_column.py

@@ -11,6 +11,7 @@ from gooddata_sdk.catalog.base import Base
 class SqlColumn(Base):
     data_type: str
     name: str
+    null_value: str | None = None
 
     @staticmethod
     def client_class() -> type[ApiSqlColumn]:

{gooddata_sdk-1.68.0 → gooddata_sdk-1.68.1.dev2}/src/gooddata_sdk/catalog/workspace/declarative_model/workspace/analytics_model/analytics_model.py

@@ -15,10 +15,10 @@ from gooddata_api_client.model.declarative_dashboard_plugin import DeclarativeDa
 from gooddata_api_client.model.declarative_filter_context import DeclarativeFilterContext
 from gooddata_api_client.model.declarative_memory_item import DeclarativeMemoryItem
 from gooddata_api_client.model.declarative_metric import DeclarativeMetric
+from gooddata_api_client.model.declarative_parameter import DeclarativeParameter
 from gooddata_api_client.model.declarative_visualization_object import DeclarativeVisualizationObject
 
 from gooddata_sdk.catalog.base import Base
-from gooddata_sdk.catalog.parameter import CatalogParameter
 from gooddata_sdk.catalog.permission.declarative_model.permission import (
     CatalogDeclarativeDashboardPermissionsForAssignee,
     CatalogDeclarativeDashboardPermissionsForAssigneeRule,
@@ -51,6 +51,7 @@ LAYOUT_VISUALIZATION_OBJECTS_DIR = "visualization_objects"
 ATTRIBUTE_HIERARCHY_OBJECTS_DIR = "attribute_hierarchy_objects"
 EXPORT_DEFINITION_DIR = "export_definitions"
 MEMORY_ITEMS_DIR = "memory_items"
+PARAMETERS_DIR = "parameters"
 
 
 @define(kw_only=True)
@@ -82,7 +83,7 @@ class CatalogDeclarativeAnalyticsLayer(Base):
     visualization_objects: list[CatalogDeclarativeVisualizationObject] = field(factory=list)
     export_definitions: list[CatalogDeclarativeExportDefinition] = field(factory=list)
     memory_items: list[CatalogDeclarativeMemoryItem] = field(factory=list)
-    parameters: list[CatalogParameter] = field(factory=list)
+    parameters: list[CatalogDeclarativeParameter] = field(factory=list)
 
     @staticmethod
     def client_class() -> type[DeclarativeAnalyticsLayer]:
@@ -148,6 +149,12 @@ class CatalogDeclarativeAnalyticsLayer(Base):
         create_directory(folder)
         return folder
 
+    @staticmethod
+    def get_parameters_folder(analytics_model_folder: Path) -> Path:
+        folder = analytics_model_folder / PARAMETERS_DIR
+        create_directory(folder)
+        return folder
+
     def store_to_disk(self, workspace_folder: Path, sort: bool = False) -> None:
         analytics_model_folder = self.get_analytics_model_folder(workspace_folder)
 
@@ -160,6 +167,7 @@ class CatalogDeclarativeAnalyticsLayer(Base):
         attribute_hierarchy_folder = self.get_attribute_hierarchy_folder(analytics_model_folder)
         export_definition_folder = self.get_export_definition_folder(analytical_dashboards_folder)
         memory_item_folder = self.get_memory_item_folder(analytics_model_folder)
+        parameters_folder = self.get_parameters_folder(analytics_model_folder)
 
         for analytical_dashboard in self.analytical_dashboards:
             analytical_dashboard.store_to_disk(analytical_dashboards_folder, sort=sort)
@@ -188,6 +196,9 @@ class CatalogDeclarativeAnalyticsLayer(Base):
         for memory_item in self.memory_items:
             memory_item.store_to_disk(memory_item_folder, sort=sort)
 
+        for parameter in self.parameters:
+            parameter.store_to_disk(parameters_folder, sort=sort)
+
     @classmethod
     def load_from_disk(cls, workspace_folder: Path) -> CatalogDeclarativeAnalyticsLayer:
         analytics_model_folder = cls.get_analytics_model_folder(workspace_folder)
@@ -200,6 +211,7 @@ class CatalogDeclarativeAnalyticsLayer(Base):
         attribute_hierarchy_folder = cls.get_attribute_hierarchy_folder(analytics_model_folder)
         export_definition_folder = cls.get_export_definition_folder(analytical_dashboards_folder)
         memory_item_folder = cls.get_memory_item_folder(analytics_model_folder)
+        parameters_folder = cls.get_parameters_folder(analytics_model_folder)
 
         analytical_dashboard_files = get_sorted_yaml_files(analytical_dashboards_folder)
         analytical_dashboard_extension_files = get_sorted_yaml_files(analytical_dashboard_extensions_folder)
@@ -210,6 +222,7 @@ class CatalogDeclarativeAnalyticsLayer(Base):
         attribute_hierarchy_files = get_sorted_yaml_files(attribute_hierarchy_folder)
         export_definition_files = get_sorted_yaml_files(export_definition_folder)
         memory_item_files = get_sorted_yaml_files(memory_item_folder)
+        parameter_files = get_sorted_yaml_files(parameters_folder)
 
         analytical_dashboards = [
             CatalogDeclarativeAnalyticalDashboard.load_from_disk(analytical_dashboard_file)
@@ -243,6 +256,7 @@ class CatalogDeclarativeAnalyticsLayer(Base):
         memory_items = [
             CatalogDeclarativeMemoryItem.load_from_disk(memory_item_file) for memory_item_file in memory_item_files
         ]
+        parameters = [CatalogDeclarativeParameter.load_from_disk(parameter_file) for parameter_file in parameter_files]
         return cls(
             analytical_dashboards=analytical_dashboards,
             analytical_dashboard_extensions=analytical_dashboard_extensions,
@@ -253,6 +267,7 @@ class CatalogDeclarativeAnalyticsLayer(Base):
             visualization_objects=visualization_objects,
             export_definitions=export_definitions,
             memory_items=memory_items,
+            parameters=parameters,
         )
 
 
@@ -348,3 +363,10 @@ class CatalogDeclarativeMemoryItem(CatalogAnalyticsBaseMeta):
     @staticmethod
     def client_class() -> type[DeclarativeMemoryItem]:
         return DeclarativeMemoryItem
+
+
+@define(kw_only=True)
+class CatalogDeclarativeParameter(CatalogAnalyticsBase):
+    @staticmethod
+    def client_class() -> type[DeclarativeParameter]:
+        return DeclarativeParameter

{gooddata_sdk-1.68.0 → gooddata_sdk-1.68.1.dev2}/tests/catalog/fixtures/data_sources/scan_scan_sql_without_preview.yaml

@@ -22,6 +22,7 @@ interactions:
           columns:
             - dataType: INT
               name: campaign_id
+              nullValue: '0'
       headers:
         Content-Type:
           - application/json

{gooddata_sdk-1.68.0 → gooddata_sdk-1.68.1.dev2}/tests/catalog/fixtures/data_sources/scan_sql.yaml

@@ -22,10 +22,13 @@ interactions:
           columns:
             - dataType: INT
               name: product_id
+              nullValue: '0'
             - dataType: STRING
               name: product_name
+              nullValue: _
             - dataType: STRING
               name: category
+              nullValue: _
           dataPreview:
             - - '150'
               - Skirt

{gooddata_sdk-1.68.0 → gooddata_sdk-1.68.1.dev2}/tests/catalog/fixtures/data_sources/scan_sql_with_nulls_in_preview.yaml

@@ -23,6 +23,7 @@ interactions:
           columns:
             - dataType: INT
               name: campaign_id
+              nullValue: '0'
           dataPreview:
             - - null
             - - null

{gooddata_sdk-1.68.0 → gooddata_sdk-1.68.1.dev2}/tests/catalog/test_catalog_data_source.py

@@ -728,9 +728,9 @@ def test_scan_sql(test_config: dict):
 
     assert len(response.columns) == 3
     assert response.columns == [
-        SqlColumn(name="category", data_type="STRING"),
-        SqlColumn(name="product_id", data_type="INT"),
-        SqlColumn(name="product_name", data_type="STRING"),
+        SqlColumn(name="category", data_type="STRING", null_value="_"),
+        SqlColumn(name="product_id", data_type="INT", null_value="0"),
+        SqlColumn(name="product_name", data_type="STRING", null_value="_"),
     ]
     assert len(response.data_preview) == 10
 
@@ -746,7 +746,7 @@ def test_scan_sql_with_nulls_in_preview(test_config: dict):
 
     assert len(response.columns) == 1
     assert response.columns == [
-        SqlColumn(name="campaign_id", data_type="INT"),
+        SqlColumn(name="campaign_id", data_type="INT", null_value="0"),
     ]
     assert len(response.data_preview) == 5
     assert [None] in response.data_preview
@@ -763,7 +763,7 @@ def test_scan_sql_without_preview(test_config: dict):
 
     assert len(response.columns) == 1
     assert response.columns == [
-        SqlColumn(name="campaign_id", data_type="INT"),
+        SqlColumn(name="campaign_id", data_type="INT", null_value="0"),
     ]
     assert response.data_preview is None
 

gooddata_sdk-1.68.1.dev2/tests/catalog/unit_tests/test_declarative_analytics_parameters.py

@@ -0,0 +1,52 @@
+# (C) 2026 GoodData Corporation
+"""Unit test: analytics-layer ``parameters`` survive the declarative round-trip.
+
+Regression test. The ``parameters`` field on ``CatalogDeclarativeAnalyticsLayer``
+was bound to the data-source ``CatalogParameter`` ({name, value}) instead of a
+declarative parameter wrapper ({id, title, content}). That dropped the field
+silently on older SDKs and raised ``ClassValidationError`` once the generated
+model gained ``parameters``. This pins the correct behaviour: a parameter that
+goes in must come back out unchanged.
+"""
+
+from __future__ import annotations
+
+from pathlib import Path
+
+from gooddata_sdk import CatalogDeclarativeAnalytics
+from gooddata_sdk.catalog.workspace.declarative_model.workspace.analytics_model.analytics_model import (
+    CatalogDeclarativeAnalyticsLayer,
+)
+
+_PARAMETER = {
+    "id": "discount-rate",
+    "title": "Discount Rate",
+    "content": {"type": "NUMBER", "defaultValue": 0.5},
+}
+_LAYOUT = {"analytics": {"parameters": [_PARAMETER]}}
+
+
+def test_declarative_analytics_parameters_survive_round_trip() -> None:
+    analytics = CatalogDeclarativeAnalytics.from_dict(_LAYOUT)
+
+    # The typed wrapper must actually capture the parameter as a declarative
+    # parameter (id/title/content), not the data-source name/value shape.
+    params = analytics.analytics.parameters
+    assert len(params) == 1
+    assert params[0].id == "discount-rate"
+    assert params[0].title == "Discount Rate"
+    assert params[0].content["type"] == "NUMBER"
+
+    # The api round-trip must preserve it verbatim - neither dropped nor mangled.
+    round_tripped = analytics.to_api().to_dict(camel_case=True)
+    assert round_tripped["analytics"]["parameters"] == [_PARAMETER]
+
+
+def test_declarative_analytics_parameters_survive_disk_round_trip(tmp_path: Path) -> None:
+    layer = CatalogDeclarativeAnalyticsLayer.from_dict({"parameters": [_PARAMETER]})
+
+    layer.store_to_disk(tmp_path)
+    reloaded = CatalogDeclarativeAnalyticsLayer.load_from_disk(tmp_path)
+
+    assert [p.id for p in reloaded.parameters] == ["discount-rate"]
+    assert reloaded.parameters[0].content["type"] == "NUMBER"