feat: release v2.1.21 | Integrate public foundry sdk with fdt authentication (#112)

* add optional public foundry sdk dependency

* add public foundry sdk dependency group

* add support for creating public sdk clients from existing foundry dev tools context

* foundryclient host expects string

* add three test cases for new integration

* add example for public api -> polars DF

* add fakemodule wrapper around foundry_sdk

* (fix)add example for public api -> polars DF

* add testcase for fakemodule handling

* clean up and address PR comments

* fix ide autocomplete (https://github.com/emdgroup/foundry-dev-tools/pull/112\#discussion_r2469524144)

* simplify examples with real module imports

* feat: release v2.1.21

Author: nmohr192

docs/changelog.md

@@ -5,6 +5,11 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog],
 and this project adheres to [Semantic Versioning].
 
+## [2.1.21] - 2025-10-28
+
+## Added
+- add official foundry-platform-sdk support under FoundryContext for public v2 APIs (#112)
+
 ## [2.1.20] - 2025-10-24
 
 ## Added

libs/foundry-dev-tools/pyproject.toml

@@ -47,7 +47,8 @@ git-credential-foundry = "foundry_dev_tools.cli.git_credential_foundry:_helper"
 
 [project.optional-dependencies]
 s3 = ["aiobotocore[boto3]"]
-full = ["foundry-dev-tools-transforms", "foundry-dev-tools[s3]"]
+public = ["foundry-platform-sdk"]
+full = ["foundry-dev-tools-transforms", "foundry-dev-tools[s3]", "foundry-dev-tools[public]"]
 
 [project.urls]
 Homepage = "https://emdgroup.github.io/foundry-dev-tools"

libs/foundry-dev-tools/src/foundry_dev_tools/_optional/foundry_platform_sdk.py

@@ -0,0 +1,13 @@
+from __future__ import annotations
+
+try:
+    import foundry_sdk
+    import foundry_sdk.v2
+
+    foundry_sdk.__fake__ = False
+except ImportError:
+    from foundry_dev_tools._optional import FakeModule
+
+    foundry_sdk = FakeModule("foundry_sdk")
+
+__all__ = ["foundry_sdk"]

libs/foundry-dev-tools/src/foundry_dev_tools/config/context.py

@@ -33,6 +33,8 @@
 from foundry_dev_tools.utils.config import entry_point_fdt_api_client
 
 if TYPE_CHECKING:
+    from foundry_sdk.v2 import FoundryClient as FoundrySdkV2Client
+
     from foundry_dev_tools.cached_foundry_client import CachedFoundryClient
     from foundry_dev_tools.config.config_types import Host, Token
     from foundry_dev_tools.config.token_provider import TokenProvider
@@ -184,6 +186,29 @@ def foundry_rest_client(self) -> FoundryRestClient:
 
         return FoundryRestClient(ctx=self)
 
+    @cached_property
+    def public_client_v2(self) -> FoundrySdkV2Client:
+        """Returns :py:class:`foundry_sdk.v2.FoundryClient`.
+
+        Uses fdt context to integrate with the official foundry-platform-sdk.
+
+        Examples:
+            >>> import polars as pl
+            >>> import pyarrow as pa
+
+            >>> pub_client = ctx.public_client_v2
+            >>> ds = pub_client.datasets.Dataset.read_table(rid, format="ARROW")
+            >>> pa_df = pa.ipc.open_stream(ds).read_all()
+            >>> polars_df = pl.from_arrow(pa_df)
+        """
+        from foundry_dev_tools._optional.foundry_platform_sdk import foundry_sdk
+        from foundry_dev_tools.public_sdk.auth import FoundryDevToolsAuth
+
+        return foundry_sdk.v2.FoundryClient(
+            auth=FoundryDevToolsAuth(self),
+            hostname=self.host.domain,
+        )
+
     def get_dataset(
         self,
         rid: api_types.Rid,

libs/foundry-dev-tools/src/foundry_dev_tools/public_sdk/__init__.py

@@ -0,0 +1,10 @@
+"""Integration utilities for foundry-platform-sdk."""
+
+from __future__ import annotations
+
+from foundry_dev_tools.public_sdk.auth import FoundryDevToolsAuth, FoundryDevToolsToken
+
+__all__ = [
+    "FoundryDevToolsAuth",
+    "FoundryDevToolsToken",
+]

libs/foundry-dev-tools/src/foundry_dev_tools/public_sdk/auth.py

@@ -0,0 +1,85 @@
+"""Auth adapters for integrating FoundryDevTools with foundry-platform-sdk."""
+
+from __future__ import annotations
+
+from abc import ABC, abstractmethod
+from typing import TYPE_CHECKING, TypeVar
+
+from foundry_dev_tools._optional.foundry_platform_sdk import foundry_sdk
+
+if TYPE_CHECKING:
+    from collections.abc import Callable
+
+    from foundry_dev_tools.config.context import FoundryContext
+
+
+class Token(ABC):
+    """Reimplementation of the private foundry_sdk Token interface."""
+
+    @property
+    @abstractmethod
+    def access_token(self) -> str:  # noqa: D102
+        pass
+
+
+T = TypeVar("T")
+
+
+class FoundryDevToolsToken(Token):
+    """Token adapter that implements the foundry_sdk Token interface."""
+
+    def __init__(self, token: str) -> None:
+        """Initialize the token wrapper.
+
+        Args:
+            token (str): The access token string
+        """
+        self._token = token
+
+    @property
+    def access_token(self) -> str:
+        """Return the access token.
+
+        Returns:
+            str: The access token
+        """
+        return self._token
+
+
+class FoundryDevToolsAuth(foundry_sdk.Auth):
+    """Auth adapter that bridges FoundryContext with foundry-platform-sdk."""
+
+    def __init__(self, ctx: FoundryContext) -> None:
+        """Initialize the auth adapter.
+
+        Args:
+            ctx: The FoundryContext instance to use for authentication
+        """
+        self._ctx: FoundryContext = ctx
+
+    def get_token(self) -> FoundryDevToolsToken:
+        """Get the current token from the FoundryContext.
+
+        Returns:
+            FoundryDevToolsToken: The wrapped access token
+        """
+        return FoundryDevToolsToken(self._ctx.token)
+
+    def execute_with_token(self, func: Callable[[FoundryDevToolsToken], T]) -> T:
+        """Execute a function with the current token.
+
+        Args:
+            func: Function to execute with the token
+
+        Returns:
+            T: The return value of the function
+        """
+        return func(self.get_token())
+
+    def run_with_token(self, func: Callable[[FoundryDevToolsToken], T]) -> None:
+        """Run a function with the current token without returning a value.
+
+        Args:
+            func: Function to run with the token
+        """
+        func(self.get_token())