gooddata-sdk 1.61.1.dev2__tar.gz → 1.62.0__tar.gz

{gooddata_sdk-1.61.1.dev2 → gooddata_sdk-1.62.0}/PKG-INFO

@@ -1,8 +1,8 @@
 Metadata-Version: 2.4
 Name: gooddata-sdk
-Version: 1.61.1.dev2
+Version: 1.62.0
 Summary: GoodData Cloud Python SDK
-Project-URL: Documentation, https://www.gooddata.com/docs/python-sdk/1.61.1.dev2
+Project-URL: Documentation, https://www.gooddata.com/docs/python-sdk/1.62.0
 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.61.1.dev2
+Requires-Dist: gooddata-api-client~=1.62.0
 Requires-Dist: python-dateutil>=2.5.3
 Requires-Dist: python-dotenv<2.0.0,>=1.0.0
 Requires-Dist: pyyaml>=6.0
@@ -41,11 +41,12 @@ At the moment the SDK provides services to inspect and interact with the Semanti
 * Catalog User Service
 * Catalog Permission Service
 * Catalog Organization Service
+* Catalog Appearance Service
 * Visualizations Service
 * Compute Service
 * Table Service
 
-See [DOCUMENTATION](https://www.gooddata.com/docs/python-sdk/1.61.1.dev2) for more details.
+See [DOCUMENTATION](https://www.gooddata.com/docs/python-sdk/1.62.0) for more details.
 
 ## Requirements
 

{gooddata_sdk-1.61.1.dev2 → gooddata_sdk-1.62.0}/README.md

@@ -9,11 +9,12 @@ At the moment the SDK provides services to inspect and interact with the Semanti
 * Catalog User Service
 * Catalog Permission Service
 * Catalog Organization Service
+* Catalog Appearance Service
 * Visualizations Service
 * Compute Service
 * Table Service
 
-See [DOCUMENTATION](https://www.gooddata.com/docs/python-sdk/1.61.1.dev2) for more details.
+See [DOCUMENTATION](https://www.gooddata.com/docs/python-sdk/1.62.0) for more details.
 
 ## Requirements
 

{gooddata_sdk-1.61.1.dev2 → gooddata_sdk-1.62.0}/pyproject.toml

@@ -1,7 +1,7 @@
 # (C) 2025 GoodData Corporation
 [project]
 name = "gooddata-sdk"
-version = "1.61.1.dev2"
+version = "1.62.0"
 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.61.1.dev2",
+    "gooddata-api-client~=1.62.0",
     "python-dateutil>=2.5.3",
     "pyyaml>=6.0",
     "attrs>=21.4.0,<=24.2.0",
@@ -50,7 +50,7 @@ classifiers = [
 ]
 
 [project.urls]
-Documentation = "https://www.gooddata.com/docs/python-sdk/1.61.1.dev2"
+Documentation = "https://www.gooddata.com/docs/python-sdk/1.62.0"
 Source = "https://github.com/gooddata/gooddata-python-sdk"
 
 [project.scripts]

{gooddata_sdk-1.61.1.dev2 → gooddata_sdk-1.62.0}/src/gooddata_sdk/__init__.py

@@ -7,6 +7,15 @@ At the moment the SDK provides services to inspect and interact with the Semanti
 import logging
 
 from gooddata_sdk._version import __version__
+from gooddata_sdk.catalog.appearance.entity_model.color_palette import (
+    CatalogColorPalette,
+    CatalogColorPaletteAttributes,
+)
+from gooddata_sdk.catalog.appearance.entity_model.theme import (
+    CatalogTheme,
+    CatalogThemeAttributes,
+)
+from gooddata_sdk.catalog.appearance.service import CatalogAppearanceService
 from gooddata_sdk.catalog.data_source.action_model.requests.ldm_request import (
     CatalogGenerateLdmRequest,
     CatalogPdmLdmRequest,
@@ -67,6 +76,7 @@ from gooddata_sdk.catalog.export.request import (
     ExportCustomOverride,
     ExportRequest,
     ExportSettings,
+    GrandTotalsPosition,
     SlidesExportRequest,
     VisualExportRequest,
 )
@@ -100,10 +110,6 @@ from gooddata_sdk.catalog.organization.entity_model.jwk import (
     CatalogJwkDocument,
     CatalogRsaSpecification,
 )
-from gooddata_sdk.catalog.organization.entity_model.llm_endpoint import (
-    CatalogLlmEndpoint,
-    CatalogLlmEndpointDocument,
-)
 from gooddata_sdk.catalog.organization.entity_model.llm_provider import (
     CatalogAwsBedrockProviderConfig,
     CatalogAzureFoundryApiKeyAuth,

gooddata_sdk-1.62.0/src/gooddata_sdk/catalog/appearance/__init__.py

@@ -0,0 +1 @@
+# (C) 2026 GoodData Corporation

gooddata_sdk-1.62.0/src/gooddata_sdk/catalog/appearance/entity_model/__init__.py

@@ -0,0 +1 @@
+# (C) 2026 GoodData Corporation

gooddata_sdk-1.62.0/src/gooddata_sdk/catalog/appearance/entity_model/color_palette.py

@@ -0,0 +1,39 @@
+# (C) 2026 GoodData Corporation
+from __future__ import annotations
+
+from typing import Any
+
+from attrs import define
+from gooddata_api_client.model.json_api_color_palette_in import JsonApiColorPaletteIn
+from gooddata_api_client.model.json_api_color_palette_in_attributes import JsonApiColorPaletteInAttributes
+
+from gooddata_sdk.catalog.base import Base
+
+
+@define(kw_only=True)
+class CatalogColorPalette(Base):
+    id: str
+    attributes: CatalogColorPaletteAttributes
+
+    @staticmethod
+    def client_class() -> type[JsonApiColorPaletteIn]:
+        return JsonApiColorPaletteIn
+
+    @classmethod
+    def init(
+        cls,
+        color_palette_id: str,
+        name: str,
+        content: dict[str, Any],
+    ) -> CatalogColorPalette:
+        return cls(id=color_palette_id, attributes=CatalogColorPaletteAttributes(content=content, name=name))
+
+
+@define(kw_only=True)
+class CatalogColorPaletteAttributes(Base):
+    content: dict[str, Any]
+    name: str
+
+    @staticmethod
+    def client_class() -> type[JsonApiColorPaletteInAttributes]:
+        return JsonApiColorPaletteInAttributes

gooddata_sdk-1.62.0/src/gooddata_sdk/catalog/appearance/entity_model/theme.py

@@ -0,0 +1,39 @@
+# (C) 2026 GoodData Corporation
+from __future__ import annotations
+
+from typing import Any
+
+from attrs import define
+from gooddata_api_client.model.json_api_color_palette_in_attributes import JsonApiColorPaletteInAttributes
+from gooddata_api_client.model.json_api_theme_in import JsonApiThemeIn
+
+from gooddata_sdk.catalog.base import Base
+
+
+@define(kw_only=True)
+class CatalogTheme(Base):
+    id: str
+    attributes: CatalogThemeAttributes
+
+    @staticmethod
+    def client_class() -> type[JsonApiThemeIn]:
+        return JsonApiThemeIn
+
+    @classmethod
+    def init(
+        cls,
+        theme_id: str,
+        name: str,
+        content: dict[str, Any],
+    ) -> CatalogTheme:
+        return cls(id=theme_id, attributes=CatalogThemeAttributes(content=content, name=name))
+
+
+@define(kw_only=True)
+class CatalogThemeAttributes(Base):
+    content: dict[str, Any]
+    name: str
+
+    @staticmethod
+    def client_class() -> type[JsonApiColorPaletteInAttributes]:
+        return JsonApiColorPaletteInAttributes

gooddata_sdk-1.62.0/src/gooddata_sdk/catalog/appearance/service.py

@@ -0,0 +1,182 @@
+# (C) 2026 GoodData Corporation
+from __future__ import annotations
+
+import functools
+
+from gooddata_api_client.exceptions import NotFoundException
+from gooddata_api_client.model.json_api_color_palette_in_document import JsonApiColorPaletteInDocument
+from gooddata_api_client.model.json_api_theme_in_document import JsonApiThemeInDocument
+
+from gooddata_sdk.catalog.appearance.entity_model.color_palette import CatalogColorPalette
+from gooddata_sdk.catalog.appearance.entity_model.theme import CatalogTheme
+from gooddata_sdk.catalog.catalog_service_base import CatalogServiceBase
+from gooddata_sdk.client import GoodDataApiClient
+from gooddata_sdk.utils import load_all_entities
+
+
+class CatalogAppearanceService(CatalogServiceBase):
+    def __init__(self, api_client: GoodDataApiClient) -> None:
+        super().__init__(api_client)
+        self._appearance_api = api_client.appearance_api
+
+    # Theme methods
+
+    def list_themes(self) -> list[CatalogTheme]:
+        """Returns a list of all themes in the current organization.
+
+        Returns:
+            list[CatalogTheme]:
+                List of themes in the current organization.
+        """
+        get_themes = functools.partial(self._appearance_api.get_all_entities_themes, _check_return_type=False)
+        themes = load_all_entities(get_themes)
+        return [CatalogTheme.from_api(theme) for theme in themes.data]
+
+    def get_theme(self, theme_id: str) -> CatalogTheme:
+        """Get an individual theme.
+
+        Args:
+            theme_id (str):
+                Theme identification string e.g. "my_dark_theme"
+
+        Returns:
+            CatalogTheme:
+                Catalog theme object containing structure of the theme.
+        """
+        theme_api = self._appearance_api.get_entity_themes(id=theme_id).data
+        return CatalogTheme.from_api(theme_api)
+
+    def create_theme(self, theme: CatalogTheme) -> None:
+        """Create a new theme.
+
+        Args:
+            theme (CatalogTheme):
+                A catalog theme object to be created.
+
+        Returns:
+            None
+        """
+        theme_document = JsonApiThemeInDocument(data=theme.to_api())
+        self._appearance_api.create_entity_themes(json_api_theme_in_document=theme_document)
+
+    def update_theme(self, theme: CatalogTheme) -> None:
+        """Update a theme.
+
+        Args:
+            theme (CatalogTheme):
+                A catalog theme object to be updated.
+
+        Returns:
+            None
+
+        Raises:
+            ValueError:
+                Theme does not exist.
+        """
+        try:
+            theme_document = JsonApiThemeInDocument(data=theme.to_api())
+            self._appearance_api.update_entity_themes(theme.id, json_api_theme_in_document=theme_document)
+        except NotFoundException:
+            raise ValueError(f"Can not update {theme.id} theme. This theme does not exist.")
+
+    def delete_theme(self, theme_id: str) -> None:
+        """Delete a theme.
+
+        Args:
+            theme_id (str):
+                Theme identification string e.g. "my_dark_theme"
+
+        Returns:
+            None
+
+        Raises:
+            ValueError:
+                Theme does not exist.
+        """
+        try:
+            self._appearance_api.delete_entity_themes(theme_id)
+        except NotFoundException:
+            raise ValueError(f"Can not delete {theme_id} theme. This theme does not exist.")
+
+    # Color palette methods
+
+    def list_color_palettes(self) -> list[CatalogColorPalette]:
+        """Returns a list of all color palettes in the current organization.
+
+        Returns:
+            list[CatalogColorPalette]:
+                List of color palettes in the current organization.
+        """
+        get_color_palettes = functools.partial(
+            self._appearance_api.get_all_entities_color_palettes, _check_return_type=False
+        )
+        color_palettes = load_all_entities(get_color_palettes)
+        return [CatalogColorPalette.from_api(color_palette) for color_palette in color_palettes.data]
+
+    def get_color_palette(self, color_palette_id: str) -> CatalogColorPalette:
+        """Get an individual color palette.
+
+        Args:
+            color_palette_id (str):
+                Color palette identification string e.g. "my_palette"
+
+        Returns:
+            CatalogColorPalette:
+                Catalog color palette object containing structure of the color palette.
+        """
+        color_palette_api = self._appearance_api.get_entity_color_palettes(id=color_palette_id).data
+        return CatalogColorPalette.from_api(color_palette_api)
+
+    def create_color_palette(self, color_palette: CatalogColorPalette) -> None:
+        """Create a new color palette.
+
+        Args:
+            color_palette (CatalogColorPalette):
+                A catalog color palette object to be created.
+
+        Returns:
+            None
+        """
+        color_palette_document = JsonApiColorPaletteInDocument(data=color_palette.to_api())
+        self._appearance_api.create_entity_color_palettes(json_api_color_palette_in_document=color_palette_document)
+
+    def update_color_palette(self, color_palette: CatalogColorPalette) -> None:
+        """Update a color palette.
+
+        Args:
+            color_palette (CatalogColorPalette):
+                A catalog color palette object to be updated.
+
+        Returns:
+            None
+
+        Raises:
+            ValueError:
+                Color palette does not exist.
+        """
+        try:
+            color_palette_document = JsonApiColorPaletteInDocument(data=color_palette.to_api())
+            self._appearance_api.update_entity_color_palettes(
+                color_palette.id, json_api_color_palette_in_document=color_palette_document
+            )
+        except NotFoundException:
+            raise ValueError(f"Can not update {color_palette.id} color palette. This color palette does not exist.")
+
+    def delete_color_palette(self, color_palette_id: str) -> None:
+        """Delete a color palette.
+
+        Args:
+            color_palette_id (str):
+                Color palette identification string e.g. "my_palette"
+
+        Returns:
+            None
+
+        Raises:
+            ValueError:
+                Color palette does not exist.
+        """
+        try:
+            self._appearance_api.delete_entity_color_palettes(color_palette_id)
+        except NotFoundException:
+            raise ValueError(f"Can not delete {color_palette_id} color palette. This color palette does not exist.")

{gooddata_sdk-1.61.1.dev2 → gooddata_sdk-1.62.0}/src/gooddata_sdk/catalog/data_source/service.py

@@ -130,9 +130,6 @@ class CatalogDataSourceService(CatalogServiceBase):
     def list_data_sources(self) -> list[CatalogDataSource]:
         """Lists all data sources.
 
-        Args:
-            None
-
         Returns:
             list[CatalogDataSource]:
                 List of all Data Sources in the whole organization.
@@ -149,9 +146,6 @@ class CatalogDataSourceService(CatalogServiceBase):
     def get_declarative_data_sources(self) -> CatalogDeclarativeDataSources:
         """Retrieve all data sources.
 
-        Args:
-            None
-
         Returns:
             CatalogDeclarativeDataSources:
                 Declarative Data Sources, including physical data model.

{gooddata_sdk-1.61.1.dev2 → gooddata_sdk-1.62.0}/src/gooddata_sdk/catalog/export/request.py

@@ -1,4 +1,6 @@
 # (C) 2023 GoodData Corporation
+from __future__ import annotations
+
 from typing import Literal
 
 from attrs import define
@@ -12,6 +14,8 @@ from gooddata_api_client.model.visual_export_request import VisualExportRequest
 
 from gooddata_sdk.catalog.base import Base
 
+GrandTotalsPosition = Literal["pinnedBottom", "pinnedTop", "bottom", "top"]
+
 
 @define(kw_only=True)
 class ExportCustomLabel(Base):
@@ -46,6 +50,7 @@ class ExportCustomOverride(Base):
 class ExportSettings(Base):
     merge_headers: bool
     show_filters: bool
+    grand_totals_position: GrandTotalsPosition | None = None
 
     @staticmethod
     def client_class() -> type[ApiSettings]:

{gooddata_sdk-1.61.1.dev2 → gooddata_sdk-1.62.0}/src/gooddata_sdk/catalog/export/service.py

@@ -21,6 +21,7 @@ from gooddata_sdk.visualization import VisualizationService
 class ExportService(CatalogServiceBase):
     """
     ExportService provides the ability to export PDF and Tabular data from GoodData Dashboards.
+
     Attributes:
         _entities_api:
             A reference to the entities_api of GoodDataApiClient instance.
@@ -47,6 +48,7 @@ class ExportService(CatalogServiceBase):
         super().__init__(api_client)
         """
         Initializes the ExportService with the GoodDataApiClient instance.
+
         Args:
             api_client (GoodDataApiClient): An instance of the GoodData API Client.
         """
@@ -62,6 +64,7 @@ class ExportService(CatalogServiceBase):
     ) -> bytes:
         """
         Get the exported content from a server as bytes.
+
         Args:
             workspace_id (str):
                 The workspace ID for which content is to be exported.
@@ -75,8 +78,10 @@ class ExportService(CatalogServiceBase):
                 Initial time in seconds to wait between retries. Defaults to 0.2.
             max_retry (float, optional):
                 Maximum time in seconds to wait between retries. Defaults to 5.0.
+
         Returns:
             bytes: The exported content as bytes.
+
         Raises:
             ValueError: If the server is not able to return a response or if the input values are invalid.
         """
@@ -107,11 +112,13 @@ class ExportService(CatalogServiceBase):
     ) -> str:
         """
         Creates an export of the requested type (PDF or Tabular) in the specified Workspace.
+
         Args:
             workspace_id (str): The ID of the target Workspace.
             request (Union[PdfExportRequest, TabularExportRequest]):
                 A request object specifying the type of export (PDF or Tabular) to be created.
             create_func (Callable): The function used to create the export.
+
         Returns:
             str: The export result from the response object.
         """
@@ -127,6 +134,7 @@ class ExportService(CatalogServiceBase):
                 The ID of the target Workspace.
             dashboard_id (str):
                 The ID of the target Dashboard.
+
         Returns:
             bool: Returns true, if the dashboard exists.
 
@@ -152,6 +160,7 @@ class ExportService(CatalogServiceBase):
     ) -> None:
         """
         Common method to export content from a workspace.
+
         Args:
             workspace_id (str):
                 The ID of the workspace to export from.
@@ -169,6 +178,7 @@ class ExportService(CatalogServiceBase):
                 The time interval to retry checking for exported content (in seconds). Defaults to 0.2.
             max_retry (float, optional):
                 The maximum number of retries to check for exported content. Defaults to 5.0.
+
         Returns:
             None
         """
@@ -190,6 +200,7 @@ class ExportService(CatalogServiceBase):
     ) -> None:
         """
         Export a PDF of the specified GoodData Dashboard and save it to the specified file path.
+
         Args:
             workspace_id (str):
                 The ID of the GoodData Workspace.
@@ -236,6 +247,7 @@ class ExportService(CatalogServiceBase):
     ) -> None:
         """
         Export Tabular (CSV, XLSX) data from the specified GoodData Dashboard report, saved to the specified file path.
+
         Args:
             workspace_id (str):
                 The ID of the GoodData Workspace.

{gooddata_sdk-1.61.1.dev2 → gooddata_sdk-1.62.0}/src/gooddata_sdk/catalog/organization/entity_model/llm_provider.py

@@ -15,7 +15,6 @@ from gooddata_api_client.model.json_api_llm_provider_in_attributes_models_inner
 )
 from gooddata_api_client.model.json_api_llm_provider_in_document import JsonApiLlmProviderInDocument
 from gooddata_api_client.model.json_api_llm_provider_patch import JsonApiLlmProviderPatch
-from gooddata_api_client.model.json_api_llm_provider_patch_attributes import JsonApiLlmProviderPatchAttributes
 from gooddata_api_client.model.json_api_llm_provider_patch_document import JsonApiLlmProviderPatchDocument
 from gooddata_api_client.model.open_ai_provider_auth import OpenAiProviderAuth
 from gooddata_api_client.model.open_ai_provider_config import OpenAIProviderConfig
@@ -254,16 +253,20 @@ class CatalogLlmProvider(Base):
     @classmethod
     def from_api(cls, entity: dict[str, Any]) -> CatalogLlmProvider:
         ea = entity["attributes"]
-        raw_models = safeget(ea, ["models"]) or []
-        models = [
-            CatalogLlmProviderModel(
-                id=safeget(m, ["id"]),
-                family=safeget(m, ["family"]),
-            )
-            for m in raw_models
-        ]
-        raw_config = safeget(ea, ["providerConfig"]) or {}
-        provider_config = _provider_config_from_api(raw_config)
+        raw_models = safeget(ea, ["models"])
+        models = (
+            [
+                CatalogLlmProviderModel(
+                    id=safeget(m, ["id"]),
+                    family=safeget(m, ["family"]),
+                )
+                for m in raw_models
+            ]
+            if raw_models is not None
+            else None
+        )
+        raw_config = safeget(ea, ["providerConfig"])
+        provider_config = _provider_config_from_api(raw_config) if raw_config is not None else None
         return cls(
             id=entity["id"],
             attributes=CatalogLlmProviderAttributes(
@@ -312,8 +315,8 @@ class CatalogLlmProviderPatch(Base):
 
 @define(kw_only=True)
 class CatalogLlmProviderAttributes(Base):
-    models: list[CatalogLlmProviderModel]
-    provider_config: CatalogLlmProviderConfig
+    models: list[CatalogLlmProviderModel] | None = None
+    provider_config: CatalogLlmProviderConfig | None = None
     name: str | None = None
     description: str | None = None
     default_model_id: str | None = None
@@ -332,5 +335,5 @@ class CatalogLlmProviderPatchAttributes(Base):
     default_model_id: str | None = None
 
     @staticmethod
-    def client_class() -> type[JsonApiLlmProviderPatchAttributes]:
-        return JsonApiLlmProviderPatchAttributes
+    def client_class() -> type[JsonApiLlmProviderInAttributes]:
+        return JsonApiLlmProviderInAttributes