linq-python 0.2.3__py3-none-any.whl → 0.2.4__py3-none-any.whl

linq/_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

linq/_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,

linq/_utils/_utils.py

@@ -86,8 +86,9 @@ def _extract_items(
     index += 1
     if is_dict(obj):
         try:
-            # We are at the last entry in the path so we must remove the field
-            if (len(path)) == index:
+            # Remove the field if there are no more dict keys in the path,
+            # only "<array>" traversal markers or end.
+            if all(p == "<array>" for p in path[index:]):
                 item = obj.pop(key)
             else:
                 item = obj[key]
@@ -176,21 +177,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)

linq/_version.py

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

linq/resources/chats/typing.py

@@ -71,8 +71,20 @@ class TypingResource(SyncAPIResource):
         """
         Send a typing indicator to show that someone is typing in the chat.
 
-        **Note:** Group chat typing indicators are not currently supported. Attempting
-        to start a typing indicator in a group chat will return a `403` error.
+        ## Behavior & Limitations
+
+        Typing indicators are best-effort signals with the following limitations:
+
+        - **Active conversations only:** The recipient must have sent or received a
+          message in this chat within the **last 5 minutes**. If the chat is inactive,
+          the request is still accepted (`204`) but the indicator will not reach the
+          recipient's device.
+
+        - **No delivery guarantee:** Even for active chats, a `204` response only
+          indicates the request was accepted for processing.
+
+        - **Group chats not supported:** Attempting to start a typing indicator in a
+          group chat will return a `403` error.
 
         Args:
           extra_headers: Send extra headers
@@ -108,11 +120,12 @@ class TypingResource(SyncAPIResource):
         """
         Stop the typing indicator for the chat.
 
-        **Note:** Typing indicators are automatically stopped when a message is sent, so
-        calling this endpoint after sending a message is unnecessary.
+        Typing indicators are automatically stopped when a message is sent, so calling
+        this endpoint after sending a message is unnecessary.
+
+        See the `POST` endpoint above for behavior details and limitations.
 
-        **Note:** Group chat typing indicators are not currently supported. Attempting
-        to stop a typing indicator in a group chat will return a `403` error.
+        **Note:** Group chats are not supported and will return a `403` error.
 
         Args:
           extra_headers: Send extra headers
@@ -187,8 +200,20 @@ class AsyncTypingResource(AsyncAPIResource):
         """
         Send a typing indicator to show that someone is typing in the chat.
 
-        **Note:** Group chat typing indicators are not currently supported. Attempting
-        to start a typing indicator in a group chat will return a `403` error.
+        ## Behavior & Limitations
+
+        Typing indicators are best-effort signals with the following limitations:
+
+        - **Active conversations only:** The recipient must have sent or received a
+          message in this chat within the **last 5 minutes**. If the chat is inactive,
+          the request is still accepted (`204`) but the indicator will not reach the
+          recipient's device.
+
+        - **No delivery guarantee:** Even for active chats, a `204` response only
+          indicates the request was accepted for processing.
+
+        - **Group chats not supported:** Attempting to start a typing indicator in a
+          group chat will return a `403` error.
 
         Args:
           extra_headers: Send extra headers
@@ -224,11 +249,12 @@ class AsyncTypingResource(AsyncAPIResource):
         """
         Stop the typing indicator for the chat.
 
-        **Note:** Typing indicators are automatically stopped when a message is sent, so
-        calling this endpoint after sending a message is unnecessary.
+        Typing indicators are automatically stopped when a message is sent, so calling
+        this endpoint after sending a message is unnecessary.
+
+        See the `POST` endpoint above for behavior details and limitations.
 
-        **Note:** Group chat typing indicators are not currently supported. Attempting
-        to stop a typing indicator in a group chat will return a `403` error.
+        **Note:** Group chats are not supported and will return a `403` error.
 
         Args:
           extra_headers: Send extra headers

