getstream 7.0.0__tar.gz → 7.1.0__tar.gz

{getstream-7.0.0 → getstream-7.1.0}/.release-please-manifest.json

@@ -1,4 +1,4 @@
 {
-  ".": "7.0.0",
+  ".": "7.1.0",
   "getstream-rtc": "0.1.0"
 }

{getstream-7.0.0 → getstream-7.1.0}/CHANGELOG.md

@@ -7,6 +7,13 @@ Entries from 6.1.1 on are generated by release-please from commit messages; earl
 ones were written by hand in the [Keep a Changelog](https://keepachangelog.com/en/1.0.0/)
 format.
 
+## [7.1.0](https://github.com/GetStream/stream-py/compare/v7.0.0...v7.1.0) (2026-11-04)
+
+
+### Features
+
+* add NULL to send an explicit null in request bodies ([#314](https://github.com/GetStream/stream-py/issues/314)) ([955535e](https://github.com/GetStream/stream-py/commit/955535ed73d2016ccffc7924ed7c0ce60c641284))
+
 ## [7.0.0](https://github.com/GetStream/stream-py/compare/v6.1.1...v7.0.0) (2026-10-22)
 
 

{getstream-7.0.0 → getstream-7.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: getstream
-Version: 7.0.0
+Version: 7.1.0
 Summary: GetStream Python SDK - Build scalable activity feeds, chat, and video calling applications
 Author-email: sachaarbonel <sacha.arbonel@hotmail.fr>, tbarbugli <tbarbugli@gmail.com>
 License-File: LICENSE.md
@@ -186,6 +186,18 @@ client = Stream(api_key=..., api_secret=..., retry=RetryConfig(enabled=True, max
 
 Only idempotent `GET`/`HEAD` requests are retried, and only on HTTP 429 (unless the backend marked it unrecoverable) or a transport-level failure (timeout, connection reset, DNS, TLS). A 429's `Retry-After` header is honored (clamped to `max_backoff`); otherwise the delay uses full jitter over an exponential backoff. A retried failure logs `http.request.failed` at DEBUG; a final, non-retried failure logs it at ERROR (or not at all for a final 429, since that's already covered by `http.response.received`).
 
+### Sending null
+
+Request bodies drop `None` values inside objects, so an unset optional field never overwrites stored data. `None` items in a list are kept and sent as `null`. To store an explicit `null`, for example inside custom data, pass `NULL`:
+
+```python
+from getstream import NULL
+
+channel.update_channel_partial(set={"expires_at": NULL})
+```
+
+To remove a field instead, use `unset`, for example `unset=["expires_at"]`.
+
 ### App configuration
 
 ```python

{getstream-7.0.0 → getstream-7.1.0}/README.md

@@ -143,6 +143,18 @@ client = Stream(api_key=..., api_secret=..., retry=RetryConfig(enabled=True, max
 
 Only idempotent `GET`/`HEAD` requests are retried, and only on HTTP 429 (unless the backend marked it unrecoverable) or a transport-level failure (timeout, connection reset, DNS, TLS). A 429's `Retry-After` header is honored (clamped to `max_backoff`); otherwise the delay uses full jitter over an exponential backoff. A retried failure logs `http.request.failed` at DEBUG; a final, non-retried failure logs it at ERROR (or not at all for a final 429, since that's already covered by `http.response.received`).
 
+### Sending null
+
+Request bodies drop `None` values inside objects, so an unset optional field never overwrites stored data. `None` items in a list are kept and sent as `null`. To store an explicit `null`, for example inside custom data, pass `NULL`:
+
+```python
+from getstream import NULL
+
+channel.update_channel_partial(set={"expires_at": NULL})
+```
+
+To remove a field instead, use `unset`, for example `unset=["expires_at"]`.
+
 ### App configuration
 
 ```python

{getstream-7.0.0 → getstream-7.1.0}/docs/migration-from-stream-chat-python/README.md

@@ -20,6 +20,7 @@
 | Custom fields | Top-level dict keys | Nested in `custom` dict |
 | Response access | Dict keys (`response["users"]`) | Typed properties (`response.data.users`) |
 | Env vars | `STREAM_CHAT_TIMEOUT` | `STREAM_API_KEY`, `STREAM_API_SECRET`, `STREAM_TIMEOUT` |
+| `None` in request data | Sent as `null` | Dropped from objects, kept in lists; pass `getstream.NULL` to send `null` |
 
 ## Quick Example
 

{getstream-7.0.0 → getstream-7.1.0}/getstream/__init__.py

@@ -1,5 +1,6 @@
 import logging
 
+from getstream.utils import NULL  # noqa: F401
 from getstream.config import RetryConfig  # noqa: F401
 from getstream.exceptions import (  # noqa: F401
     StreamApiException,

{getstream-7.0.0 → getstream-7.1.0}/getstream/base.py

@@ -22,6 +22,7 @@ from getstream.generic import T
 import httpx
 from getstream.config import BaseConfig
 from getstream.version import VERSION
+from getstream.utils import NULL
 from urllib.parse import quote
 from abc import ABC
 from getstream.common.telemetry import (
@@ -144,7 +145,10 @@ def _read_file_bytes(file_path: str) -> bytes:
 
 def _strip_none(obj):
     """Recursively remove None values from dicts so unset optional fields
-    are omitted from the JSON body instead of being sent as null."""
+    are omitted from the JSON body instead of being sent as null. ``NULL``
+    becomes null."""
+    if obj is NULL:
+        return None
     if isinstance(obj, dict):
         return {k: _strip_none(v) for k, v in obj.items() if v is not None}
     if isinstance(obj, list):

{getstream-7.0.0 → getstream-7.1.0}/getstream/utils/__init__.py

@@ -1,3 +1,4 @@
+import enum
 import json
 import asyncio
 from typing import Dict, List, Optional, Union, cast
@@ -36,18 +37,27 @@ def validate_and_clean_url(url):
     return cleaned_url
 
 
-def encode_datetime(date: Optional[datetime]) -> Optional[str]:
+# An Enum member because dataclasses-json deep-copies dict values, and a deep copy of an Enum member is the member itself. Its value None makes JSON encoders write null.
+class _Null(enum.Enum):
+    NULL = None
+
+
+NULL = _Null.NULL
+"""Sends an explicit JSON ``null``. Request bodies drop ``None`` values inside objects, so use ``NULL`` where ``null`` must reach the API, for example inside custom data."""
+
+
+def encode_datetime(date: Union[datetime, _Null, None]) -> Union[str, _Null, None]:
     """
     Encodes a datetime object into an ISO 8601 formatted string.
 
     Args:
-    date (Optional[datetime]): The datetime object to encode.
+    date (Union[datetime, _Null, None]): The datetime object to encode.
 
     Returns:
-    Optional[str]: The ISO 8601 string representation of the datetime, or None if input is None.
+    Union[str, _Null, None]: The ISO 8601 string representation of the datetime, or the input unchanged if it is None or NULL.
     """
-    if date is None:
-        return None
+    if not isinstance(date, datetime):
+        return date
     return date.isoformat()
 
 

{getstream-7.0.0 → getstream-7.1.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "getstream"
-version = "7.0.0"
+version = "7.1.0"
 description = "GetStream Python SDK - Build scalable activity feeds, chat, and video calling applications"
 authors = [
     { name = "sachaarbonel", email = "sacha.arbonel@hotmail.fr" },

{getstream-7.0.0 → getstream-7.1.0}/uv.lock

@@ -863,7 +863,7 @@ wheels = [
 
 [[package]]
 name = "getstream"
-version = "7.0.0"
+version = "7.1.0"
 source = { editable = "." }
 dependencies = [
     { name = "dataclasses-json" },