udl-sdk 0.1.0a16__tar.gz → 0.1.0a17__tar.gz

udl_sdk-0.1.0a17/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "0.1.0-alpha.17"
+}

{udl_sdk-0.1.0a16 → udl_sdk-0.1.0a17}/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.1.0-alpha.17 (2025-08-01)
+
+Full Changelog: [v0.1.0-alpha.16...v0.1.0-alpha.17](https://github.com/Bluestaq/udl-python-sdk/compare/v0.1.0-alpha.16...v0.1.0-alpha.17)
+
+### Features
+
+* **api:** support for Bearer Auth ([57928c5](https://github.com/Bluestaq/udl-python-sdk/commit/57928c5b6f0b09a0d32cd80112e216b6f5be6d61))
+
 ## 0.1.0-alpha.16 (2025-07-31)
 
 Full Changelog: [v0.1.0-alpha.15...v0.1.0-alpha.16](https://github.com/Bluestaq/udl-python-sdk/compare/v0.1.0-alpha.15...v0.1.0-alpha.16)

{udl_sdk-0.1.0a16 → udl_sdk-0.1.0a17}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: udl-sdk
-Version: 0.1.0a16
+Version: 0.1.0a17
 Summary: The official Python library for the unifieddatalibrary API
 Project-URL: Homepage, https://github.com/Bluestaq/udl-python-sdk
 Project-URL: Repository, https://github.com/Bluestaq/udl-python-sdk

{udl_sdk-0.1.0a16 → udl_sdk-0.1.0a17}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "udl-sdk"
-version = "0.1.0-alpha.16"
+version = "0.1.0-alpha.17"
 description = "The official Python library for the unifieddatalibrary API"
 dynamic = ["readme"]
 license = "Apache-2.0"

{udl_sdk-0.1.0a16 → udl_sdk-0.1.0a17}/src/unifieddatalibrary/_client.py

@@ -14,6 +14,7 @@ from ._qs import Querystring
 from ._types import (
     NOT_GIVEN,
     Omit,
+    Headers,
     Timeout,
     NotGiven,
     Transport,
@@ -117,7 +118,7 @@ from .resources import (
     seradata_spacecraft_details,
 )
 from ._streaming import Stream as Stream, AsyncStream as AsyncStream
-from ._exceptions import APIStatusError, UnifieddatalibraryError
+from ._exceptions import APIStatusError
 from ._base_client import (
     DEFAULT_MAX_RETRIES,
     SyncAPIClient,
@@ -377,14 +378,16 @@ class Unifieddatalibrary(SyncAPIClient):
     with_streaming_response: UnifieddatalibraryWithStreamedResponse
 
     # client options
-    password: str
-    username: str
+    password: str | None
+    username: str | None
+    access_token: str | None
 
     def __init__(
         self,
         *,
         password: str | None = None,
         username: str | None = None,
+        access_token: str | None = None,
         base_url: str | httpx.URL | None = None,
         timeout: Union[float, Timeout, None, NotGiven] = NOT_GIVEN,
         max_retries: int = DEFAULT_MAX_RETRIES,
@@ -409,23 +412,20 @@ class Unifieddatalibrary(SyncAPIClient):
         This automatically infers the following arguments from their corresponding environment variables if they are not provided:
         - `password` from `UDL_AUTH_PASSWORD`
         - `username` from `UDL_AUTH_USERNAME`
+        - `access_token` from `UDL_ACCESS_TOKEN`
         """
         if password is None:
             password = os.environ.get("UDL_AUTH_PASSWORD")
-        if password is None:
-            raise UnifieddatalibraryError(
-                "The password client option must be set either by passing password to the client or by setting the UDL_AUTH_PASSWORD environment variable"
-            )
         self.password = password
 
         if username is None:
             username = os.environ.get("UDL_AUTH_USERNAME")
-        if username is None:
-            raise UnifieddatalibraryError(
-                "The username client option must be set either by passing username to the client or by setting the UDL_AUTH_USERNAME environment variable"
-            )
         self.username = username
 
+        if access_token is None:
+            access_token = os.environ.get("UDL_ACCESS_TOKEN")
+        self.access_token = access_token
+
         if base_url is None:
             base_url = os.environ.get("UNIFIEDDATALIBRARY_BASE_URL")
         self._base_url_overridden = base_url is not None
@@ -618,10 +618,25 @@ class Unifieddatalibrary(SyncAPIClient):
     @property
     @override
     def auth_headers(self) -> dict[str, str]:
+        return {**self._basic_auth, **self._bearer_auth}
+
+    @property
+    def _basic_auth(self) -> dict[str, str]:
+        if self.username is None:
+            return {}
+        if self.password is None:
+            return {}
         credentials = f"{self.username}:{self.password}".encode("ascii")
         header = f"Basic {base64.b64encode(credentials).decode('ascii')}"
         return {"Authorization": header}
 
+    @property
+    def _bearer_auth(self) -> dict[str, str]:
+        access_token = self.access_token
+        if access_token is None:
+            return {}
+        return {"Authorization": f"Bearer {access_token}"}
+
     @property
     @override
     def default_headers(self) -> dict[str, str | Omit]:
@@ -631,11 +646,28 @@ class Unifieddatalibrary(SyncAPIClient):
             **self._custom_headers,
         }
 
+    @override
+    def _validate_headers(self, headers: Headers, custom_headers: Headers) -> None:
+        if self.username and self.password and headers.get("Authorization"):
+            return
+        if isinstance(custom_headers.get("Authorization"), Omit):
+            return
+
+        if self.access_token and headers.get("Authorization"):
+            return
+        if isinstance(custom_headers.get("Authorization"), Omit):
+            return
+
+        raise TypeError(
+            '"Could not resolve authentication method. Expected either username, password or access_token to be set. Or for one of the `Authorization` or `Authorization` headers to be explicitly omitted"'
+        )
+
     def copy(
         self,
         *,
         password: str | None = None,
         username: str | None = None,
+        access_token: str | None = None,
         base_url: str | httpx.URL | None = None,
         timeout: float | Timeout | None | NotGiven = NOT_GIVEN,
         http_client: httpx.Client | None = None,
@@ -671,6 +703,7 @@ class Unifieddatalibrary(SyncAPIClient):
         client = self.__class__(
             password=password or self.password,
             username=username or self.username,
+            access_token=access_token or self.access_token,
             base_url=base_url or self.base_url,
             timeout=self.timeout if isinstance(timeout, NotGiven) else timeout,
             http_client=http_client,
@@ -889,14 +922,16 @@ class AsyncUnifieddatalibrary(AsyncAPIClient):
     with_streaming_response: AsyncUnifieddatalibraryWithStreamedResponse
 
     # client options
-    password: str
-    username: str
+    password: str | None
+    username: str | None
+    access_token: str | None
 
     def __init__(
         self,
         *,
         password: str | None = None,
         username: str | None = None,
+        access_token: str | None = None,
         base_url: str | httpx.URL | None = None,
         timeout: Union[float, Timeout, None, NotGiven] = NOT_GIVEN,
         max_retries: int = DEFAULT_MAX_RETRIES,
@@ -921,23 +956,20 @@ class AsyncUnifieddatalibrary(AsyncAPIClient):
         This automatically infers the following arguments from their corresponding environment variables if they are not provided:
         - `password` from `UDL_AUTH_PASSWORD`
         - `username` from `UDL_AUTH_USERNAME`
+        - `access_token` from `UDL_ACCESS_TOKEN`
         """
         if password is None:
             password = os.environ.get("UDL_AUTH_PASSWORD")
-        if password is None:
-            raise UnifieddatalibraryError(
-                "The password client option must be set either by passing password to the client or by setting the UDL_AUTH_PASSWORD environment variable"
-            )
         self.password = password
 
         if username is None:
             username = os.environ.get("UDL_AUTH_USERNAME")
-        if username is None:
-            raise UnifieddatalibraryError(
-                "The username client option must be set either by passing username to the client or by setting the UDL_AUTH_USERNAME environment variable"
-            )
         self.username = username
 
+        if access_token is None:
+            access_token = os.environ.get("UDL_ACCESS_TOKEN")
+        self.access_token = access_token
+
         if base_url is None:
             base_url = os.environ.get("UNIFIEDDATALIBRARY_BASE_URL")
         self._base_url_overridden = base_url is not None
@@ -1130,10 +1162,25 @@ class AsyncUnifieddatalibrary(AsyncAPIClient):
     @property
     @override
     def auth_headers(self) -> dict[str, str]:
+        return {**self._basic_auth, **self._bearer_auth}
+
+    @property
+    def _basic_auth(self) -> dict[str, str]:
+        if self.username is None:
+            return {}
+        if self.password is None:
+            return {}
         credentials = f"{self.username}:{self.password}".encode("ascii")
         header = f"Basic {base64.b64encode(credentials).decode('ascii')}"
         return {"Authorization": header}
 
+    @property
+    def _bearer_auth(self) -> dict[str, str]:
+        access_token = self.access_token
+        if access_token is None:
+            return {}
+        return {"Authorization": f"Bearer {access_token}"}
+
     @property
     @override
     def default_headers(self) -> dict[str, str | Omit]:
@@ -1143,11 +1190,28 @@ class AsyncUnifieddatalibrary(AsyncAPIClient):
             **self._custom_headers,
         }
 
+    @override
+    def _validate_headers(self, headers: Headers, custom_headers: Headers) -> None:
+        if self.username and self.password and headers.get("Authorization"):
+            return
+        if isinstance(custom_headers.get("Authorization"), Omit):
+            return
+
+        if self.access_token and headers.get("Authorization"):
+            return
+        if isinstance(custom_headers.get("Authorization"), Omit):
+            return
+
+        raise TypeError(
+            '"Could not resolve authentication method. Expected either username, password or access_token to be set. Or for one of the `Authorization` or `Authorization` headers to be explicitly omitted"'
+        )
+
     def copy(
         self,
         *,
         password: str | None = None,
         username: str | None = None,
+        access_token: str | None = None,
         base_url: str | httpx.URL | None = None,
         timeout: float | Timeout | None | NotGiven = NOT_GIVEN,
         http_client: httpx.AsyncClient | None = None,
@@ -1183,6 +1247,7 @@ class AsyncUnifieddatalibrary(AsyncAPIClient):
         client = self.__class__(
             password=password or self.password,
             username=username or self.username,
+            access_token=access_token or self.access_token,
             base_url=base_url or self.base_url,
             timeout=self.timeout if isinstance(timeout, NotGiven) else timeout,
             http_client=http_client,

{udl_sdk-0.1.0a16 → udl_sdk-0.1.0a17}/src/unifieddatalibrary/_version.py

@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 __title__ = "unifieddatalibrary"
-__version__ = "0.1.0-alpha.16"  # x-release-please-version
+__version__ = "0.1.0-alpha.17"  # x-release-please-version

{udl_sdk-0.1.0a16 → udl_sdk-0.1.0a17}/tests/test_client.py

@@ -24,7 +24,7 @@ from pydantic import ValidationError
 from unifieddatalibrary import Unifieddatalibrary, AsyncUnifieddatalibrary, APIResponseValidationError
 from unifieddatalibrary._types import Omit
 from unifieddatalibrary._models import BaseModel, FinalRequestOptions
-from unifieddatalibrary._exceptions import APIStatusError, UnifieddatalibraryError, APIResponseValidationError
+from unifieddatalibrary._exceptions import APIStatusError, APIResponseValidationError
 from unifieddatalibrary._base_client import (
     DEFAULT_TIMEOUT,
     HTTPX_DEFAULT_TIMEOUT,
@@ -372,17 +372,26 @@ class TestUnifieddatalibrary:
         request = client._build_request(FinalRequestOptions(method="get", url="/foo"))
         assert "Basic" in request.headers.get("Authorization")
 
-        with pytest.raises(UnifieddatalibraryError):
-            with update_env(
-                **{
-                    "UDL_AUTH_USERNAME": Omit(),
-                    "UDL_AUTH_PASSWORD": Omit(),
-                }
-            ):
-                client2 = Unifieddatalibrary(
-                    base_url=base_url, password=None, username=None, _strict_response_validation=True
-                )
-            _ = client2
+        with update_env(
+            **{
+                "UDL_AUTH_USERNAME": Omit(),
+                "UDL_AUTH_PASSWORD": Omit(),
+            }
+        ):
+            client2 = Unifieddatalibrary(
+                base_url=base_url, password=None, username=None, _strict_response_validation=True
+            )
+
+        with pytest.raises(
+            TypeError,
+            match="Could not resolve authentication method. Expected either username, password or access_token to be set. Or for one of the `Authorization` or `Authorization` headers to be explicitly omitted",
+        ):
+            client2._build_request(FinalRequestOptions(method="get", url="/foo"))
+
+        request2 = client2._build_request(
+            FinalRequestOptions(method="get", url="/foo", headers={"Authorization": Omit()})
+        )
+        assert request2.headers.get("Authorization") is None
 
     def test_default_query_option(self) -> None:
         client = Unifieddatalibrary(
@@ -1242,17 +1251,26 @@ class TestAsyncUnifieddatalibrary:
         request = client._build_request(FinalRequestOptions(method="get", url="/foo"))
         assert "Basic" in request.headers.get("Authorization")
 
-        with pytest.raises(UnifieddatalibraryError):
-            with update_env(
-                **{
-                    "UDL_AUTH_USERNAME": Omit(),
-                    "UDL_AUTH_PASSWORD": Omit(),
-                }
-            ):
-                client2 = AsyncUnifieddatalibrary(
-                    base_url=base_url, password=None, username=None, _strict_response_validation=True
-                )
-            _ = client2
+        with update_env(
+            **{
+                "UDL_AUTH_USERNAME": Omit(),
+                "UDL_AUTH_PASSWORD": Omit(),
+            }
+        ):
+            client2 = AsyncUnifieddatalibrary(
+                base_url=base_url, password=None, username=None, _strict_response_validation=True
+            )
+
+        with pytest.raises(
+            TypeError,
+            match="Could not resolve authentication method. Expected either username, password or access_token to be set. Or for one of the `Authorization` or `Authorization` headers to be explicitly omitted",
+        ):
+            client2._build_request(FinalRequestOptions(method="get", url="/foo"))
+
+        request2 = client2._build_request(
+            FinalRequestOptions(method="get", url="/foo", headers={"Authorization": Omit()})
+        )
+        assert request2.headers.get("Authorization") is None
 
     def test_default_query_option(self) -> None:
         client = AsyncUnifieddatalibrary(

udl_sdk-0.1.0a16/.release-please-manifest.json

@@ -1,3 +0,0 @@
-{
-  ".": "0.1.0-alpha.16"
-}