Merge pull request #1412 from hkad98/jkd/theming

feat(gooddata-sdk): add CatalogAppearanceService for themes and color palettes

Author: hkad98

docs/content/en/latest/administration/appearance/_index.md

@@ -0,0 +1,77 @@
+---
+title: "Appearance"
+linkTitle: "Appearance"
+weight: 15
+no_list: true
+---
+
+Manage themes and color palettes for your organization.
+
+## Methods
+
+### Themes
+
+* [list_themes](./list_themes/)
+* [get_theme](./get_theme/)
+* [create_theme](./create_theme/)
+* [update_theme](./update_theme/)
+* [delete_theme](./delete_theme/)
+
+### Color Palettes
+
+* [list_color_palettes](./list_color_palettes/)
+* [get_color_palette](./get_color_palette/)
+* [create_color_palette](./create_color_palette/)
+* [update_color_palette](./update_color_palette/)
+* [delete_color_palette](./delete_color_palette/)
+
+## Example
+
+Create a custom theme and color palette:
+
+```python
+from gooddata_sdk import GoodDataSdk, CatalogTheme, CatalogColorPalette
+
+host = "https://www.example.com"
+token = "some_user_token"
+sdk = GoodDataSdk.create(host, token)
+
+# Create a custom theme
+theme = CatalogTheme.init(
+    theme_id="my_dark_theme",
+    name="My Dark Theme",
+    content={
+        "palette": {
+            "primary": {"base": "#14B2E2"},
+        },
+        "dashboards": {
+            "content": {
+                "widget": {
+                    "backgroundColor": "#122330",
+                }
+            }
+        },
+    },
+)
+sdk.catalog_appearance.create_theme(theme)
+
+# List all themes
+themes = sdk.catalog_appearance.list_themes()
+
+# Create a custom color palette for charts
+palette = CatalogColorPalette.init(
+    color_palette_id="my_palette",
+    name="My Palette",
+    content={
+        "colorPalette": [
+            {"guid": "01", "fill": {"r": 140, "g": 125, "b": 232}},
+            {"guid": "02", "fill": {"r": 125, "g": 219, "b": 232}},
+        ]
+    },
+)
+sdk.catalog_appearance.create_color_palette(palette)
+
+# Clean up
+sdk.catalog_appearance.delete_theme("my_dark_theme")
+sdk.catalog_appearance.delete_color_palette("my_palette")
+```

docs/content/en/latest/administration/appearance/create_color_palette.md

@@ -0,0 +1,20 @@
+---
+title: "create_color_palette"
+linkTitle: "create_color_palette"
+superheading: "catalog_appearance."
+weight: 220
+---
+
+``create_color_palette( color_palette: CatalogColorPalette ) -> None``
+
+Create a new color palette.
+
+## Parameters
+
+| parameter |	type | description |
+| -- | -- | -- |
+| color_palette | CatalogColorPalette | A catalog color palette object to be created. |
+
+## Returns
+
+_None_

docs/content/en/latest/administration/appearance/create_theme.md

@@ -0,0 +1,20 @@
+---
+title: "create_theme"
+linkTitle: "create_theme"
+superheading: "catalog_appearance."
+weight: 120
+---
+
+``create_theme( theme: CatalogTheme ) -> None``
+
+Create a new theme.
+
+## Parameters
+
+| parameter |	type | description |
+| -- | -- | -- |
+| theme | CatalogTheme | A catalog theme object to be created. |
+
+## Returns
+
+_None_

docs/content/en/latest/administration/appearance/delete_color_palette.md

@@ -0,0 +1,26 @@
+---
+title: "delete_color_palette"
+linkTitle: "delete_color_palette"
+superheading: "catalog_appearance."
+weight: 240
+---
+
+``delete_color_palette( color_palette_id: str ) -> None``
+
+Delete a color palette.
+
+## Parameters
+
+| parameter |	type | description |
+| -- | -- | -- |
+| color_palette_id | str | Color palette identification string e.g. "my_palette" |
+
+## Returns
+
+_None_
+
+## Raises
+
+| type | description |
+| -- | -- |
+| ValueError | Color palette does not exist. |