{linq_python-0.2.3.dist-info → linq_python-0.2.4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: linq-python
-Version: 0.2.3
+Version: 0.2.4
 Summary: The official Python library for the linq-api-v3 API
 Project-URL: Homepage, https://github.com/linq-team/linq-python
 Project-URL: Repository, https://github.com/linq-team/linq-python

{linq_python-0.2.3.dist-info → linq_python-0.2.4.dist-info}/RECORD

@@ -4,17 +4,17 @@ linq/_client.py,sha256=Z0Zu3KsWLftXW6xJuFeYWKqMMIpbJY6Wx8E_L_j7pSs,101591
 linq/_compat.py,sha256=_9guQfzYnL3DNtudX5W7T2cdSskx89B5AFfhPQDxMUk,6811
 linq/_constants.py,sha256=S14PFzyN9-I31wiV7SmIlL5Ga0MLHxdvegInGdXH7tM,462
 linq/_exceptions.py,sha256=HnBxvnHmvIRYibRyy9Nk3NdBifvtWsqV8Zj-hD0F0QM,3226
-linq/_files.py,sha256=KnEzGi_O756MvKyJ4fOCW_u3JhOeWPQ4RsmDvqihDQU,3545
+linq/_files.py,sha256=GsGgJfC6PEiO0d4ItFBMQlBrK8LLNpTaBdHa7T3EMDE,5452
 linq/_models.py,sha256=vJwz9yya-fpzvMT9srHbvfL4N_0-ZH9WbEWmM2m9NW4,32267
 linq/_qs.py,sha256=ExvESqZz_a5ZALZG1aR2rkzE35o9Rmk0yPMQtKN0DTo,4924
 linq/_resource.py,sha256=IvbBkxho8w_Ru0GHWOBUDwiuaI-CQoi8WWQJZCkfhyg,1118
 linq/_response.py,sha256=Pyf_g81OCXWawxoGZDNp6h1sHMlDgCOsM5vI9fGEBKE,28923
 linq/_streaming.py,sha256=zmn_k0MQ0d2f4KisSxNc4cqa3mTw2j75iPRyTL5jk9I,10562
 linq/_types.py,sha256=C3roEXRjDIicI14d6zJMb2C_vkZ8cffHg00DP0UrGYI,7639
-linq/_version.py,sha256=ff5ZCbMuq9M_5i_xlPYRU6jHOgxj64M_eaq2f45JmMo,156
+linq/_version.py,sha256=oJAcrdgiuajufLNIFBzD3cqSDzjykSv98MKxu1aX6DA,156
 linq/pagination.py,sha256=LxWl_sqhWdi6dYzDK1QyEIJd43fvxXMcCwF6Y4ill9I,2464
 linq/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-linq/_utils/__init__.py,sha256=DJEWihdzRWrZI23vwocBkgvZCwn9iG7yV0c_9vKaysU,2355
+linq/_utils/__init__.py,sha256=nQq-iFa5YxTaWySaLigatew5rHgTR0M75FNYm4mrO1s,2313
 linq/_utils/_compat.py,sha256=33246eDcl3pwL6kWsEhVuT4Akrd8gZEW9LPTm465ohk,1231
 linq/_utils/_datetime_parse.py,sha256=bABTs0Bc6rabdFvnIwXjEhWL15TcRgWZ_6XGTqN8xUk,4204
 linq/_utils/_json.py,sha256=bl95uuIWwgSfXX-gP1trK_lDAPwJujYfJ05Cxo2SEC4,962
@@ -27,7 +27,7 @@ linq/_utils/_streams.py,sha256=SMC90diFFecpEg_zgDRVbdR3hSEIgVVij4taD-noMLM,289
 linq/_utils/_sync.py,sha256=HBnZkkBnzxtwOZe0212C4EyoRvxhTVtTrLFDz2_xVCg,1589
 linq/_utils/_transform.py,sha256=NjCzmnfqYrsAikUHQig6N9QfuTVbKipuP3ur9mcNF-E,15951
 linq/_utils/_typing.py,sha256=N_5PPuFNsaygbtA_npZd98SVN1LQQvFTKL6bkWPBZGU,4786
-linq/_utils/_utils.py,sha256=ugfUaneOK7I8h9b3656flwf5u_kthY0gvNuqvgOLoSU,12252
+linq/_utils/_utils.py,sha256=9dXfN9bD4tR19GWM2SIrua3aBkJ995_5EBdo2NsmMqE,11893
 linq/lib/.keep,sha256=wuNrz-5SXo3jJaJOJgz4vFHM41YH_g20F5cRQo0vLes,224
 linq/resources/__init__.py,sha256=5K3fxu-Cf8pMBrTWLLy_9XX2VJXIvs66Wc-DbDgnQeE,4895
 linq/resources/attachments.py,sha256=uwtQ0Wz-I7-NdRdijoIHnSz5NURPPATBN3ckpEdIhbw,25001
@@ -43,7 +43,7 @@ linq/resources/chats/__init__.py,sha256=D05L41oxeBnO9uNvzHPMcgRD54JJLmwY07T73rjV
 linq/resources/chats/chats.py,sha256=D22GWoiBgiGXcio2gS_H3I6ISNe9KAobd1nqJcVbMQE,62742
 linq/resources/chats/messages.py,sha256=7Bp4RFLxHjldQiMruvZAds4EjLgU-PmlDhdXkeVPBAo,16216
 linq/resources/chats/participants.py,sha256=8Y0Qo84yWIDF9YJ-wm1s5fatPPkKs2cD8dGhPhO82sI,12959
-linq/resources/chats/typing.py,sha256=6Z0AVRF3ing2rAC_RyGKksnze-U5z_l5XKagmyvob7g,11808
+linq/resources/chats/typing.py,sha256=gIRJ5t_Q5EjrOZ8u737Uf77g0pxUco15msc9c_Fjr2Y,12802
 linq/types/__init__.py,sha256=ECn8TN-qe2XWCa5VE_8HVYKPjSUhZmuQi9vmwQT8jOI,6536
 linq/types/attachment_create_params.py,sha256=PBW1lQ1uC10MUHUexA9D0MrgzZbIjoLWUiebv4ZyfVA,2308
 linq/types/attachment_create_response.py,sha256=MmZjUj2HMrvt1A6EKM5INSUwc_VNSmjtWdLfRZpFuIA,1230
@@ -134,7 +134,7 @@ linq/types/shared_params/__init__.py,sha256=FZWRsA1D5DW6IXxenxo9U8-bDW6YiizL-xaw
 linq/types/shared_params/reaction_type.py,sha256=MP4ekeDAr9lK0wqdvl6FMVa5s0j2w6JhwF8TcF48aSA,317
 linq/types/shared_params/service_type.py,sha256=AV_VS3d0v059_wou2dts8Jy-NzbGFXa3_VRRpG42N48,259
 linq/types/shared_params/text_decoration.py,sha256=H-ph17ldBaFRNhajm77DfqjjtQbTNFJj9sepoHHcD80,881
-linq_python-0.2.3.dist-info/METADATA,sha256=UJyEgT8whKz9QeWqu2IDutsVNC5QQxpdGwAIFto6nsM,17384
-linq_python-0.2.3.dist-info/WHEEL,sha256=C2FUgwZgiLbznR-k0b_5k3Ai_1aASOXDss3lzCUsUug,87
-linq_python-0.2.3.dist-info/licenses/LICENSE,sha256=zP4mO5gBwuMBJx2-sVWVdjklSfevmIQT68JUQfvjy40,11341
-linq_python-0.2.3.dist-info/RECORD,,
+linq_python-0.2.4.dist-info/METADATA,sha256=cNSLEscU0xkDKJMxn6i1Kf-gVFZp6Y7hSwaqyiNMpkQ,17384
+linq_python-0.2.4.dist-info/WHEEL,sha256=C2FUgwZgiLbznR-k0b_5k3Ai_1aASOXDss3lzCUsUug,87
+linq_python-0.2.4.dist-info/licenses/LICENSE,sha256=zP4mO5gBwuMBJx2-sVWVdjklSfevmIQT68JUQfvjy40,11341
+linq_python-0.2.4.dist-info/RECORD,,