feat: add create_with_options and export Execution

- there's no way to pass executions_cancellable without a config file right now
- we cannot extend .create without a breaking change for the variadic argument
- that's why create_with_options is added

- Execution() instances are needed for the new cancelation method

risk: high

Author: fiedlr

Diff for: gooddata-sdk/gooddata_sdk/__init__.py

@@ -231,6 +231,7 @@
 from gooddata_sdk.compute.model.base import ExecModelEntity, ObjId
 from gooddata_sdk.compute.model.execution import (
     BareExecutionResponse,
+    Execution,
     ExecutionDefinition,
     ExecutionResponse,
     ExecutionResult,

Diff for: gooddata-sdk/gooddata_sdk/sdk.py

@@ -2,7 +2,7 @@
 from __future__ import annotations
 
 from pathlib import Path
-from typing import Optional
+from typing import Any, Optional
 
 from gooddata_sdk.catalog.data_source.service import CatalogDataSourceService
 from gooddata_sdk.catalog.export.service import ExportService
@@ -22,6 +22,21 @@
 class GoodDataSdk:
     """Top-level class that wraps all the functionality together."""
 
+    @classmethod
+    def create_with_options(cls, options: dict[str, Any]):
+        """
+        Initialize the SDK with the given options for GoodDataApiClient.
+
+        Args:
+            options (dict):
+                Options dictionary to be passed to the GooddataApiClient constructor.
+
+        Returns:
+            GoodDataSdk:
+                Initialized SDK.
+        """
+        return cls(GoodDataApiClient(**options))
+
     @classmethod
     def create_from_profile(cls, profile: str = "default", profiles_path: Path = PROFILES_FILE_PATH) -> GoodDataSdk:
         """Convenient method to initialize the SDK from config file.
@@ -36,9 +51,7 @@ def create_from_profile(cls, profile: str = "default", profiles_path: Path = PRO
             GoodDataSdk:
                 Initialized SDK.
         """
-        content = profile_content(profile, profiles_path)
-        client = GoodDataApiClient(**content)
-        return cls(client)
+        return cls.create_with_options(profile_content(profile, profiles_path))
 
     @classmethod
     def create(
@@ -56,8 +69,9 @@ def create(
         This is preferred way of creating GoodDataSdk, when no tweaks are needed.
         """
         filtered_headers = {key: value for key, value in custom_headers_.items() if value is not None}
-        client = GoodDataApiClient(host_, token_, custom_headers=filtered_headers, extra_user_agent=extra_user_agent_)
-        return cls(client)
+        return cls.create_with_options(
+            {"host": host_, "token": token_, "custom_headers": filtered_headers, "extra_user_agent": extra_user_agent_}
+        )
 
     def __init__(self, client: GoodDataApiClient) -> None:
         """Take instance of GoodDataApiClient and return new GoodDataSdk instance.