docs/content/en/latest/administration/appearance/delete_theme.md

@@ -0,0 +1,26 @@
+---
+title: "delete_theme"
+linkTitle: "delete_theme"
+superheading: "catalog_appearance."
+weight: 140
+---
+
+``delete_theme( theme_id: str ) -> None``
+
+Delete a theme.
+
+## Parameters
+
+| parameter |	type | description |
+| -- | -- | -- |
+| theme_id | str | Theme identification string e.g. "my_dark_theme" |
+
+## Returns
+
+_None_
+
+## Raises
+
+| type | description |
+| -- | -- |
+| ValueError | Theme does not exist. |

docs/content/en/latest/administration/appearance/get_color_palette.md

@@ -0,0 +1,22 @@
+---
+title: "get_color_palette"
+linkTitle: "get_color_palette"
+superheading: "catalog_appearance."
+weight: 210
+---
+
+``get_color_palette( color_palette_id: str ) -> CatalogColorPalette``
+
+Get an individual color palette.
+
+## Parameters
+
+| parameter |	type | description |
+| -- | -- | -- |
+| color_palette_id | str | Color palette identification string e.g. "my_palette" |
+
+## Returns
+
+| type |	description |
+| -- | -- |
+| CatalogColorPalette	| Catalog color palette object containing structure of the color palette. |

docs/content/en/latest/administration/appearance/get_theme.md

@@ -0,0 +1,22 @@
+---
+title: "get_theme"
+linkTitle: "get_theme"
+superheading: "catalog_appearance."
+weight: 110
+---
+
+``get_theme( theme_id: str ) -> CatalogTheme``
+
+Get an individual theme.
+
+## Parameters
+
+| parameter |	type | description |
+| -- | -- | -- |
+| theme_id | str | Theme identification string e.g. "my_dark_theme" |
+
+## Returns
+
+| type |	description |
+| -- | -- |
+| CatalogTheme	| Catalog theme object containing structure of the theme. |

docs/content/en/latest/administration/appearance/list_color_palettes.md

@@ -0,0 +1,20 @@
+---
+title: "list_color_palettes"
+linkTitle: "list_color_palettes"
+superheading: "catalog_appearance."
+weight: 200
+---
+
+``list_color_palettes( ) -> list[CatalogColorPalette]``
+
+Returns a list of all color palettes in the current organization.
+
+## Parameters
+
+_None_
+
+## Returns
+
+| type |	description |
+| -- | -- |
+| list[CatalogColorPalette]	| List of color palettes in the current organization. |

docs/content/en/latest/administration/appearance/list_themes.md

@@ -0,0 +1,20 @@
+---
+title: "list_themes"
+linkTitle: "list_themes"
+superheading: "catalog_appearance."
+weight: 100
+---
+
+``list_themes( ) -> list[CatalogTheme]``
+
+Returns a list of all themes in the current organization.
+
+## Parameters
+
+_None_
+
+## Returns
+
+| type |	description |
+| -- | -- |
+| list[CatalogTheme]	| List of themes in the current organization. |

docs/content/en/latest/administration/appearance/update_color_palette.md

@@ -0,0 +1,26 @@
+---
+title: "update_color_palette"
+linkTitle: "update_color_palette"
+superheading: "catalog_appearance."
+weight: 230
+---
+
+``update_color_palette( color_palette: CatalogColorPalette ) -> None``
+
+Update a color palette.
+
+## Parameters
+
+| parameter |	type | description |
+| -- | -- | -- |
+| color_palette | CatalogColorPalette | A catalog color palette object to be updated. |
+
+## Returns
+
+_None_
+
+## Raises
+
+| type | description |
+| -- | -- |
+| ValueError | Color palette does not exist. |