atlan-application-sdk 0.1.1rc27__tar.gz → 0.1.1rc29__tar.gz

atlan_application_sdk-0.1.1rc29/.github/release_notes.md

@@ -0,0 +1,11 @@
+## v0.1.1rc29 (August 13, 2025)
+
+Full Changelog: https://github.com/atlanhq/application-sdk/compare/v0.1.1rc28...v0.1.1rc29
+
+### Features
+
+- increase DAPR gRPC message limit from 16MB to 100MB (#649) (by @Nishchith Shetty in [ae0d218](https://github.com/atlanhq/application-sdk/commit/ae0d218))
+
+### Bug Fixes
+
+- error logs for eventstore, objectstore and metrics (#647) (by @Nishchith Shetty in [70b71b6](https://github.com/atlanhq/application-sdk/commit/70b71b6))

{atlan_application_sdk-0.1.1rc27 → atlan_application_sdk-0.1.1rc29}/.github/workflows/codeql.yaml

@@ -25,7 +25,7 @@ jobs:
         language: ["python"]
     steps:
       - name: Checkout repository
-        uses: actions/checkout@v4
+        uses: actions/checkout@v5
       - name: Initialize CodeQL
         uses: github/codeql-action/init@v3
         with:
@@ -43,6 +43,6 @@ jobs:
     name: Pre-commit Checks
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
       - uses: "./.github/actions/setup-deps"
       - uses: pre-commit/action@v3.0.1

{atlan_application_sdk-0.1.1rc27 → atlan_application_sdk-0.1.1rc29}/.github/workflows/pre-release.yaml

@@ -18,7 +18,7 @@ jobs:
 
     steps:
       - name: Checkout code
-        uses: actions/checkout@v3
+        uses: actions/checkout@v5
         with:
           fetch-depth: 0  # Need full history for changelog
 

{atlan_application_sdk-0.1.1rc27 → atlan_application_sdk-0.1.1rc29}/.github/workflows/pull_request.yaml

@@ -19,7 +19,7 @@ jobs:
     name: Conventional Commits
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
         with:
           fetch-depth: 0
       - uses: webiny/action-conventional-commits@v1.3.0
@@ -30,7 +30,7 @@ jobs:
     name: Docstring Coverage
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
       - uses: "./.github/actions/docstring-coverage"
         with:
           module-name: application_sdk
@@ -41,7 +41,7 @@ jobs:
     name: Trivy Code Scan
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
       - uses: "./.github/actions/trivy"
         with:
           add-report-comment-to-pr: "true"
@@ -57,7 +57,7 @@ jobs:
         python-version: ["3.11", "3.12", "3.13"]
         os: [ubuntu-22.04, macOS-latest, windows-latest]
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
       - uses: "./.github/actions/unit-tests"
         with:
           github-token: ${{ secrets.ORG_PAT_GITHUB }}
@@ -71,7 +71,7 @@ jobs:
       matrix: ${{ steps.set-matrix.outputs.matrix }}
     steps:
       - name: Checkout repository
-        uses: actions/checkout@v4
+        uses: actions/checkout@v5
 
       - name: Get PR Labels
         id: get-labels
@@ -150,7 +150,7 @@ jobs:
       matrix:
         os: [ubuntu-22.04, macOS-latest, windows-latest]
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
       - uses: "./.github/actions/e2e-examples"
         with:
           operating-system: ${{ matrix.os }}
@@ -170,7 +170,7 @@ jobs:
       fail-fast: false
       matrix: ${{ fromJson(needs.matrix-builder.outputs.matrix) }}
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
       - uses: "./.github/actions/e2e-apps"
         with:
           github-token: ${{ secrets.ORG_PAT_GITHUB }}
@@ -182,7 +182,7 @@ jobs:
     name: Docs
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
       - uses: "./.github/actions/setup-deps"
       - name: Install graphviz
         run: |

{atlan_application_sdk-0.1.1rc27 → atlan_application_sdk-0.1.1rc29}/.github/workflows/push.yaml

@@ -20,7 +20,7 @@ jobs:
     name: Unit Tests
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
       - uses: "./.github/actions/unit-tests"
         with:
           github-token: ${{ secrets.ORG_PAT_GITHUB }}
@@ -30,7 +30,7 @@ jobs:
     name: E2E (Examples)
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
       - uses: "./.github/actions/e2e-examples"
         with:
           operating-system: ubuntu-latest
@@ -48,7 +48,7 @@ jobs:
       matrix:
         repo_name: ["atlan-postgres-app"]
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
       - uses: "./.github/actions/e2e-apps"
         with:
           github-token: ${{ secrets.ORG_PAT_GITHUB }}
@@ -60,7 +60,7 @@ jobs:
     name: Docs
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
       - uses: "./.github/actions/setup-deps"
       - name: Install graphviz
         run: |

{atlan_application_sdk-0.1.1rc27 → atlan_application_sdk-0.1.1rc29}/.github/workflows/scale-tests.yaml

@@ -23,7 +23,7 @@ jobs:
     timeout-minutes: 15
 
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
         with:
           fetch-depth: 0
 

{atlan_application_sdk-0.1.1rc27 → atlan_application_sdk-0.1.1rc29}/.github/workflows/schedule.yaml

@@ -27,5 +27,5 @@ jobs:
     name: Trivy Code Scan
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
       - uses: "./.github/actions/trivy"

{atlan_application_sdk-0.1.1rc27 → atlan_application_sdk-0.1.1rc29}/.github/workflows/tag-and-publish.yaml

@@ -18,7 +18,7 @@ jobs:
 
     steps:
       - name: Checkout code
-        uses: actions/checkout@v3
+        uses: actions/checkout@v5
         with:
           fetch-depth: 0  # Need full history for release notes
 

{atlan_application_sdk-0.1.1rc27 → atlan_application_sdk-0.1.1rc29}/.github/workflows/trivy-container.yaml

@@ -25,7 +25,7 @@ jobs:
     runs-on: "ubuntu-24.04"
     steps:
       - name: Checkout code
-        uses: actions/checkout@v4
+        uses: actions/checkout@v5
 
       - uses: "atlanhq/application-sdk/.github/actions/trivy-container@main"
         with:

{atlan_application_sdk-0.1.1rc27 → atlan_application_sdk-0.1.1rc29}/CHANGELOG.md

@@ -1,5 +1,27 @@
 # Changelog
 
+## v0.1.1rc29 (August 13, 2025)
+
+Full Changelog: https://github.com/atlanhq/application-sdk/compare/v0.1.1rc28...v0.1.1rc29
+
+### Features
+
+- increase DAPR gRPC message limit from 16MB to 100MB (#649) (by @Nishchith Shetty in [ae0d218](https://github.com/atlanhq/application-sdk/commit/ae0d218))
+
+### Bug Fixes
+
+- error logs for eventstore, objectstore and metrics (#647) (by @Nishchith Shetty in [70b71b6](https://github.com/atlanhq/application-sdk/commit/70b71b6))
+
+
+
+## v0.1.1rc28 (August 12, 2025)
+
+Full Changelog: https://github.com/atlanhq/application-sdk/compare/v0.1.1rc27...v0.1.1rc28
+
+### Features
+
+- add pyatlan Client to Application SDK (#642) (by @Ernest Hill in [c00d682](https://github.com/atlanhq/application-sdk/commit/c00d682))
+
 ## v0.1.1rc27 (August 12, 2025)
 
 Full Changelog: https://github.com/atlanhq/application-sdk/compare/v0.1.1rc26...v0.1.1rc27

{atlan_application_sdk-0.1.1rc27 → atlan_application_sdk-0.1.1rc29}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: atlan-application-sdk
-Version: 0.1.1rc27
+Version: 0.1.1rc29
 Summary: Atlan Application SDK is a Python library for developing applications on the Atlan Platform
 Project-URL: Repository, https://github.com/atlanhq/application-sdk
 Project-URL: Documentation, https://github.com/atlanhq/application-sdk/README.md
@@ -26,7 +26,7 @@ Requires-Dist: fastapi[standard]>=0.115.0
 Requires-Dist: loguru>=0.7.3
 Requires-Dist: opentelemetry-exporter-otlp>=1.27.0
 Requires-Dist: psutil>=7.0.0
-Requires-Dist: pyatlan>=7.1.1
+Requires-Dist: pyatlan>=7.1.6
 Requires-Dist: pydantic>=2.10.6
 Requires-Dist: python-dotenv>=1.1.0
 Requires-Dist: uvloop>=0.21.0; sys_platform != 'win32'

atlan_application_sdk-0.1.1rc29/application_sdk/clients/atlan_client.py

@@ -0,0 +1,70 @@
+from typing import Optional
+
+from pyatlan.client.atlan import AtlanClient
+
+from application_sdk.common.error_codes import ClientError
+from application_sdk.constants import (
+    ATLAN_API_KEY,
+    ATLAN_API_TOKEN_GUID,
+    ATLAN_BASE_URL,
+    ATLAN_CLIENT_ID,
+    ATLAN_CLIENT_SECRET,
+)
+from application_sdk.observability.logger_adaptor import get_logger
+
+logger = get_logger(__name__)
+
+
+def get_client(
+    base_url: Optional[str] = None,
+    api_key: Optional[str] = None,
+    api_token_guid: Optional[str] = None,
+) -> AtlanClient:
+    """
+    Returns an authenticated AtlanClient instance using provided parameters or environment variables.
+
+    Selects authentication method based on the presence of parameters or environment variables and validates the required configuration.
+    In general, the use of environment variables is recommended. Any parameters specified will override the environment variables.
+
+    Args:
+    base_url: Atlan base URL (overrides ATLAN_BASE_URL)
+    api_key: Atlan API key (overrides ATLAN_API_KEY)
+    api_token_guid: API token GUID (overrides API_TOKEN_GUID)
+    """
+    # Resolve final values (parameters override env vars)
+    final_token_guid = api_token_guid or ATLAN_API_TOKEN_GUID
+    final_base_url = base_url or ATLAN_BASE_URL
+    final_api_key = api_key or ATLAN_API_KEY
+
+    # Priority 1: Token-based auth (recommended for production)
+    if final_token_guid:
+        if final_base_url or final_api_key:  # Check original params, not env vars
+            logger.warning(
+                "Token auth takes precedence - ignoring base_url/api_key parameters as well as ATLAN_BASE_URL and ATLAN_API_KEY environment variables."
+            )
+        return _get_client_from_token(final_token_guid)
+
+    # Priority 2: API key + base URL auth
+    if not final_base_url:
+        raise ClientError(
+            "ATLAN_BASE_URL is required (via parameter or environment variable)"
+        )
+    if not final_api_key:
+        raise ClientError(
+            "ATLAN_API_KEY is required (via parameter or environment variable)"
+        )
+
+    logger.info("Using API key-based authentication")
+    return AtlanClient(base_url=final_base_url, api_key=final_api_key)
+
+
+def _get_client_from_token(api_token_guid: str):
+    if not ATLAN_CLIENT_ID:
+        raise ClientError(
+            f"{ClientError.AUTH_CONFIG_ERROR}: Environment variable CLIENT_ID is required when API_TOKEN_GUID is set."
+        )
+    if not ATLAN_CLIENT_SECRET:
+        raise ClientError(
+            f"{ClientError.AUTH_CONFIG_ERROR}: Environment variable CLIENT_SECRET is required when API_TOKEN_GUID is set."
+        )
+    return AtlanClient.from_token_guid(guid=api_token_guid)

atlan_application_sdk-0.1.1rc29/application_sdk/common/dapr_utils.py

@@ -0,0 +1,32 @@
+from dapr import clients
+
+from application_sdk.observability.logger_adaptor import get_logger
+
+logger = get_logger(__name__)
+
+
+def is_component_registered(component_name: str) -> bool:
+    """Check if a DAPR component with the given name is registered.
+
+    Args:
+        component_name: Name of the component to check.
+
+    Returns:
+        True if the component is present, False otherwise or on metadata errors.
+    """
+    try:
+        with clients.DaprClient() as client:
+            metadata = client.get_metadata()
+            # Each registered component has fields: name, type (e.g., "eventstore")
+            for component in getattr(metadata, "registered_components", []):
+                if component.name == component_name:
+                    return True
+            return False
+    except Exception:
+        # If we cannot read metadata, behave conservatively and report unavailable
+        logger.warning(
+            "Failed to read Dapr metadata for component availability check; treating as unavailable",
+            exc_info=True,
+            extra={"component_name": component_name},
+        )
+        return False

{atlan_application_sdk-0.1.1rc27 → atlan_application_sdk-0.1.1rc29}/application_sdk/constants.py

@@ -131,9 +131,9 @@ EVENT_STORE_NAME = os.getenv("EVENT_STORE_NAME", "eventstore")
 #: Whether to enable Atlan storage upload
 ENABLE_ATLAN_UPLOAD = os.getenv("ENABLE_ATLAN_UPLOAD", "false").lower() == "true"
 # Dapr Client Configuration
-#: Maximum gRPC message length in bytes for Dapr client (default: 16MB)
+#: Maximum gRPC message length in bytes for Dapr client (default: 100MB)
 DAPR_MAX_GRPC_MESSAGE_LENGTH = int(
-    os.getenv("DAPR_MAX_GRPC_MESSAGE_LENGTH", "16777216")
+    os.getenv("DAPR_MAX_GRPC_MESSAGE_LENGTH", "104857600")
 )
 #: Name of the deployment secret store component in DAPR
 DEPLOYMENT_SECRET_STORE_NAME = os.getenv(
@@ -217,3 +217,10 @@ TRACES_FILE_NAME = "traces.parquet"
 ENABLE_OBSERVABILITY_DAPR_SINK = (
     os.getenv("ATLAN_ENABLE_OBSERVABILITY_DAPR_SINK", "false").lower() == "true"
 )
+
+# atlan_client configuration (non ATLAN_ prefix are rooted in pyatlan SDK, to be revisited)
+ATLAN_API_TOKEN_GUID = os.getenv("API_TOKEN_GUID")
+ATLAN_BASE_URL = os.getenv("ATLAN_BASE_URL")
+ATLAN_API_KEY = os.getenv("ATLAN_API_KEY")
+ATLAN_CLIENT_ID = os.getenv("CLIENT_ID")
+ATLAN_CLIENT_SECRET = os.getenv("CLIENT_SECRET")

{atlan_application_sdk-0.1.1rc27 → atlan_application_sdk-0.1.1rc29}/application_sdk/handlers/sql.py

@@ -116,7 +116,7 @@ class BaseSQLHandler(HandlerInterface):
     async def fetch_metadata(
         self,
         metadata_type: Optional[str] = None,
-        database: Optional[str] = None,
+        database: str = "",
     ) -> List[Dict[str, str]]:
         """
         Fetch metadata based on the requested type.

{atlan_application_sdk-0.1.1rc27 → atlan_application_sdk-0.1.1rc29}/application_sdk/inputs/statestore.py

@@ -76,6 +76,7 @@ class StateStoreInput:
         state = {}
 
         try:
+            logger.info(f"Trying to download state object for {id} with type {type}")
             local_state_file_path = os.path.join(TEMPORARY_PATH, state_file_path)
             ObjectStoreInput.download_file_from_object_store(
                 download_file_prefix=TEMPORARY_PATH,
@@ -86,10 +87,11 @@ class StateStoreInput:
             with open(local_state_file_path, "r") as file:
                 state = json.load(file)
 
+            logger.info(f"State object downloaded for {id} with type {type}")
         except Exception as e:
             # local error message is "file not found", while in object store it is "object not found"
             if "not found" in str(e).lower():
-                logger.debug(
+                logger.info(
                     f"No state found for {type.value} with id '{id}', returning empty dict"
                 )
             else:

{atlan_application_sdk-0.1.1rc27 → atlan_application_sdk-0.1.1rc29}/application_sdk/outputs/eventstore.py

@@ -14,6 +14,7 @@ from dapr import clients
 from pydantic import BaseModel, Field
 from temporalio import activity, workflow
 
+from application_sdk.common.dapr_utils import is_component_registered
 from application_sdk.constants import APPLICATION_NAME, EVENT_STORE_NAME
 from application_sdk.observability.logger_adaptor import get_logger
 
@@ -155,6 +156,11 @@ class EventStore:
         Example:
             >>> EventStore.create_generic_event(Event(event_type="test", data={"test": "test"}))
         """
+        if not is_component_registered(EVENT_STORE_NAME):
+            logger.warning(
+                "Skipping event publish because event store component is not registered",
+            )
+            return
         try:
             if enrich_metadata:
                 event = cls.enrich_event_metadata(event)

{atlan_application_sdk-0.1.1rc27 → atlan_application_sdk-0.1.1rc29}/application_sdk/outputs/statestore.py

@@ -84,8 +84,8 @@ class StateStoreOutput:
             >>> from application_sdk.outputs.statestore import StateStoreOutput
             >>> await StateStoreOutput.save_state_object("wf-123", {"test": "test"}, "workflow")
         """
-
         try:
+            logger.info(f"Saving state object for {id} with type {type}")
             # get the current state from object store
             current_state = StateStoreInput.get_state(id, type)
             state_file_path = build_state_store_path(id, type)
@@ -106,7 +106,7 @@ class StateStoreOutput:
                 file_path=local_state_file_path,
                 object_store_name=UPSTREAM_OBJECT_STORE_NAME,
             )
-
+            logger.info(f"State object saved for {id} with type {type}")
             return current_state
         except Exception as e:
             logger.error(f"Failed to store state: {str(e)}")

{atlan_application_sdk-0.1.1rc27 → atlan_application_sdk-0.1.1rc29}/application_sdk/server/fastapi/__init__.py

@@ -493,7 +493,7 @@ class APIServer(ServerInterface):
         metrics = get_metrics()
 
         metadata_type = body.root.get("type", "all")
-        database = body.root.get("database", None)
+        database = body.root.get("database", "")
 
         try:
             if not self.handler:

{atlan_application_sdk-0.1.1rc27 → atlan_application_sdk-0.1.1rc29}/application_sdk/version.py

@@ -2,4 +2,4 @@
 Version information for the application_sdk package.
 """
 
-__version__ = "0.1.1rc27"
+__version__ = "0.1.1rc29"

{atlan_application_sdk-0.1.1rc27 → atlan_application_sdk-0.1.1rc29}/docs/docs/concepts/outputs.md

@@ -21,7 +21,7 @@ This module provides a standardized way to write data to various destinations wi
     *   **`SecretStoreOutput` (`secretstore.py`)**: Saves sensitive data (like credentials) securely, typically via the StateStore using a Dapr binding.
     *   **`StateStoreOutput` (`statestore.py`)**: Saves configuration or state data to the configured Dapr state store binding.
     *   **`IcebergOutput` (`iceberg.py`)**: Writes DataFrames to Apache Iceberg tables.
-    *   **`EventStore` (`eventstore.py`)**: Publishes events (like workflow/activity start/end) to a configured Dapr pub/sub binding.
+    *   **`EventStore` (`eventstore.py`)**: Publishes events (like workflow/activity start/end) to a configured Dapr eventstore binding. Before publishing, it performs a preflight check via the Dapr Metadata API to verify that the configured eventstore component exists; if not, it skips publishing and logs a warning with context.
 
 ## `JsonOutput` (`json.py`)
 

{atlan_application_sdk-0.1.1rc27 → atlan_application_sdk-0.1.1rc29}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "atlan-application-sdk"
-version = "0.1.1rc27"
+version = "0.1.1rc29"
 description = "Atlan Application SDK is a Python library for developing applications on the Atlan Platform"
 license = "Apache-2.0"
 authors = [
@@ -24,7 +24,7 @@ dependencies = [
     "opentelemetry-exporter-otlp>=1.27.0",
     "psutil>=7.0.0",
     "fastapi[standard]>=0.115.0",
-    "pyatlan>=7.1.1",
+    "pyatlan>=7.1.6",
     "pydantic>=2.10.6",
     "loguru>=0.7.3",
     "uvloop>=0.21.0; sys_platform != 'win32'",