gmt-python-sdk 0.35.1__tar.gz → 0.37.0__tar.gz

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

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

{gmt_python_sdk-0.35.1 → gmt_python_sdk-0.37.0}/CHANGELOG.md

@@ -1,5 +1,36 @@
 # Changelog
 
+## 0.37.0 (2026-04-28)
+
+Full Changelog: [v0.36.0...v0.37.0](https://github.com/cameo6/gmt-python-sdk/compare/v0.36.0...v0.37.0)
+
+### Features
+
+* support setting headers via env ([c55427d](https://github.com/cameo6/gmt-python-sdk/commit/c55427de52cb37445691ee9be890e94144394e3c))
+
+
+### Bug Fixes
+
+* use correct field name format for multipart file arrays ([ddbca94](https://github.com/cameo6/gmt-python-sdk/commit/ddbca94beeb11a9012d71d216788d4906dd8880e))
+
+
+### Performance Improvements
+
+* **client:** optimize file structure copying in multipart requests ([7a46aa1](https://github.com/cameo6/gmt-python-sdk/commit/7a46aa13908eb43a8f5d2d004a938ea604e22f4a))
+
+
+### Chores
+
+* **internal:** more robust bootstrap script ([1248c86](https://github.com/cameo6/gmt-python-sdk/commit/1248c865522e5e041927e73fac626d2cb7acf234))
+
+## 0.36.0 (2026-04-11)
+
+Full Changelog: [v0.35.1...v0.36.0](https://github.com/cameo6/gmt-python-sdk/compare/v0.35.1...v0.36.0)
+
+### Features
+
+* **api:** api update ([8a698e3](https://github.com/cameo6/gmt-python-sdk/commit/8a698e3b7766f2a73b6d555df4f00c1579ce110d))
+
 ## 0.35.1 (2026-04-11)
 
 Full Changelog: [v0.35.0...v0.35.1](https://github.com/cameo6/gmt-python-sdk/compare/v0.35.0...v0.35.1)

{gmt_python_sdk-0.35.1 → gmt_python_sdk-0.37.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: gmt-python-sdk
-Version: 0.35.1
+Version: 0.37.0
 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

{gmt_python_sdk-0.35.1 → gmt_python_sdk-0.37.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "gmt-python-sdk"
-version = "0.35.1"
+version = "0.37.0"
 description = "The official Python library for the gmt API"
 dynamic = ["readme"]
 license = "Apache-2.0"

{gmt_python_sdk-0.35.1 → gmt_python_sdk-0.37.0}/src/gmt/_client.py

@@ -19,7 +19,11 @@ from ._types import (
     RequestOptions,
     not_given,
 )
-from ._utils import is_given, get_async_library
+from ._utils import (
+    is_given,
+    is_mapping_t,
+    get_async_library,
+)
 from ._compat import cached_property
 from ._version import __version__
 from ._streaming import Stream as Stream, AsyncStream as AsyncStream
@@ -83,6 +87,15 @@ class Gmt(SyncAPIClient):
         if base_url is None:
             base_url = f"https://api.getmytg.com"
 
+        custom_headers_env = os.environ.get("GMT_CUSTOM_HEADERS")
+        if custom_headers_env is not None:
+            parsed: dict[str, str] = {}
+            for line in custom_headers_env.split("\n"):
+                colon = line.find(":")
+                if colon >= 0:
+                    parsed[line[:colon].strip()] = line[colon + 1 :].strip()
+            default_headers = {**parsed, **(default_headers if is_mapping_t(default_headers) else {})}
+
         super().__init__(
             version=__version__,
             base_url=base_url,
@@ -329,6 +342,15 @@ class AsyncGmt(AsyncAPIClient):
         if base_url is None:
             base_url = f"https://api.getmytg.com"
 
+        custom_headers_env = os.environ.get("GMT_CUSTOM_HEADERS")
+        if custom_headers_env is not None:
+            parsed: dict[str, str] = {}
+            for line in custom_headers_env.split("\n"):
+                colon = line.find(":")
+                if colon >= 0:
+                    parsed[line[:colon].strip()] = line[colon + 1 :].strip()
+            default_headers = {**parsed, **(default_headers if is_mapping_t(default_headers) else {})}
+
         super().__init__(
             version=__version__,
             base_url=base_url,

{gmt_python_sdk-0.35.1 → gmt_python_sdk-0.37.0}/src/gmt/_files.py

@@ -3,8 +3,8 @@ from __future__ import annotations
 import io
 import os
 import pathlib
-from typing import overload
-from typing_extensions import TypeGuard
+from typing import Sequence, cast, overload
+from typing_extensions import TypeVar, TypeGuard
 
 import anyio
 
@@ -17,7 +17,9 @@ from ._types import (
     HttpxFileContent,
     HttpxRequestFiles,
 )
-from ._utils import is_tuple_t, is_mapping_t, is_sequence_t
+from ._utils import is_list, is_mapping, is_tuple_t, is_mapping_t, is_sequence_t
+
+_T = TypeVar("_T")
 
 
 def is_base64_file_input(obj: object) -> TypeGuard[Base64FileInput]:
@@ -121,3 +123,51 @@ async def async_read_file_content(file: FileContent) -> HttpxFileContent:
         return await anyio.Path(file).read_bytes()
 
     return file
+
+
+def deepcopy_with_paths(item: _T, paths: Sequence[Sequence[str]]) -> _T:
+    """Copy only the containers along the given paths.
+
+    Used to guard against mutation by extract_files without copying the entire structure.
+    Only dicts and lists that lie on a path are copied; everything else
+    is returned by reference.
+
+    For example, given paths=[["foo", "files", "file"]] and the structure:
+        {
+            "foo": {
+                "bar": {"baz": {}},
+                "files": {"file": <content>}
+            }
+        }
+    The root dict, "foo", and "files" are copied (they lie on the path).
+    "bar" and "baz" are returned by reference (off the path).
+    """
+    return _deepcopy_with_paths(item, paths, 0)
+
+
+def _deepcopy_with_paths(item: _T, paths: Sequence[Sequence[str]], index: int) -> _T:
+    if not paths:
+        return item
+    if is_mapping(item):
+        key_to_paths: dict[str, list[Sequence[str]]] = {}
+        for path in paths:
+            if index < len(path):
+                key_to_paths.setdefault(path[index], []).append(path)
+
+        # if no path continues through this mapping, it won't be mutated and copying it is redundant
+        if not key_to_paths:
+            return item
+
+        result = dict(item)
+        for key, subpaths in key_to_paths.items():
+            if key in result:
+                result[key] = _deepcopy_with_paths(result[key], subpaths, index + 1)
+        return cast(_T, result)
+    if is_list(item):
+        array_paths = [path for path in paths if index < len(path) and path[index] == "<array>"]
+
+        # if no path expects a list here, nothing will be mutated inside it - return by reference
+        if not array_paths:
+            return cast(_T, item)
+        return cast(_T, [_deepcopy_with_paths(entry, array_paths, index + 1) for entry in item])
+    return item

{gmt_python_sdk-0.35.1 → gmt_python_sdk-0.37.0}/src/gmt/_qs.py

@@ -2,17 +2,13 @@ from __future__ import annotations
 
 from typing import Any, List, Tuple, Union, Mapping, TypeVar
 from urllib.parse import parse_qs, urlencode
-from typing_extensions import Literal, get_args
+from typing_extensions import get_args
 
-from ._types import NotGiven, not_given
+from ._types import NotGiven, ArrayFormat, NestedFormat, not_given
 from ._utils import flatten
 
 _T = TypeVar("_T")
 
-
-ArrayFormat = Literal["comma", "repeat", "indices", "brackets"]
-NestedFormat = Literal["dots", "brackets"]
-
 PrimitiveData = Union[str, int, float, bool, None]
 # this should be Data = Union[PrimitiveData, "List[Data]", "Tuple[Data]", "Mapping[str, Data]"]
 # https://github.com/microsoft/pyright/issues/3555

{gmt_python_sdk-0.35.1 → gmt_python_sdk-0.37.0}/src/gmt/_types.py

@@ -47,6 +47,9 @@ AnyMapping = Mapping[str, object]
 ModelT = TypeVar("ModelT", bound=pydantic.BaseModel)
 _T = TypeVar("_T")
 
+ArrayFormat = Literal["comma", "repeat", "indices", "brackets"]
+NestedFormat = Literal["dots", "brackets"]
+
 
 # Approximates httpx internal ProxiesTypes and RequestFiles types
 # while adding support for `PathLike` instances

{gmt_python_sdk-0.35.1 → gmt_python_sdk-0.37.0}/src/gmt/_utils/__init__.py

@@ -24,7 +24,6 @@ from ._utils import (
     coerce_integer as coerce_integer,
     file_from_path as file_from_path,
     strip_not_given as strip_not_given,
-    deepcopy_minimal as deepcopy_minimal,
     get_async_library as get_async_library,
     maybe_coerce_float as maybe_coerce_float,
     get_required_header as get_required_header,

{gmt_python_sdk-0.35.1 → gmt_python_sdk-0.37.0}/src/gmt/_utils/_utils.py

@@ -17,11 +17,11 @@ from typing import (
 )
 from pathlib import Path
 from datetime import date, datetime
-from typing_extensions import TypeGuard
+from typing_extensions import TypeGuard, get_args
 
 import sniffio
 
-from .._types import Omit, NotGiven, FileTypes, HeadersLike
+from .._types import Omit, NotGiven, FileTypes, ArrayFormat, HeadersLike
 
 _T = TypeVar("_T")
 _TupleT = TypeVar("_TupleT", bound=Tuple[object, ...])
@@ -40,25 +40,45 @@ def extract_files(
     query: Mapping[str, object],
     *,
     paths: Sequence[Sequence[str]],
+    array_format: ArrayFormat = "brackets",
 ) -> list[tuple[str, FileTypes]]:
     """Recursively extract files from the given dictionary based on specified paths.
 
     A path may look like this ['foo', 'files', '<array>', 'data'].
 
+    ``array_format`` controls how ``<array>`` segments contribute to the emitted
+    field name. Supported values: ``"brackets"`` (``foo[]``), ``"repeat"`` and
+    ``"comma"`` (``foo``), ``"indices"`` (``foo[0]``, ``foo[1]``).
+
     Note: this mutates the given dictionary.
     """
     files: list[tuple[str, FileTypes]] = []
     for path in paths:
-        files.extend(_extract_items(query, path, index=0, flattened_key=None))
+        files.extend(_extract_items(query, path, index=0, flattened_key=None, array_format=array_format))
     return files
 
 
+def _array_suffix(array_format: ArrayFormat, array_index: int) -> str:
+    if array_format == "brackets":
+        return "[]"
+    if array_format == "indices":
+        return f"[{array_index}]"
+    if array_format == "repeat" or array_format == "comma":
+        # Both repeat the bare field name for each file part; there is no
+        # meaningful way to comma-join binary parts.
+        return ""
+    raise NotImplementedError(
+        f"Unknown array_format value: {array_format}, choose from {', '.join(get_args(ArrayFormat))}"
+    )
+
+
 def _extract_items(
     obj: object,
     path: Sequence[str],
     *,
     index: int,
     flattened_key: str | None,
+    array_format: ArrayFormat,
 ) -> list[tuple[str, FileTypes]]:
     try:
         key = path[index]
@@ -75,9 +95,11 @@ def _extract_items(
 
         if is_list(obj):
             files: list[tuple[str, FileTypes]] = []
-            for entry in obj:
-                assert_is_file_content(entry, key=flattened_key + "[]" if flattened_key else "")
-                files.append((flattened_key + "[]", cast(FileTypes, entry)))
+            for array_index, entry in enumerate(obj):
+                suffix = _array_suffix(array_format, array_index)
+                emitted_key = (flattened_key + suffix) if flattened_key else suffix
+                assert_is_file_content(entry, key=emitted_key)
+                files.append((emitted_key, cast(FileTypes, entry)))
             return files
 
         assert_is_file_content(obj, key=flattened_key)
@@ -106,6 +128,7 @@ def _extract_items(
             path,
             index=index,
             flattened_key=flattened_key,
+            array_format=array_format,
         )
     elif is_list(obj):
         if key != "<array>":
@@ -117,9 +140,12 @@ def _extract_items(
                     item,
                     path,
                     index=index,
-                    flattened_key=flattened_key + "[]" if flattened_key is not None else "[]",
+                    flattened_key=(
+                        (flattened_key if flattened_key is not None else "") + _array_suffix(array_format, array_index)
+                    ),
+                    array_format=array_format,
                 )
-                for item in obj
+                for array_index, item in enumerate(obj)
             ]
         )
 
@@ -177,21 +203,6 @@ def is_iterable(obj: object) -> TypeGuard[Iterable[object]]:
     return isinstance(obj, Iterable)
 
 
-def deepcopy_minimal(item: _T) -> _T:
-    """Minimal reimplementation of copy.deepcopy() that will only copy certain object types:
-
-    - mappings, e.g. `dict`
-    - list
-
-    This is done for performance reasons.
-    """
-    if is_mapping(item):
-        return cast(_T, {k: deepcopy_minimal(v) for k, v in item.items()})
-    if is_list(item):
-        return cast(_T, [deepcopy_minimal(entry) for entry in item])
-    return item
-
-
 # copied from https://github.com/Rapptz/RoboDanny
 def human_join(seq: Sequence[str], *, delim: str = ", ", final: str = "or") -> str:
     size = len(seq)

{gmt_python_sdk-0.35.1 → gmt_python_sdk-0.37.0}/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.35.1"  # x-release-please-version
+__version__ = "0.37.0"  # x-release-please-version

{gmt_python_sdk-0.35.1 → gmt_python_sdk-0.37.0}/src/gmt/resources/purchases/purchases.py

@@ -155,7 +155,7 @@ class PurchasesResource(SyncAPIResource):
         page_size: int,
         sort: Literal["date_asc", "date_desc"],
         phone_number: str | Omit = omit,
-        status: Literal["PENDING", "SUCCESS", "ERROR", "REFUND"] | Omit = omit,
+        status: Literal["PENDING", "SUCCESS", "ERROR", "REFUND", "EXPIRED"] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
@@ -456,7 +456,7 @@ class AsyncPurchasesResource(AsyncAPIResource):
         page_size: int,
         sort: Literal["date_asc", "date_desc"],
         phone_number: str | Omit = omit,
-        status: Literal["PENDING", "SUCCESS", "ERROR", "REFUND"] | Omit = omit,
+        status: Literal["PENDING", "SUCCESS", "ERROR", "REFUND", "EXPIRED"] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,

{gmt_python_sdk-0.35.1 → gmt_python_sdk-0.37.0}/src/gmt/types/purchase_create_response.py

@@ -105,7 +105,7 @@ class PurchaseCreateResponse(BaseModel):
     deduction)
     """
 
-    status: Literal["PENDING", "SUCCESS", "ERROR", "REFUND"]
+    status: Literal["PENDING", "SUCCESS", "ERROR", "REFUND", "EXPIRED"]
     """
     **Purchase Status Lifecycle.** `PENDING` (initial) → `SUCCESS` (after code
     request) or `ERROR` (provider failure). Any status can transition to `REFUND`

{gmt_python_sdk-0.35.1 → gmt_python_sdk-0.37.0}/src/gmt/types/purchase_list_params.py

@@ -23,7 +23,7 @@ class PurchaseListParams(TypedDict, total=False):
     Example: '123' matches '+71234567890'.
     """
 
-    status: Literal["PENDING", "SUCCESS", "ERROR", "REFUND"]
+    status: Literal["PENDING", "SUCCESS", "ERROR", "REFUND", "EXPIRED"]
     """
     **Purchase Status Lifecycle.** `PENDING` (initial) → `SUCCESS` (after code
     request) or `ERROR` (provider failure). Any status can transition to `REFUND`

{gmt_python_sdk-0.35.1 → gmt_python_sdk-0.37.0}/src/gmt/types/purchase_list_response.py

@@ -105,7 +105,7 @@ class PurchaseListResponse(BaseModel):
     deduction)
     """
 
-    status: Literal["PENDING", "SUCCESS", "ERROR", "REFUND"]
+    status: Literal["PENDING", "SUCCESS", "ERROR", "REFUND", "EXPIRED"]
     """
     **Purchase Status Lifecycle.** `PENDING` (initial) → `SUCCESS` (after code
     request) or `ERROR` (provider failure). Any status can transition to `REFUND`

{gmt_python_sdk-0.35.1 → gmt_python_sdk-0.37.0}/src/gmt/types/purchase_refund_response.py

@@ -113,7 +113,7 @@ class Purchase(BaseModel):
     deduction)
     """
 
-    status: Literal["PENDING", "SUCCESS", "ERROR", "REFUND"]
+    status: Literal["PENDING", "SUCCESS", "ERROR", "REFUND", "EXPIRED"]
     """
     **Purchase Status Lifecycle.** `PENDING` (initial) → `SUCCESS` (after code
     request) or `ERROR` (provider failure). Any status can transition to `REFUND`

{gmt_python_sdk-0.35.1 → gmt_python_sdk-0.37.0}/src/gmt/types/purchase_request_verification_code_response.py

@@ -129,7 +129,7 @@ class Purchase(BaseModel):
     deduction)
     """
 
-    status: Literal["PENDING", "SUCCESS", "ERROR", "REFUND"]
+    status: Literal["PENDING", "SUCCESS", "ERROR", "REFUND", "EXPIRED"]
     """
     **Purchase Status Lifecycle.** `PENDING` (initial) → `SUCCESS` (after code
     request) or `ERROR` (provider failure). Any status can transition to `REFUND`

{gmt_python_sdk-0.35.1 → gmt_python_sdk-0.37.0}/src/gmt/types/purchase_retrieve_response.py

@@ -105,7 +105,7 @@ class PurchaseRetrieveResponse(BaseModel):
     deduction)
     """
 
-    status: Literal["PENDING", "SUCCESS", "ERROR", "REFUND"]
+    status: Literal["PENDING", "SUCCESS", "ERROR", "REFUND", "EXPIRED"]
     """
     **Purchase Status Lifecycle.** `PENDING` (initial) → `SUCCESS` (after code
     request) or `ERROR` (provider failure). Any status can transition to `REFUND`

{gmt_python_sdk-0.35.1 → gmt_python_sdk-0.37.0}/src/gmt/types/purchases/bulk_create_response.py

@@ -23,7 +23,7 @@ class Item(BaseModel):
     quantity: int
     """Number of accounts in the archive"""
 
-    status: Literal["PENDING", "SUCCESS", "ERROR", "REFUND"]
+    status: Literal["PENDING", "SUCCESS", "ERROR", "REFUND", "EXPIRED"]
     """Status of bulk purchase"""
 
 
@@ -66,7 +66,7 @@ class BulkCreateResponse(BaseModel):
     quantity: int
     """Number of accounts in this purchase"""
 
-    status: Literal["PENDING", "SUCCESS", "ERROR", "REFUND"]
+    status: Literal["PENDING", "SUCCESS", "ERROR", "REFUND", "EXPIRED"]
     """Current status of bulk purchase"""
 
     total_price: TotalPrice

{gmt_python_sdk-0.35.1 → gmt_python_sdk-0.37.0}/src/gmt/types/purchases/bulk_retrieve_response.py

@@ -23,7 +23,7 @@ class Item(BaseModel):
     quantity: int
     """Number of accounts in the archive"""
 
-    status: Literal["PENDING", "SUCCESS", "ERROR", "REFUND"]
+    status: Literal["PENDING", "SUCCESS", "ERROR", "REFUND", "EXPIRED"]
     """Status of bulk purchase"""
 
 
@@ -66,7 +66,7 @@ class BulkRetrieveResponse(BaseModel):
     quantity: int
     """Number of accounts in this purchase"""
 
-    status: Literal["PENDING", "SUCCESS", "ERROR", "REFUND"]
+    status: Literal["PENDING", "SUCCESS", "ERROR", "REFUND", "EXPIRED"]
     """Current status of bulk purchase"""
 
     total_price: TotalPrice

{gmt_python_sdk-0.35.1 → gmt_python_sdk-0.37.0}/src/gmt/types/purchases_by_hash_request_verification_code_response.py

@@ -129,7 +129,7 @@ class Purchase(BaseModel):
     deduction)
     """
 
-    status: Literal["PENDING", "SUCCESS", "ERROR", "REFUND"]
+    status: Literal["PENDING", "SUCCESS", "ERROR", "REFUND", "EXPIRED"]
     """
     **Purchase Status Lifecycle.** `PENDING` (initial) → `SUCCESS` (after code
     request) or `ERROR` (provider failure). Any status can transition to `REFUND`

{gmt_python_sdk-0.35.1 → gmt_python_sdk-0.37.0}/src/gmt/types/purchases_by_hash_retrieve_response.py

@@ -105,7 +105,7 @@ class PurchasesByHashRetrieveResponse(BaseModel):
     deduction)
     """
 
-    status: Literal["PENDING", "SUCCESS", "ERROR", "REFUND"]
+    status: Literal["PENDING", "SUCCESS", "ERROR", "REFUND", "EXPIRED"]
     """
     **Purchase Status Lifecycle.** `PENDING` (initial) → `SUCCESS` (after code
     request) or `ERROR` (provider failure). Any status can transition to `REFUND`

{gmt_python_sdk-0.35.1 → gmt_python_sdk-0.37.0}/tests/test_extract_files.py

@@ -4,7 +4,7 @@ from typing import Sequence
 
 import pytest
 
-from gmt._types import FileTypes
+from gmt._types import FileTypes, ArrayFormat
 from gmt._utils import extract_files
 
 
@@ -37,10 +37,7 @@ def test_multiple_files() -> None:
 
 def test_top_level_file_array() -> None:
     query = {"files": [b"file one", b"file two"], "title": "hello"}
-    assert extract_files(query, paths=[["files", "<array>"]]) == [
-        ("files[]", b"file one"),
-        ("files[]", b"file two"),
-    ]
+    assert extract_files(query, paths=[["files", "<array>"]]) == [("files[]", b"file one"), ("files[]", b"file two")]
     assert query == {"title": "hello"}
 
 
@@ -71,3 +68,24 @@ def test_ignores_incorrect_paths(
     expected: list[tuple[str, FileTypes]],
 ) -> None:
     assert extract_files(query, paths=paths) == expected
+
+
+@pytest.mark.parametrize(
+    "array_format,expected_top_level,expected_nested",
+    [
+        ("brackets", [("files[]", b"a"), ("files[]", b"b")], [("items[][file]", b"a"), ("items[][file]", b"b")]),
+        ("repeat", [("files", b"a"), ("files", b"b")], [("items[file]", b"a"), ("items[file]", b"b")]),
+        ("comma", [("files", b"a"), ("files", b"b")], [("items[file]", b"a"), ("items[file]", b"b")]),
+        ("indices", [("files[0]", b"a"), ("files[1]", b"b")], [("items[0][file]", b"a"), ("items[1][file]", b"b")]),
+    ],
+)
+def test_array_format_controls_file_field_names(
+    array_format: ArrayFormat,
+    expected_top_level: list[tuple[str, FileTypes]],
+    expected_nested: list[tuple[str, FileTypes]],
+) -> None:
+    top_level = {"files": [b"a", b"b"]}
+    assert extract_files(top_level, paths=[["files", "<array>"]], array_format=array_format) == expected_top_level
+
+    nested = {"items": [{"file": b"a"}, {"file": b"b"}]}
+    assert extract_files(nested, paths=[["items", "<array>", "file"]], array_format=array_format) == expected_nested