Merge pull request #73 from lumalabs/release-please--branches--main--changes--next

release: 1.2.2

Author: karanganesan

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "1.2.1"
+  ".": "1.2.2"
 }

.stats.yml

@@ -1,2 +1,2 @@
 configured_endpoints: 8
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/luma-ai-karanganesan%2Fluma_ai-15f705a5789a4671a5cba160123f7325eff333b93dab4292e25ee92e2ef15a68.yml
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/luma-ai-karanganesan%2Fluma_ai-15f705a5789a4671a5cba160123f7325eff333b93dab4292e25ee92e2ef15a68.yml

CHANGELOG.md

@@ -1,5 +1,23 @@
 # Changelog
 
+## 1.2.2 (2024-12-17)
+
+Full Changelog: [v1.2.1...v1.2.2](https://github.com/lumalabs/lumaai-python/compare/v1.2.1...v1.2.2)
+
+### Chores
+
+* **internal:** add support for TypeAliasType ([#75](https://github.com/lumalabs/lumaai-python/issues/75)) ([487ea05](https://github.com/lumalabs/lumaai-python/commit/487ea05a5a5a1e25d311049b58c43e0b781fcb11))
+* **internal:** bump pyright ([#74](https://github.com/lumalabs/lumaai-python/issues/74)) ([684e61b](https://github.com/lumalabs/lumaai-python/commit/684e61b45dd704c13b38585a307a1fbc39796fe5))
+* **internal:** codegen related update ([#72](https://github.com/lumalabs/lumaai-python/issues/72)) ([2b28fc6](https://github.com/lumalabs/lumaai-python/commit/2b28fc615f654f7b87efc24f712390be53775141))
+* **internal:** codegen related update ([#76](https://github.com/lumalabs/lumaai-python/issues/76)) ([d16f720](https://github.com/lumalabs/lumaai-python/commit/d16f720b4c14d5de970808840e1621924a7bd1fa))
+* **internal:** codegen related update ([#77](https://github.com/lumalabs/lumaai-python/issues/77)) ([9bf4a43](https://github.com/lumalabs/lumaai-python/commit/9bf4a435ac0be28c6db5fb2950ff650e1584332a))
+* **internal:** updated imports ([#78](https://github.com/lumalabs/lumaai-python/issues/78)) ([3f247e8](https://github.com/lumalabs/lumaai-python/commit/3f247e8c1f1be4927bbc85d51f12de6ab7308496))
+
+
+### Documentation
+
+* **readme:** example snippet for client context manager ([#79](https://github.com/lumalabs/lumaai-python/issues/79)) ([ddf9360](https://github.com/lumalabs/lumaai-python/commit/ddf9360a133c06f5ff1271cea46ec202c2b989cb))
+
 ## 1.2.1 (2024-12-04)
 
 Full Changelog: [v1.2.0...v1.2.1](https://github.com/lumalabs/lumaai-python/compare/v1.2.0...v1.2.1)

README.md

@@ -288,18 +288,19 @@ can also get all the extra fields on the Pydantic model as a dict with
 
 You can directly override the [httpx client](https://www.python-httpx.org/api/#client) to customize it for your use case, including:
 
-- Support for proxies
-- Custom transports
+- Support for [proxies](https://www.python-httpx.org/advanced/proxies/)
+- Custom [transports](https://www.python-httpx.org/advanced/transports/)
 - Additional [advanced](https://www.python-httpx.org/advanced/clients/) functionality
 
 ```python
+import httpx
 from lumaai import LumaAI, DefaultHttpxClient
 
 client = LumaAI(
     # Or use the `LUMAAI_BASE_URL` env var
     base_url="http://my.test.server.example.com:8083",
     http_client=DefaultHttpxClient(
-        proxies="http://my.test.proxy.example.com",
+        proxy="http://my.test.proxy.example.com",
         transport=httpx.HTTPTransport(local_address="0.0.0.0"),
     ),
 )
@@ -315,6 +316,16 @@ client.with_options(http_client=DefaultHttpxClient(...))
 
 By default the library closes underlying HTTP connections whenever the client is [garbage collected](https://docs.python.org/3/reference/datamodel.html#object.__del__). You can manually close the client using the `.close()` method if desired, or with a context manager that closes when exiting.
 
+```py
+from lumaai import LumaAI
+
+with LumaAI() as client:
+  # make requests here
+  ...
+
+# HTTP client is now closed
+```
+
 ## Versioning
 
 This package generally follows [SemVer](https://semver.org/spec/v2.0.0.html) conventions, though certain backwards-incompatible changes may be released as minor versions:

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "lumaai"
-version = "1.2.1"
+version = "1.2.2"
 description = "The official Python library for the lumaai API"
 dynamic = ["readme"]
 license = "Apache-2.0"
@@ -10,7 +10,7 @@ authors = [
 dependencies = [
     "httpx>=0.23.0, <1",
     "pydantic>=1.9.0, <3",
-    "typing-extensions>=4.7, <5",
+    "typing-extensions>=4.10, <5",
     "anyio>=3.5.0, <5",
     "distro>=1.7.0, <2",
     "sniffio",

requirements-dev.lock

@@ -62,13 +62,13 @@ platformdirs==3.11.0
     # via virtualenv
 pluggy==1.5.0
     # via pytest
-pydantic==2.9.2
+pydantic==2.10.3
     # via lumaai
-pydantic-core==2.23.4
+pydantic-core==2.27.1
     # via pydantic
 pygments==2.18.0
     # via rich
-pyright==1.1.389
+pyright==1.1.390
 pytest==8.3.3
     # via pytest-asyncio
 pytest-asyncio==0.24.0

requirements.lock

@@ -30,9 +30,9 @@ httpx==0.25.2
 idna==3.4
     # via anyio
     # via httpx
-pydantic==2.9.2
+pydantic==2.10.3
     # via lumaai
-pydantic-core==2.23.4
+pydantic-core==2.27.1
     # via pydantic
 sniffio==1.3.0
     # via anyio

src/lumaai/_client.py

@@ -8,7 +8,7 @@
 
 import httpx
 
-from . import resources, _exceptions
+from . import _exceptions
 from ._qs import Querystring
 from ._types import (
     NOT_GIVEN,
@@ -24,31 +24,23 @@
     get_async_library,
 )
 from ._version import __version__
+from .resources import ping, credits
 from ._streaming import Stream as Stream, AsyncStream as AsyncStream
 from ._exceptions import LumaAIError, APIStatusError
 from ._base_client import (
     DEFAULT_MAX_RETRIES,
     SyncAPIClient,
     AsyncAPIClient,
 )
+from .resources.generations import generations
 
-__all__ = [
-    "Timeout",
-    "Transport",
-    "ProxiesTypes",
-    "RequestOptions",
-    "resources",
-    "LumaAI",
-    "AsyncLumaAI",
-    "Client",
-    "AsyncClient",
-]
+__all__ = ["Timeout", "Transport", "ProxiesTypes", "RequestOptions", "LumaAI", "AsyncLumaAI", "Client", "AsyncClient"]
 
 
 class LumaAI(SyncAPIClient):
-    generations: resources.GenerationsResource
-    ping: resources.PingResource
-    credits: resources.CreditsResource
+    generations: generations.GenerationsResource
+    ping: ping.PingResource
+    credits: credits.CreditsResource
     with_raw_response: LumaAIWithRawResponse
     with_streaming_response: LumaAIWithStreamedResponse
 
@@ -106,9 +98,9 @@ def __init__(
             _strict_response_validation=_strict_response_validation,
         )
 
-        self.generations = resources.GenerationsResource(self)
-        self.ping = resources.PingResource(self)
-        self.credits = resources.CreditsResource(self)
+        self.generations = generations.GenerationsResource(self)
+        self.ping = ping.PingResource(self)
+        self.credits = credits.CreditsResource(self)
         self.with_raw_response = LumaAIWithRawResponse(self)
         self.with_streaming_response = LumaAIWithStreamedResponse(self)
 
@@ -218,9 +210,9 @@ def _make_status_error(
 
 
 class AsyncLumaAI(AsyncAPIClient):
-    generations: resources.AsyncGenerationsResource
-    ping: resources.AsyncPingResource
-    credits: resources.AsyncCreditsResource
+    generations: generations.AsyncGenerationsResource
+    ping: ping.AsyncPingResource
+    credits: credits.AsyncCreditsResource
     with_raw_response: AsyncLumaAIWithRawResponse
     with_streaming_response: AsyncLumaAIWithStreamedResponse
 
@@ -278,9 +270,9 @@ def __init__(
             _strict_response_validation=_strict_response_validation,
         )
 
-        self.generations = resources.AsyncGenerationsResource(self)
-        self.ping = resources.AsyncPingResource(self)
-        self.credits = resources.AsyncCreditsResource(self)
+        self.generations = generations.AsyncGenerationsResource(self)
+        self.ping = ping.AsyncPingResource(self)
+        self.credits = credits.AsyncCreditsResource(self)
         self.with_raw_response = AsyncLumaAIWithRawResponse(self)
         self.with_streaming_response = AsyncLumaAIWithStreamedResponse(self)
 
@@ -391,30 +383,30 @@ def _make_status_error(
 
 class LumaAIWithRawResponse:
     def __init__(self, client: LumaAI) -> None:
-        self.generations = resources.GenerationsResourceWithRawResponse(client.generations)
-        self.ping = resources.PingResourceWithRawResponse(client.ping)
-        self.credits = resources.CreditsResourceWithRawResponse(client.credits)
+        self.generations = generations.GenerationsResourceWithRawResponse(client.generations)
+        self.ping = ping.PingResourceWithRawResponse(client.ping)
+        self.credits = credits.CreditsResourceWithRawResponse(client.credits)
 
 
 class AsyncLumaAIWithRawResponse:
     def __init__(self, client: AsyncLumaAI) -> None:
-        self.generations = resources.AsyncGenerationsResourceWithRawResponse(client.generations)
-        self.ping = resources.AsyncPingResourceWithRawResponse(client.ping)
-        self.credits = resources.AsyncCreditsResourceWithRawResponse(client.credits)
+        self.generations = generations.AsyncGenerationsResourceWithRawResponse(client.generations)
+        self.ping = ping.AsyncPingResourceWithRawResponse(client.ping)
+        self.credits = credits.AsyncCreditsResourceWithRawResponse(client.credits)
 
 
 class LumaAIWithStreamedResponse:
     def __init__(self, client: LumaAI) -> None:
-        self.generations = resources.GenerationsResourceWithStreamingResponse(client.generations)
-        self.ping = resources.PingResourceWithStreamingResponse(client.ping)
-        self.credits = resources.CreditsResourceWithStreamingResponse(client.credits)
+        self.generations = generations.GenerationsResourceWithStreamingResponse(client.generations)
+        self.ping = ping.PingResourceWithStreamingResponse(client.ping)
+        self.credits = credits.CreditsResourceWithStreamingResponse(client.credits)
 
 
 class AsyncLumaAIWithStreamedResponse:
     def __init__(self, client: AsyncLumaAI) -> None:
-        self.generations = resources.AsyncGenerationsResourceWithStreamingResponse(client.generations)
-        self.ping = resources.AsyncPingResourceWithStreamingResponse(client.ping)
-        self.credits = resources.AsyncCreditsResourceWithStreamingResponse(client.credits)
+        self.generations = generations.AsyncGenerationsResourceWithStreamingResponse(client.generations)
+        self.ping = ping.AsyncPingResourceWithStreamingResponse(client.ping)
+        self.credits = credits.AsyncCreditsResourceWithStreamingResponse(client.credits)
 
 
 Client = LumaAI

src/lumaai/_models.py

@@ -46,6 +46,7 @@
     strip_not_given,
     extract_type_arg,
     is_annotated_type,
+    is_type_alias_type,
     strip_annotated_type,
 )
 from ._compat import (
@@ -428,6 +429,8 @@ def construct_type(*, value: object, type_: object) -> object:
     # we allow `object` as the input type because otherwise, passing things like
     # `Literal['value']` will be reported as a type error by type checkers
     type_ = cast("type[object]", type_)
+    if is_type_alias_type(type_):
+        type_ = type_.__value__  # type: ignore[unreachable]
 
     # unwrap `Annotated[T, ...]` -> `T`
     if is_annotated_type(type_):

src/lumaai/_response.py

@@ -25,7 +25,7 @@
 import pydantic
 
 from ._types import NoneType
-from ._utils import is_given, extract_type_arg, is_annotated_type, extract_type_var_from_base
+from ._utils import is_given, extract_type_arg, is_annotated_type, is_type_alias_type, extract_type_var_from_base
 from ._models import BaseModel, is_basemodel
 from ._constants import RAW_RESPONSE_HEADER, OVERRIDE_CAST_TO_HEADER
 from ._streaming import Stream, AsyncStream, is_stream_class_type, extract_stream_chunk_type
@@ -126,9 +126,15 @@ def __repr__(self) -> str:
         )
 
     def _parse(self, *, to: type[_T] | None = None) -> R | _T:
+        cast_to = to if to is not None else self._cast_to
+
+        # unwrap `TypeAlias('Name', T)` -> `T`
+        if is_type_alias_type(cast_to):
+            cast_to = cast_to.__value__  # type: ignore[unreachable]
+
         # unwrap `Annotated[T, ...]` -> `T`
-        if to and is_annotated_type(to):
-            to = extract_type_arg(to, 0)
+        if cast_to and is_annotated_type(cast_to):
+            cast_to = extract_type_arg(cast_to, 0)
 
         if self._is_sse_stream:
             if to:
@@ -164,18 +170,12 @@ def _parse(self, *, to: type[_T] | None = None) -> R | _T:
             return cast(
                 R,
                 stream_cls(
-                    cast_to=self._cast_to,
+                    cast_to=cast_to,
                     response=self.http_response,
                     client=cast(Any, self._client),
                 ),
             )
 
-        cast_to = to if to is not None else self._cast_to
-
-        # unwrap `Annotated[T, ...]` -> `T`
-        if is_annotated_type(cast_to):
-            cast_to = extract_type_arg(cast_to, 0)
-
         if cast_to is NoneType:
             return cast(R, None)