gmt-python-sdk 0.24.0__tar.gz → 0.24.2__tar.gz

gmt_python_sdk-0.24.2/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "0.24.2"
+}

{gmt_python_sdk-0.24.0 → gmt_python_sdk-0.24.2}/CHANGELOG.md

@@ -1,5 +1,31 @@
 # Changelog
 
+## 0.24.2 (2026-03-17)
+
+Full Changelog: [v0.24.1...v0.24.2](https://github.com/cameo6/gmt-python-sdk/compare/v0.24.1...v0.24.2)
+
+### Bug Fixes
+
+* **deps:** bump minimum typing-extensions version ([410b34f](https://github.com/cameo6/gmt-python-sdk/commit/410b34ffd6285b8a671b284af7fa6df45de529bb))
+
+## 0.24.1 (2026-03-17)
+
+Full Changelog: [v0.24.0...v0.24.1](https://github.com/cameo6/gmt-python-sdk/compare/v0.24.0...v0.24.1)
+
+### Bug Fixes
+
+* **pydantic:** do not pass `by_alias` unless set ([3d7f2bc](https://github.com/cameo6/gmt-python-sdk/commit/3d7f2bc45271fa41ecbe0b08cc82b3ab10b8a695))
+
+
+### Chores
+
+* **ci:** bump uv version ([b3c966d](https://github.com/cameo6/gmt-python-sdk/commit/b3c966d2b7a95389877fd001e8ab7a3cdfc987ff))
+* **ci:** skip uploading artifacts on stainless-internal branches ([08dc917](https://github.com/cameo6/gmt-python-sdk/commit/08dc91786204947990f392f73fc82bb4cfb3441c))
+* **internal:** add request options to SSE classes ([8bfa3bd](https://github.com/cameo6/gmt-python-sdk/commit/8bfa3bd7fc05cb67e742b06e715b646a76b4d59a))
+* **internal:** codegen related update ([c3fd234](https://github.com/cameo6/gmt-python-sdk/commit/c3fd2343921fad94a00198ca01f42e389c685d72))
+* **internal:** make `test_proxy_environment_variables` more resilient ([1c0e14a](https://github.com/cameo6/gmt-python-sdk/commit/1c0e14a892b21ec457328c4bc9fd4395ef3994f8))
+* **internal:** make `test_proxy_environment_variables` more resilient to env ([928ca24](https://github.com/cameo6/gmt-python-sdk/commit/928ca2483867abd28f3d9276270860ce979c837b))
+
 ## 0.24.0 (2026-02-20)
 
 Full Changelog: [v0.23.0...v0.24.0](https://github.com/cameo6/gmt-python-sdk/compare/v0.23.0...v0.24.0)

{gmt_python_sdk-0.24.0 → gmt_python_sdk-0.24.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: gmt-python-sdk
-Version: 0.24.0
+Version: 0.24.2
 Summary: The official Python library for the gmt API
 Project-URL: Homepage, https://github.com/cameo6/gmt-python-sdk
 Project-URL: Repository, https://github.com/cameo6/gmt-python-sdk
@@ -27,7 +27,7 @@ Requires-Dist: distro<2,>=1.7.0
 Requires-Dist: httpx<1,>=0.23.0
 Requires-Dist: pydantic<3,>=1.9.0
 Requires-Dist: sniffio
-Requires-Dist: typing-extensions<5,>=4.10
+Requires-Dist: typing-extensions<5,>=4.14
 Provides-Extra: aiohttp
 Requires-Dist: aiohttp; extra == 'aiohttp'
 Requires-Dist: httpx-aiohttp>=0.1.9; extra == 'aiohttp'

{gmt_python_sdk-0.24.0 → gmt_python_sdk-0.24.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "gmt-python-sdk"
-version = "0.24.0"
+version = "0.24.2"
 description = "The official Python library for the gmt API"
 dynamic = ["readme"]
 license = "Apache-2.0"
@@ -11,7 +11,7 @@ authors = [
 dependencies = [
   "httpx>=0.23.0, <1",
   "pydantic>=1.9.0, <3",
-  "typing-extensions>=4.10, <5",
+  "typing-extensions>=4.14, <5",
   "anyio>=3.5.0, <5",
   "distro>=1.7.0, <2",
   "sniffio",

{gmt_python_sdk-0.24.0 → gmt_python_sdk-0.24.2}/src/gmt/_client.py

@@ -94,30 +94,67 @@ class Gmt(SyncAPIClient):
 
     @cached_property
     def service(self) -> ServiceResource:
+        """Service endpoints for API health checks."""
         from .resources.service import ServiceResource
 
         return ServiceResource(self)
 
     @cached_property
     def accounts(self) -> AccountsResource:
+        """Browse and purchase Telegram accounts.
+
+        **Endpoints overview:**
+        - `GET /accounts/countries` — Public catalog with base prices (no auth required)
+        - `GET /accounts` — Personalized list with user's discounted prices (auth required)
+        - `GET /accounts/:country_code` — Detailed pricing breakdown with discount info (auth required)
+
+        **Pricing model.** Base prices are set per country. Authenticated users may receive a personal discount based on their purchase history (discount level). Use `/accounts/:country_code` to see the full price breakdown.
+        """
         from .resources.accounts import AccountsResource
 
         return AccountsResource(self)
 
     @cached_property
     def profile(self) -> ProfileResource:
+        """User profile management."""
         from .resources.profile import ProfileResource
 
         return ProfileResource(self)
 
     @cached_property
     def purchases(self) -> PurchasesResource:
+        """Purchase history and management."""
         from .resources.purchases import PurchasesResource
 
         return PurchasesResource(self)
 
     @cached_property
     def webhooks(self) -> WebhooksResource:
+        """Webhook testing and documentation.
+
+        ## Webhook Payload Types
+
+        When you provide `callback_url` in `POST /purchases/:id/request-code`, your endpoint will receive one of the following payloads:
+
+        - **WebhookSuccessPayload** — sent when verification code is successfully retrieved
+        - **WebhookFailedPayload** — sent when code retrieval fails after all retry attempts
+
+        When you provide `callback_url` in `POST /purchases/bulk`, your endpoint will receive:
+
+        - **WebhookBulkReadyPayload** — sent when bulk archive is ready
+
+        See the **Models** section below for detailed payload structure.
+
+        ## Requirements
+
+        - Your endpoint **must return HTTP 200** to acknowledge receipt
+        - Response timeout: **5 seconds**
+        - Failed deliveries are retried up to **3 times** (immediately, after 10s, after 30s)
+
+        ## Testing
+
+        Use `POST /v1/webhooks/test` to verify your endpoint. Get a temporary test URL at https://webhook.site
+        """
         from .resources.webhooks import WebhooksResource
 
         return WebhooksResource(self)
@@ -290,30 +327,67 @@ class AsyncGmt(AsyncAPIClient):
 
     @cached_property
     def service(self) -> AsyncServiceResource:
+        """Service endpoints for API health checks."""
         from .resources.service import AsyncServiceResource
 
         return AsyncServiceResource(self)
 
     @cached_property
     def accounts(self) -> AsyncAccountsResource:
+        """Browse and purchase Telegram accounts.
+
+        **Endpoints overview:**
+        - `GET /accounts/countries` — Public catalog with base prices (no auth required)
+        - `GET /accounts` — Personalized list with user's discounted prices (auth required)
+        - `GET /accounts/:country_code` — Detailed pricing breakdown with discount info (auth required)
+
+        **Pricing model.** Base prices are set per country. Authenticated users may receive a personal discount based on their purchase history (discount level). Use `/accounts/:country_code` to see the full price breakdown.
+        """
         from .resources.accounts import AsyncAccountsResource
 
         return AsyncAccountsResource(self)
 
     @cached_property
     def profile(self) -> AsyncProfileResource:
+        """User profile management."""
         from .resources.profile import AsyncProfileResource
 
         return AsyncProfileResource(self)
 
     @cached_property
     def purchases(self) -> AsyncPurchasesResource:
+        """Purchase history and management."""
         from .resources.purchases import AsyncPurchasesResource
 
         return AsyncPurchasesResource(self)
 
     @cached_property
     def webhooks(self) -> AsyncWebhooksResource:
+        """Webhook testing and documentation.
+
+        ## Webhook Payload Types
+
+        When you provide `callback_url` in `POST /purchases/:id/request-code`, your endpoint will receive one of the following payloads:
+
+        - **WebhookSuccessPayload** — sent when verification code is successfully retrieved
+        - **WebhookFailedPayload** — sent when code retrieval fails after all retry attempts
+
+        When you provide `callback_url` in `POST /purchases/bulk`, your endpoint will receive:
+
+        - **WebhookBulkReadyPayload** — sent when bulk archive is ready
+
+        See the **Models** section below for detailed payload structure.
+
+        ## Requirements
+
+        - Your endpoint **must return HTTP 200** to acknowledge receipt
+        - Response timeout: **5 seconds**
+        - Failed deliveries are retried up to **3 times** (immediately, after 10s, after 30s)
+
+        ## Testing
+
+        Use `POST /v1/webhooks/test` to verify your endpoint. Get a temporary test URL at https://webhook.site
+        """
         from .resources.webhooks import AsyncWebhooksResource
 
         return AsyncWebhooksResource(self)
@@ -441,30 +515,67 @@ class GmtWithRawResponse:
 
     @cached_property
     def service(self) -> service.ServiceResourceWithRawResponse:
+        """Service endpoints for API health checks."""
         from .resources.service import ServiceResourceWithRawResponse
 
         return ServiceResourceWithRawResponse(self._client.service)
 
     @cached_property
     def accounts(self) -> accounts.AccountsResourceWithRawResponse:
+        """Browse and purchase Telegram accounts.
+
+        **Endpoints overview:**
+        - `GET /accounts/countries` — Public catalog with base prices (no auth required)
+        - `GET /accounts` — Personalized list with user's discounted prices (auth required)
+        - `GET /accounts/:country_code` — Detailed pricing breakdown with discount info (auth required)
+
+        **Pricing model.** Base prices are set per country. Authenticated users may receive a personal discount based on their purchase history (discount level). Use `/accounts/:country_code` to see the full price breakdown.
+        """
         from .resources.accounts import AccountsResourceWithRawResponse
 
         return AccountsResourceWithRawResponse(self._client.accounts)
 
     @cached_property
     def profile(self) -> profile.ProfileResourceWithRawResponse:
+        """User profile management."""
         from .resources.profile import ProfileResourceWithRawResponse
 
         return ProfileResourceWithRawResponse(self._client.profile)
 
     @cached_property
     def purchases(self) -> purchases.PurchasesResourceWithRawResponse:
+        """Purchase history and management."""
         from .resources.purchases import PurchasesResourceWithRawResponse
 
         return PurchasesResourceWithRawResponse(self._client.purchases)
 
     @cached_property
     def webhooks(self) -> webhooks.WebhooksResourceWithRawResponse:
+        """Webhook testing and documentation.
+
+        ## Webhook Payload Types
+
+        When you provide `callback_url` in `POST /purchases/:id/request-code`, your endpoint will receive one of the following payloads:
+
+        - **WebhookSuccessPayload** — sent when verification code is successfully retrieved
+        - **WebhookFailedPayload** — sent when code retrieval fails after all retry attempts
+
+        When you provide `callback_url` in `POST /purchases/bulk`, your endpoint will receive:
+
+        - **WebhookBulkReadyPayload** — sent when bulk archive is ready
+
+        See the **Models** section below for detailed payload structure.
+
+        ## Requirements
+
+        - Your endpoint **must return HTTP 200** to acknowledge receipt
+        - Response timeout: **5 seconds**
+        - Failed deliveries are retried up to **3 times** (immediately, after 10s, after 30s)
+
+        ## Testing
+
+        Use `POST /v1/webhooks/test` to verify your endpoint. Get a temporary test URL at https://webhook.site
+        """
         from .resources.webhooks import WebhooksResourceWithRawResponse
 
         return WebhooksResourceWithRawResponse(self._client.webhooks)
@@ -478,30 +589,67 @@ class AsyncGmtWithRawResponse:
 
     @cached_property
     def service(self) -> service.AsyncServiceResourceWithRawResponse:
+        """Service endpoints for API health checks."""
         from .resources.service import AsyncServiceResourceWithRawResponse
 
         return AsyncServiceResourceWithRawResponse(self._client.service)
 
     @cached_property
     def accounts(self) -> accounts.AsyncAccountsResourceWithRawResponse:
+        """Browse and purchase Telegram accounts.
+
+        **Endpoints overview:**
+        - `GET /accounts/countries` — Public catalog with base prices (no auth required)
+        - `GET /accounts` — Personalized list with user's discounted prices (auth required)
+        - `GET /accounts/:country_code` — Detailed pricing breakdown with discount info (auth required)
+
+        **Pricing model.** Base prices are set per country. Authenticated users may receive a personal discount based on their purchase history (discount level). Use `/accounts/:country_code` to see the full price breakdown.
+        """
         from .resources.accounts import AsyncAccountsResourceWithRawResponse
 
         return AsyncAccountsResourceWithRawResponse(self._client.accounts)
 
     @cached_property
     def profile(self) -> profile.AsyncProfileResourceWithRawResponse:
+        """User profile management."""
         from .resources.profile import AsyncProfileResourceWithRawResponse
 
         return AsyncProfileResourceWithRawResponse(self._client.profile)
 
     @cached_property
     def purchases(self) -> purchases.AsyncPurchasesResourceWithRawResponse:
+        """Purchase history and management."""
         from .resources.purchases import AsyncPurchasesResourceWithRawResponse
 
         return AsyncPurchasesResourceWithRawResponse(self._client.purchases)
 
     @cached_property
     def webhooks(self) -> webhooks.AsyncWebhooksResourceWithRawResponse:
+        """Webhook testing and documentation.
+
+        ## Webhook Payload Types
+
+        When you provide `callback_url` in `POST /purchases/:id/request-code`, your endpoint will receive one of the following payloads:
+
+        - **WebhookSuccessPayload** — sent when verification code is successfully retrieved
+        - **WebhookFailedPayload** — sent when code retrieval fails after all retry attempts
+
+        When you provide `callback_url` in `POST /purchases/bulk`, your endpoint will receive:
+
+        - **WebhookBulkReadyPayload** — sent when bulk archive is ready
+
+        See the **Models** section below for detailed payload structure.
+
+        ## Requirements
+
+        - Your endpoint **must return HTTP 200** to acknowledge receipt
+        - Response timeout: **5 seconds**
+        - Failed deliveries are retried up to **3 times** (immediately, after 10s, after 30s)
+
+        ## Testing
+
+        Use `POST /v1/webhooks/test` to verify your endpoint. Get a temporary test URL at https://webhook.site
+        """
         from .resources.webhooks import AsyncWebhooksResourceWithRawResponse
 
         return AsyncWebhooksResourceWithRawResponse(self._client.webhooks)
@@ -515,30 +663,67 @@ class GmtWithStreamedResponse:
 
     @cached_property
     def service(self) -> service.ServiceResourceWithStreamingResponse:
+        """Service endpoints for API health checks."""
         from .resources.service import ServiceResourceWithStreamingResponse
 
         return ServiceResourceWithStreamingResponse(self._client.service)
 
     @cached_property
     def accounts(self) -> accounts.AccountsResourceWithStreamingResponse:
+        """Browse and purchase Telegram accounts.
+
+        **Endpoints overview:**
+        - `GET /accounts/countries` — Public catalog with base prices (no auth required)
+        - `GET /accounts` — Personalized list with user's discounted prices (auth required)
+        - `GET /accounts/:country_code` — Detailed pricing breakdown with discount info (auth required)
+
+        **Pricing model.** Base prices are set per country. Authenticated users may receive a personal discount based on their purchase history (discount level). Use `/accounts/:country_code` to see the full price breakdown.
+        """
         from .resources.accounts import AccountsResourceWithStreamingResponse
 
         return AccountsResourceWithStreamingResponse(self._client.accounts)
 
     @cached_property
     def profile(self) -> profile.ProfileResourceWithStreamingResponse:
+        """User profile management."""
         from .resources.profile import ProfileResourceWithStreamingResponse
 
         return ProfileResourceWithStreamingResponse(self._client.profile)
 
     @cached_property
     def purchases(self) -> purchases.PurchasesResourceWithStreamingResponse:
+        """Purchase history and management."""
         from .resources.purchases import PurchasesResourceWithStreamingResponse
 
         return PurchasesResourceWithStreamingResponse(self._client.purchases)
 
     @cached_property
     def webhooks(self) -> webhooks.WebhooksResourceWithStreamingResponse:
+        """Webhook testing and documentation.
+
+        ## Webhook Payload Types
+
+        When you provide `callback_url` in `POST /purchases/:id/request-code`, your endpoint will receive one of the following payloads:
+
+        - **WebhookSuccessPayload** — sent when verification code is successfully retrieved
+        - **WebhookFailedPayload** — sent when code retrieval fails after all retry attempts
+
+        When you provide `callback_url` in `POST /purchases/bulk`, your endpoint will receive:
+
+        - **WebhookBulkReadyPayload** — sent when bulk archive is ready
+
+        See the **Models** section below for detailed payload structure.
+
+        ## Requirements
+
+        - Your endpoint **must return HTTP 200** to acknowledge receipt
+        - Response timeout: **5 seconds**
+        - Failed deliveries are retried up to **3 times** (immediately, after 10s, after 30s)
+
+        ## Testing
+
+        Use `POST /v1/webhooks/test` to verify your endpoint. Get a temporary test URL at https://webhook.site
+        """
         from .resources.webhooks import WebhooksResourceWithStreamingResponse
 
         return WebhooksResourceWithStreamingResponse(self._client.webhooks)
@@ -552,30 +737,67 @@ class AsyncGmtWithStreamedResponse:
 
     @cached_property
     def service(self) -> service.AsyncServiceResourceWithStreamingResponse:
+        """Service endpoints for API health checks."""
         from .resources.service import AsyncServiceResourceWithStreamingResponse
 
         return AsyncServiceResourceWithStreamingResponse(self._client.service)
 
     @cached_property
     def accounts(self) -> accounts.AsyncAccountsResourceWithStreamingResponse:
+        """Browse and purchase Telegram accounts.
+
+        **Endpoints overview:**
+        - `GET /accounts/countries` — Public catalog with base prices (no auth required)
+        - `GET /accounts` — Personalized list with user's discounted prices (auth required)
+        - `GET /accounts/:country_code` — Detailed pricing breakdown with discount info (auth required)
+
+        **Pricing model.** Base prices are set per country. Authenticated users may receive a personal discount based on their purchase history (discount level). Use `/accounts/:country_code` to see the full price breakdown.
+        """
         from .resources.accounts import AsyncAccountsResourceWithStreamingResponse
 
         return AsyncAccountsResourceWithStreamingResponse(self._client.accounts)
 
     @cached_property
     def profile(self) -> profile.AsyncProfileResourceWithStreamingResponse:
+        """User profile management."""
         from .resources.profile import AsyncProfileResourceWithStreamingResponse
 
         return AsyncProfileResourceWithStreamingResponse(self._client.profile)
 
     @cached_property
     def purchases(self) -> purchases.AsyncPurchasesResourceWithStreamingResponse:
+        """Purchase history and management."""
         from .resources.purchases import AsyncPurchasesResourceWithStreamingResponse
 
         return AsyncPurchasesResourceWithStreamingResponse(self._client.purchases)
 
     @cached_property
     def webhooks(self) -> webhooks.AsyncWebhooksResourceWithStreamingResponse:
+        """Webhook testing and documentation.
+
+        ## Webhook Payload Types
+
+        When you provide `callback_url` in `POST /purchases/:id/request-code`, your endpoint will receive one of the following payloads:
+
+        - **WebhookSuccessPayload** — sent when verification code is successfully retrieved
+        - **WebhookFailedPayload** — sent when code retrieval fails after all retry attempts
+
+        When you provide `callback_url` in `POST /purchases/bulk`, your endpoint will receive:
+
+        - **WebhookBulkReadyPayload** — sent when bulk archive is ready
+
+        See the **Models** section below for detailed payload structure.
+
+        ## Requirements
+
+        - Your endpoint **must return HTTP 200** to acknowledge receipt
+        - Response timeout: **5 seconds**
+        - Failed deliveries are retried up to **3 times** (immediately, after 10s, after 30s)
+
+        ## Testing
+
+        Use `POST /v1/webhooks/test` to verify your endpoint. Get a temporary test URL at https://webhook.site
+        """
         from .resources.webhooks import AsyncWebhooksResourceWithStreamingResponse
 
         return AsyncWebhooksResourceWithStreamingResponse(self._client.webhooks)

{gmt_python_sdk-0.24.0 → gmt_python_sdk-0.24.2}/src/gmt/_compat.py

@@ -2,7 +2,7 @@ from __future__ import annotations
 
 from typing import TYPE_CHECKING, Any, Union, Generic, TypeVar, Callable, cast, overload
 from datetime import date, datetime
-from typing_extensions import Self, Literal
+from typing_extensions import Self, Literal, TypedDict
 
 import pydantic
 from pydantic.fields import FieldInfo
@@ -131,6 +131,10 @@ def model_json(model: pydantic.BaseModel, *, indent: int | None = None) -> str:
     return model.model_dump_json(indent=indent)
 
 
+class _ModelDumpKwargs(TypedDict, total=False):
+    by_alias: bool
+
+
 def model_dump(
     model: pydantic.BaseModel,
     *,
@@ -142,6 +146,9 @@ def model_dump(
     by_alias: bool | None = None,
 ) -> dict[str, Any]:
     if (not PYDANTIC_V1) or hasattr(model, "model_dump"):
+        kwargs: _ModelDumpKwargs = {}
+        if by_alias is not None:
+            kwargs["by_alias"] = by_alias
         return model.model_dump(
             mode=mode,
             exclude=exclude,
@@ -149,7 +156,7 @@ def model_dump(
             exclude_defaults=exclude_defaults,
             # warnings are not supported in Pydantic v1
             warnings=True if PYDANTIC_V1 else warnings,
-            by_alias=by_alias,
+            **kwargs,
         )
     return cast(
         "dict[str, Any]",

{gmt_python_sdk-0.24.0 → gmt_python_sdk-0.24.2}/src/gmt/_response.py

@@ -152,6 +152,7 @@ class BaseAPIResponse(Generic[R]):
                         ),
                         response=self.http_response,
                         client=cast(Any, self._client),
+                        options=self._options,
                     ),
                 )
 
@@ -162,6 +163,7 @@ class BaseAPIResponse(Generic[R]):
                         cast_to=extract_stream_chunk_type(self._stream_cls),
                         response=self.http_response,
                         client=cast(Any, self._client),
+                        options=self._options,
                     ),
                 )
 
@@ -175,6 +177,7 @@ class BaseAPIResponse(Generic[R]):
                     cast_to=cast_to,
                     response=self.http_response,
                     client=cast(Any, self._client),
+                    options=self._options,
                 ),
             )
 

{gmt_python_sdk-0.24.0 → gmt_python_sdk-0.24.2}/src/gmt/_streaming.py

@@ -4,7 +4,7 @@ from __future__ import annotations
 import json
 import inspect
 from types import TracebackType
-from typing import TYPE_CHECKING, Any, Generic, TypeVar, Iterator, AsyncIterator, cast
+from typing import TYPE_CHECKING, Any, Generic, TypeVar, Iterator, Optional, AsyncIterator, cast
 from typing_extensions import Self, Protocol, TypeGuard, override, get_origin, runtime_checkable
 
 import httpx
@@ -13,6 +13,7 @@ from ._utils import extract_type_var_from_base
 
 if TYPE_CHECKING:
     from ._client import Gmt, AsyncGmt
+    from ._models import FinalRequestOptions
 
 
 _T = TypeVar("_T")
@@ -22,7 +23,7 @@ class Stream(Generic[_T]):
     """Provides the core interface to iterate over a synchronous stream response."""
 
     response: httpx.Response
-
+    _options: Optional[FinalRequestOptions] = None
     _decoder: SSEBytesDecoder
 
     def __init__(
@@ -31,10 +32,12 @@ class Stream(Generic[_T]):
         cast_to: type[_T],
         response: httpx.Response,
         client: Gmt,
+        options: Optional[FinalRequestOptions] = None,
     ) -> None:
         self.response = response
         self._cast_to = cast_to
         self._client = client
+        self._options = options
         self._decoder = client._make_sse_decoder()
         self._iterator = self.__stream__()
 
@@ -85,7 +88,7 @@ class AsyncStream(Generic[_T]):
     """Provides the core interface to iterate over an asynchronous stream response."""
 
     response: httpx.Response
-
+    _options: Optional[FinalRequestOptions] = None
     _decoder: SSEDecoder | SSEBytesDecoder
 
     def __init__(
@@ -94,10 +97,12 @@ class AsyncStream(Generic[_T]):
         cast_to: type[_T],
         response: httpx.Response,
         client: AsyncGmt,
+        options: Optional[FinalRequestOptions] = None,
     ) -> None:
         self.response = response
         self._cast_to = cast_to
         self._client = client
+        self._options = options
         self._decoder = client._make_sse_decoder()
         self._iterator = self.__stream__()
 

{gmt_python_sdk-0.24.0 → gmt_python_sdk-0.24.2}/src/gmt/_version.py

@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 __title__ = "gmt"
-__version__ = "0.24.0"  # x-release-please-version
+__version__ = "0.24.2"  # x-release-please-version

{gmt_python_sdk-0.24.0 → gmt_python_sdk-0.24.2}/src/gmt/resources/accounts.py

@@ -27,6 +27,16 @@ __all__ = ["AccountsResource", "AsyncAccountsResource"]
 
 
 class AccountsResource(SyncAPIResource):
+    """Browse and purchase Telegram accounts.
+
+    **Endpoints overview:**
+    - `GET /accounts/countries` — Public catalog with base prices (no auth required)
+    - `GET /accounts` — Personalized list with user's discounted prices (auth required)
+    - `GET /accounts/:country_code` — Detailed pricing breakdown with discount info (auth required)
+
+    **Pricing model.** Base prices are set per country. Authenticated users may receive a personal discount based on their purchase history (discount level). Use `/accounts/:country_code` to see the full price breakdown.
+    """
+
     @cached_property
     def with_raw_response(self) -> AccountsResourceWithRawResponse:
         """
@@ -239,6 +249,16 @@ class AccountsResource(SyncAPIResource):
 
 
 class AsyncAccountsResource(AsyncAPIResource):
+    """Browse and purchase Telegram accounts.
+
+    **Endpoints overview:**
+    - `GET /accounts/countries` — Public catalog with base prices (no auth required)
+    - `GET /accounts` — Personalized list with user's discounted prices (auth required)
+    - `GET /accounts/:country_code` — Detailed pricing breakdown with discount info (auth required)
+
+    **Pricing model.** Base prices are set per country. Authenticated users may receive a personal discount based on their purchase history (discount level). Use `/accounts/:country_code` to see the full price breakdown.
+    """
+
     @cached_property
     def with_raw_response(self) -> AsyncAccountsResourceWithRawResponse:
         """

{gmt_python_sdk-0.24.0 → gmt_python_sdk-0.24.2}/src/gmt/resources/profile.py

@@ -25,6 +25,8 @@ __all__ = ["ProfileResource", "AsyncProfileResource"]
 
 
 class ProfileResource(SyncAPIResource):
+    """User profile management."""
+
     @cached_property
     def with_raw_response(self) -> ProfileResourceWithRawResponse:
         """
@@ -161,6 +163,8 @@ class ProfileResource(SyncAPIResource):
 
 
 class AsyncProfileResource(AsyncAPIResource):
+    """User profile management."""
+
     @cached_property
     def with_raw_response(self) -> AsyncProfileResourceWithRawResponse:
         """

{gmt_python_sdk-0.24.0 → gmt_python_sdk-0.24.2}/src/gmt/resources/purchases/bulk.py

@@ -31,6 +31,8 @@ __all__ = ["BulkResource", "AsyncBulkResource"]
 
 
 class BulkResource(SyncAPIResource):
+    """Purchase history and management."""
+
     @cached_property
     def with_raw_response(self) -> BulkResourceWithRawResponse:
         """
@@ -187,6 +189,8 @@ class BulkResource(SyncAPIResource):
 
 
 class AsyncBulkResource(AsyncAPIResource):
+    """Purchase history and management."""
+
     @cached_property
     def with_raw_response(self) -> AsyncBulkResourceWithRawResponse:
         """

{gmt_python_sdk-0.24.0 → gmt_python_sdk-0.24.2}/src/gmt/resources/purchases/purchases.py

@@ -37,8 +37,11 @@ __all__ = ["PurchasesResource", "AsyncPurchasesResource"]
 
 
 class PurchasesResource(SyncAPIResource):
+    """Purchase history and management."""
+
     @cached_property
     def bulk(self) -> BulkResource:
+        """Purchase history and management."""
         return BulkResource(self._client)
 
     @cached_property
@@ -324,8 +327,11 @@ class PurchasesResource(SyncAPIResource):
 
 
 class AsyncPurchasesResource(AsyncAPIResource):
+    """Purchase history and management."""
+
     @cached_property
     def bulk(self) -> AsyncBulkResource:
+        """Purchase history and management."""
         return AsyncBulkResource(self._client)
 
     @cached_property
@@ -634,6 +640,7 @@ class PurchasesResourceWithRawResponse:
 
     @cached_property
     def bulk(self) -> BulkResourceWithRawResponse:
+        """Purchase history and management."""
         return BulkResourceWithRawResponse(self._purchases.bulk)
 
 
@@ -659,6 +666,7 @@ class AsyncPurchasesResourceWithRawResponse:
 
     @cached_property
     def bulk(self) -> AsyncBulkResourceWithRawResponse:
+        """Purchase history and management."""
         return AsyncBulkResourceWithRawResponse(self._purchases.bulk)
 
 
@@ -684,6 +692,7 @@ class PurchasesResourceWithStreamingResponse:
 
     @cached_property
     def bulk(self) -> BulkResourceWithStreamingResponse:
+        """Purchase history and management."""
         return BulkResourceWithStreamingResponse(self._purchases.bulk)
 
 
@@ -709,4 +718,5 @@ class AsyncPurchasesResourceWithStreamingResponse:
 
     @cached_property
     def bulk(self) -> AsyncBulkResourceWithStreamingResponse:
+        """Purchase history and management."""
         return AsyncBulkResourceWithStreamingResponse(self._purchases.bulk)

{gmt_python_sdk-0.24.0 → gmt_python_sdk-0.24.2}/src/gmt/resources/service.py

@@ -21,6 +21,8 @@ __all__ = ["ServiceResource", "AsyncServiceResource"]
 
 
 class ServiceResource(SyncAPIResource):
+    """Service endpoints for API health checks."""
+
     @cached_property
     def with_raw_response(self) -> ServiceResourceWithRawResponse:
         """
@@ -80,6 +82,8 @@ class ServiceResource(SyncAPIResource):
 
 
 class AsyncServiceResource(AsyncAPIResource):
+    """Service endpoints for API health checks."""
+
     @cached_property
     def with_raw_response(self) -> AsyncServiceResourceWithRawResponse:
         """

{gmt_python_sdk-0.24.0 → gmt_python_sdk-0.24.2}/src/gmt/resources/webhooks.py

@@ -24,6 +24,32 @@ __all__ = ["WebhooksResource", "AsyncWebhooksResource"]
 
 
 class WebhooksResource(SyncAPIResource):
+    """Webhook testing and documentation.
+
+    ## Webhook Payload Types
+
+    When you provide `callback_url` in `POST /purchases/:id/request-code`, your endpoint will receive one of the following payloads:
+
+    - **WebhookSuccessPayload** — sent when verification code is successfully retrieved
+    - **WebhookFailedPayload** — sent when code retrieval fails after all retry attempts
+
+    When you provide `callback_url` in `POST /purchases/bulk`, your endpoint will receive:
+
+    - **WebhookBulkReadyPayload** — sent when bulk archive is ready
+
+    See the **Models** section below for detailed payload structure.
+
+    ## Requirements
+
+    - Your endpoint **must return HTTP 200** to acknowledge receipt
+    - Response timeout: **5 seconds**
+    - Failed deliveries are retried up to **3 times** (immediately, after 10s, after 30s)
+
+    ## Testing
+
+    Use `POST /v1/webhooks/test` to verify your endpoint. Get a temporary test URL at https://webhook.site
+    """
+
     @cached_property
     def with_raw_response(self) -> WebhooksResourceWithRawResponse:
         """
@@ -102,6 +128,32 @@ class WebhooksResource(SyncAPIResource):
 
 
 class AsyncWebhooksResource(AsyncAPIResource):
+    """Webhook testing and documentation.
+
+    ## Webhook Payload Types
+
+    When you provide `callback_url` in `POST /purchases/:id/request-code`, your endpoint will receive one of the following payloads:
+
+    - **WebhookSuccessPayload** — sent when verification code is successfully retrieved
+    - **WebhookFailedPayload** — sent when code retrieval fails after all retry attempts
+
+    When you provide `callback_url` in `POST /purchases/bulk`, your endpoint will receive:
+
+    - **WebhookBulkReadyPayload** — sent when bulk archive is ready
+
+    See the **Models** section below for detailed payload structure.
+
+    ## Requirements
+
+    - Your endpoint **must return HTTP 200** to acknowledge receipt
+    - Response timeout: **5 seconds**
+    - Failed deliveries are retried up to **3 times** (immediately, after 10s, after 30s)
+
+    ## Testing
+
+    Use `POST /v1/webhooks/test` to verify your endpoint. Get a temporary test URL at https://webhook.site
+    """
+
     @cached_property
     def with_raw_response(self) -> AsyncWebhooksResourceWithRawResponse:
         """

{gmt_python_sdk-0.24.0 → gmt_python_sdk-0.24.2}/tests/test_client.py

@@ -935,6 +935,14 @@ class TestGmt:
     def test_proxy_environment_variables(self, monkeypatch: pytest.MonkeyPatch) -> None:
         # Test that the proxy environment variables are set correctly
         monkeypatch.setenv("HTTPS_PROXY", "https://example.org")
+        # Delete in case our environment has any proxy env vars set
+        monkeypatch.delenv("HTTP_PROXY", raising=False)
+        monkeypatch.delenv("ALL_PROXY", raising=False)
+        monkeypatch.delenv("NO_PROXY", raising=False)
+        monkeypatch.delenv("http_proxy", raising=False)
+        monkeypatch.delenv("https_proxy", raising=False)
+        monkeypatch.delenv("all_proxy", raising=False)
+        monkeypatch.delenv("no_proxy", raising=False)
 
         client = DefaultHttpxClient()
 
@@ -1829,6 +1837,14 @@ class TestAsyncGmt:
     async def test_proxy_environment_variables(self, monkeypatch: pytest.MonkeyPatch) -> None:
         # Test that the proxy environment variables are set correctly
         monkeypatch.setenv("HTTPS_PROXY", "https://example.org")
+        # Delete in case our environment has any proxy env vars set
+        monkeypatch.delenv("HTTP_PROXY", raising=False)
+        monkeypatch.delenv("ALL_PROXY", raising=False)
+        monkeypatch.delenv("NO_PROXY", raising=False)
+        monkeypatch.delenv("http_proxy", raising=False)
+        monkeypatch.delenv("https_proxy", raising=False)
+        monkeypatch.delenv("all_proxy", raising=False)
+        monkeypatch.delenv("no_proxy", raising=False)
 
         client = DefaultAsyncHttpxClient()
 

{gmt_python_sdk-0.24.0 → gmt_python_sdk-0.24.2}/uv.lock

@@ -471,7 +471,7 @@ requires-dist = [
     { name = "httpx-aiohttp", marker = "extra == 'aiohttp'", specifier = ">=0.1.9" },
     { name = "pydantic", specifier = ">=1.9.0,<3" },
     { name = "sniffio" },
-    { name = "typing-extensions", specifier = ">=4.10,<5" },
+    { name = "typing-extensions", specifier = ">=4.14,<5" },
 ]
 provides-extras = ["aiohttp"]
 

gmt_python_sdk-0.24.0/.release-please-manifest.json

@@ -1,3 +0,0 @@
-{
-  ".": "0.24.0"
-}