getstream 3.3.4__tar.gz → 3.5.0__tar.gz

getstream-3.5.0/.github/workflows/release.yml

@@ -0,0 +1,215 @@
+name: Release
+
+on:
+  workflow_dispatch:
+    inputs:
+      version_bump:
+        description: 'Version bump type for manual release'
+        required: true
+        default: 'patch'
+        type: choice
+        options:
+          - patch
+          - minor
+          - major
+      use_current_version:
+        description: 'Skip version bump and publish the version already set in pyproject.toml'
+        required: false
+        default: false
+        type: boolean
+  pull_request:
+    types: [closed]
+    branches:
+      - main
+
+concurrency:
+  group: release-${{ github.event.pull_request.base.ref || github.ref_name }}
+  cancel-in-progress: false
+
+permissions:
+  contents: read
+
+jobs:
+  prepare:
+    name: Prepare release
+    if: github.event_name == 'workflow_dispatch' || github.event.pull_request.merged == true
+    runs-on: ubuntu-latest
+    outputs:
+      should_release: ${{ steps.release_meta_final.outputs.should_release }}
+      bump: ${{ steps.release_meta_final.outputs.bump }}
+      previous_version: ${{ steps.release_meta_final.outputs.previous_version }}
+      version: ${{ steps.release_meta_final.outputs.version }}
+      tag: ${{ steps.release_meta_final.outputs.tag }}
+    steps:
+      - uses: actions/checkout@v5
+        with:
+          fetch-depth: 0
+          ref: ${{ github.event_name == 'pull_request' && github.event.pull_request.base.ref || github.ref_name }}
+
+      - name: Skip when PR is already released
+        id: already_released
+        run: |
+          if [ "${{ github.event_name }}" = "workflow_dispatch" ]; then
+            echo "value=false" >> "$GITHUB_OUTPUT"
+          else
+            if git log --oneline --grep="(pr #${{ github.event.pull_request.number }})" -n 1 | grep -q "chore(release):"; then
+              echo "value=true" >> "$GITHUB_OUTPUT"
+            else
+              echo "value=false" >> "$GITHUB_OUTPUT"
+            fi
+          fi
+
+      - name: Determine version bump (from PR metadata)
+        id: release_meta
+        if: github.event_name == 'pull_request' && steps.already_released.outputs.value != 'true'
+        env:
+          PR_TITLE: ${{ github.event.pull_request.title }}
+        run: |
+          python3 scripts/release/bump_version.py \
+            --title "$PR_TITLE" \
+            --output "$GITHUB_OUTPUT"
+
+      - name: Determine version bump (manual)
+        id: release_meta_manual
+        if: github.event_name == 'workflow_dispatch'
+        run: |
+          python3 scripts/release/bump_version.py \
+            --manual-bump "${{ github.event.inputs.version_bump }}" \
+            --use-current-version "${{ github.event.inputs.use_current_version }}" \
+            --output "$GITHUB_OUTPUT"
+
+      - name: Consolidate release metadata
+        id: release_meta_final
+        run: |
+          if [ "${{ steps.already_released.outputs.value }}" = "true" ]; then
+            echo "should_release=false" >> "$GITHUB_OUTPUT"
+            echo "bump=none" >> "$GITHUB_OUTPUT"
+            exit 0
+          fi
+          if [ "${{ github.event_name }}" = "workflow_dispatch" ]; then
+            echo "should_release=${{ steps.release_meta_manual.outputs.should_release }}" >> "$GITHUB_OUTPUT"
+            echo "bump=${{ steps.release_meta_manual.outputs.bump }}" >> "$GITHUB_OUTPUT"
+            echo "previous_version=${{ steps.release_meta_manual.outputs.previous_version }}" >> "$GITHUB_OUTPUT"
+            echo "version=${{ steps.release_meta_manual.outputs.version }}" >> "$GITHUB_OUTPUT"
+            echo "tag=${{ steps.release_meta_manual.outputs.tag }}" >> "$GITHUB_OUTPUT"
+          else
+            echo "should_release=${{ steps.release_meta.outputs.should_release }}" >> "$GITHUB_OUTPUT"
+            echo "bump=${{ steps.release_meta.outputs.bump }}" >> "$GITHUB_OUTPUT"
+            echo "previous_version=${{ steps.release_meta.outputs.previous_version }}" >> "$GITHUB_OUTPUT"
+            echo "version=${{ steps.release_meta.outputs.version }}" >> "$GITHUB_OUTPUT"
+            echo "tag=${{ steps.release_meta.outputs.tag }}" >> "$GITHUB_OUTPUT"
+          fi
+
+  test-unit:
+    name: Test (unit)
+    needs: prepare
+    if: needs.prepare.outputs.should_release == 'true'
+    uses: ./.github/workflows/run_tests.yml
+    with:
+      marker: 'not integration'
+    secrets: inherit
+
+  test-integration:
+    name: Test (integration)
+    needs: prepare
+    if: needs.prepare.outputs.should_release == 'true'
+    uses: ./.github/workflows/run_tests.yml
+    with:
+      marker: 'integration'
+    secrets: inherit
+
+  release:
+    name: 🚀 Release
+    needs: [prepare, test-unit, test-integration]
+    if: needs.prepare.outputs.should_release == 'true'
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      contents: write
+      id-token: write
+    steps:
+      - uses: actions/checkout@v5
+        with:
+          fetch-depth: 0
+          ref: ${{ github.event_name == 'pull_request' && github.event.pull_request.base.ref || github.ref_name }}
+
+      - uses: ./.github/actions/python-uv-setup
+
+      - name: Apply version bump
+        env:
+          VERSION: ${{ needs.prepare.outputs.version }}
+        run: |
+          python3 - <<'PY'
+          import os, re
+          from pathlib import Path
+          version = os.environ['VERSION']
+          path = Path('pyproject.toml')
+          text = path.read_text(encoding='utf-8')
+          pattern = re.compile(r'^version\s*=\s*"\d+\.\d+\.\d+"\s*$', re.MULTILINE)
+          new_text, count = pattern.subn(f'version = "{version}"', text, count=1)
+          if count == 0:
+              raise SystemExit('Could not update version line in pyproject.toml')
+          path.write_text(new_text, encoding='utf-8')
+          PY
+
+      - name: Commit version bump
+        env:
+          VERSION: ${{ needs.prepare.outputs.version }}
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git add pyproject.toml
+          if git diff --cached --quiet; then
+            echo "No version changes to commit."
+            exit 0
+          fi
+          if [ "${{ github.event_name }}" = "workflow_dispatch" ]; then
+            git commit -m "chore(release): v${VERSION} (manual)"
+            git push origin "HEAD:${{ github.ref_name }}"
+          else
+            git commit -m "chore(release): v${VERSION} (pr #${{ github.event.pull_request.number }})"
+            git push origin "HEAD:${{ github.event.pull_request.base.ref }}"
+          fi
+
+      - name: Create release tag
+        env:
+          TAG: ${{ needs.prepare.outputs.tag }}
+        run: |
+          if git rev-parse -q --verify "refs/tags/${TAG}" >/dev/null; then
+            echo "Tag ${TAG} already exists; skipping tag creation."
+            exit 0
+          fi
+          git tag "${TAG}"
+          git push origin "${TAG}"
+
+      - name: Clean dist directory
+        run: rm -rf dist
+
+      - name: Build distributions
+        run: uv build
+
+      - name: Publish to PyPI (Trusted Publishing)
+        run: uv publish
+
+      - name: Create release on GitHub
+        uses: ncipollo/release-action@v1
+        with:
+          tag: ${{ needs.prepare.outputs.tag }}
+          token: ${{ secrets.GITHUB_TOKEN }}
+          skipIfReleaseExists: true
+          body: |
+            Release v${{ needs.prepare.outputs.version }}
+
+            - Bump type: `${{ needs.prepare.outputs.bump }}`
+            - Previous: `${{ needs.prepare.outputs.previous_version }}`
+            - Next: `${{ needs.prepare.outputs.version }}`
+            - Trigger: `${{ github.event_name }}`
+
+            Install with: `pip install getstream==${{ needs.prepare.outputs.version }}`
+
+      - name: Verify pip install
+        env:
+          UV_NO_SOURCES: "1"
+        run: |
+          uv pip install "getstream==${{ needs.prepare.outputs.version }}" || \
+            echo "WARNING: pip install verification failed (PyPI index may need a moment to propagate)"

{getstream-3.3.4 → getstream-3.5.0}/.github/workflows/run_tests.yml

@@ -8,7 +8,7 @@ on:
         type: string
     secrets: { }
 concurrency:
-  group: ${{ github.workflow }}-${{ github.ref }}
+  group: ${{ github.workflow }}-${{ github.ref }}-${{ inputs.marker }}
   cancel-in-progress: true
 
 env:
@@ -49,7 +49,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        python-version: ["3.10", "3.11", "3.12", "3.13"]
+        python-version: ["3.10", "3.11", "3.12", "3.13", "3.14"]
     timeout-minutes: 30
     steps:
       - name: Checkout
@@ -75,7 +75,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        python-version: ["3.10", "3.11", "3.12", "3.13"]
+        python-version: ["3.10", "3.11", "3.12", "3.13", "3.14"]
     timeout-minutes: 30
     steps:
       - name: Checkout

getstream-3.5.0/CHANGELOG.md

@@ -0,0 +1,147 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+### Added
+
+- Standardized error hierarchy ([CHA-2958](https://linear.app/stream/issue/CHA-2958)).
+  New exception classes importable from `getstream` (also re-exported from
+  `getstream.exceptions`):
+    - `StreamException`: abstract base for every SDK error.
+    - `StreamApiException`: any HTTP 4xx/5xx response. Carries `status_code`,
+      `code`, `message`, `exception_fields`, `unrecoverable`,
+      `raw_response_body`, `more_info`, `details`. The `unrecoverable` flag
+      from `APIError` is now surfaced (was previously dropped on most paths).
+    - `StreamRateLimitException`: subclass of `StreamApiException` raised on
+      HTTP 429. Adds `retry_after: datetime.timedelta | None`, parsed from
+      `Retry-After` per RFC 7231 (integer seconds or HTTP-date). Missing or
+      unparseable headers map to `None`; past HTTP-dates clamp to `0`.
+    - `StreamTransportException`: raised when a network-layer failure (no
+      HTTP response received) propagates out of `httpx` — connection reset,
+      timeout, TLS handshake failure, DNS failure. Carries `error_type`
+      enum (`connection_reset` / `timeout` / `dns_failure` /
+      `tls_handshake_failed` / `unknown`). The original `httpx` exception
+      is preserved as `__cause__`.
+    - `StreamTaskException`: raised by `wait_for_task` when the polled task
+      ends in `status='failed'`. Carries `task_id`, `error_type`,
+      `description`, `stack_trace`, `version`.
+- `Stream.wait_for_task(task_id, *, poll_interval=1.0, timeout=60.0)` and
+  the matching async coroutine on `AsyncStream`. Polls `get_task` until the
+  task reaches a terminal state. On `completed` returns the
+  `StreamResponse[GetTaskResponse]`; on `failed` raises
+  `StreamTaskException` populated from `ErrorResult`; on timeout raises
+  `StreamTransportException(error_type='timeout')`.
+
+- Explicit HTTP connection pool configuration ([CHA-2956](https://linear.app/stream/issue/CHA-2956/connection-pooling)).
+  Four new kwargs on `Stream(...)` and `AsyncStream(...)`:
+    - `max_conns_per_host: int`: default `5`
+    - `idle_timeout: float` (seconds): default `55.0`
+    - `connect_timeout: float` (seconds): default `10.0`
+    - `request_timeout: float` (seconds): default `30.0` (was `6.0`; see Behavior changes)
+
+  These tune the underlying `httpx.Limits` and `httpx.Timeout`. The existing `http_client=` and `transport=` kwargs continue to act as escape hatches; when `http_client` is set, none of the four new kwargs apply. Env-var fallbacks for the new kwargs: `STREAM_MAX_CONNS_PER_HOST`, `STREAM_IDLE_TIMEOUT`, `STREAM_CONNECT_TIMEOUT`, `STREAM_REQUEST_TIMEOUT`.
+- INFO log on client construction (logger `getstream`) lists the effective pool config and whether a user-supplied `http_client` is in use.
+
+- Webhook handling spec helpers (CHA-2961): `UnknownEvent` dataclass for
+  forward-compat; `gunzip_payload`, `decode_sqs_payload`, `decode_sns_payload`
+  primitives; `parse_event` (returns typed event or `UnknownEvent` for
+  unrecognized discriminators); `verify_signature` canonical alias of
+  `verify_webhook_signature`; `verify_and_parse_webhook` HTTP composite
+  (gunzip + verify + parse); `parse_sqs` and `parse_sns` queue composites
+  (no signature parameter: queue transports are authenticated by AWS IAM,
+  so the backend emits no HMAC for queue messages today). Transparent gzip
+  via magic-byte detection.
+- New instance methods on `Stream` and `AsyncStream`:
+  `verify_signature(body, signature)` and
+  `verify_and_parse_webhook(body, signature)` that drop the api_secret parameter
+  in favor of the client's stored secret. Dual API: the module-level functions
+  in `getstream.webhook` remain available for callers who want explicit
+  secret control.
+- New instance methods on `Stream` / `AsyncStream`: `parse_sqs(message_body)`,
+  `parse_sns(notification_body)` (no signature; AWS IAM).
+- `InvalidWebhookError` exception type covering both signature mismatches and
+  malformed payloads. Distinguish failure modes via the exception message or
+  `__cause__` chain.
+- Conformance fixture suite under `tests/fixtures/webhooks/` (13 happy-path
+  event directories + 8 negative cases) for SDK conformance testing across
+  language ports.
+- Regenerated from the latest chat OpenAPI spec. New endpoints: `moderation.analyze`,
+  `moderation.bulk_action_appeals`, `moderation.get_setup_session`,
+  `moderation.upsert_setup_session`; `feeds.get_or_create_follow`,
+  `feeds.get_or_create_unfollow`, `feeds.get_user_interests`; `chat.create_segment`,
+  `chat.update_segment`, `chat.add_segment_targets`; `common.cancel_import_v2_task`;
+  `video.report_client_call_event`, together with the request/response models backing them.
+- New webhook event types `moderation.image_analysis.complete` and
+  `moderation.text_analysis.complete`, with `ModerationImageAnalysisCompleteEvent`
+  and `ModerationTextAnalysisCompleteEvent` models.
+
+### Changed
+
+- HTTP request errors raised by `httpx` (the `httpx.RequestError` family —
+  `ConnectError`, `ReadTimeout`, etc.) are now wrapped at the SDK boundary
+  in `StreamTransportException` so callers handle one Stream error category
+  instead of catching `httpx.RequestError` separately. The original `httpx`
+  exception is preserved via `__cause__` (CHA-2958).
+- **Default `request_timeout` is now `30.0` seconds (was `6.0`).** Aligns stream-py with the cross-SDK contract in CHA-2956. Existing callers using `timeout=` are unaffected; `timeout` is kept as an alias for `request_timeout`. Callers relying on the 6s ceiling for fail-fast behavior should pass `request_timeout=6.0` (or `timeout=6.0`) explicitly.
+- Default HTTP transport now caps connections per host at `5` and closes idle sockets after `55.0s`. Previous default was httpx's `100` max-connections with `5.0s` keep-alive expiry.
+- No breaking changes. All existing webhook helpers (`verify_webhook_signature`,
+  `parse_webhook_event`, `get_event_type`, event type constants) are preserved.
+- `FlagResponse` now represents the full flag record (`created_at`, `updated_at`,
+  `target_message`, `target_user`, `user`, `reason`, `details`, `custom`, and related
+  fields). The moderation flag-action acknowledgement, which carries `item_id` and
+  `duration`, moved to the new `FlagItemResponse`; `moderation.flag()` now returns
+  `FlagItemResponse`. The `/api/v2/moderation/flag` wire response is unchanged, so code
+  reading `item_id`/`duration` off the parsed response is unaffected. Code referencing
+  the `FlagResponse` type for those two fields should switch to `FlagItemResponse`.
+- `ChannelInput.config_overrides` and `ChannelDataUpdate.config_overrides` are now typed
+  as `ChannelConfigOverrides` (the override-specific field set) instead of `ChannelConfig`.
+- `enabled` on `DeliveryReceiptsResponse`, `ReadReceiptsResponse`, and
+  `TypingIndicatorsResponse` is now a required `bool` (was `Optional[bool]`).
+- `LLMRule.description`, `TargetResolution.bitrate`, and `TranslationSettings.languages` /
+  `TranslationSettings.enabled` are now optional.
+
+### Deprecated
+
+- `getstream.base.StreamAPIException` (capital `API`) is now an alias for
+  `getstream.exceptions.StreamApiException` (lowercase `Api`). Importing the
+  old name emits `DeprecationWarning`; existing `isinstance` / `except` /
+  `pytest.raises` checks continue to work because the alias resolves to the
+  same class. The legacy spelling will be removed one minor cycle after this
+  release (CHA-2958 §10).
+
+### Notes
+
+- Per-call `timeout=httpx.Timeout(...)` continues to work through `.get(...)`, `.post(...)`, etc., and pre-empts the client-level `request_timeout`.
+
+## [3.0.0b1] - 2026-02-27
+
+### Breaking Changes
+
+- Type names across all products now follow the OpenAPI spec naming convention: response types are suffixed with `Response`, input types with `Request`. See [MIGRATION_v2_to_v3.md](./MIGRATION_v2_to_v3.md) for the complete rename mapping.
+- `Event` (WebSocket envelope type) renamed to `WSEvent`. Base event type renamed from `BaseEvent` to `Event` (with field `type` instead of `T`).
+- Event composition changed from monolithic `*Preset` embeds to modular `Has*` types.
+- `Pager` renamed to `PagerResponse` and migrated from offset-based to cursor-based pagination (`next`/`prev` tokens).
+- Types that were previously `dict` or `TypedDict` (e.g., `User`, `Channel`, `Message`) are now full dataclasses with typed fields.
+
+### Added
+
+- Full product coverage: Chat, Video, Moderation, and Feeds APIs are all supported in a single SDK.
+- **Feeds**: activities, feeds, feed groups, follows, comments, reactions, collections, bookmarks, membership levels, feed views, and more.
+- **Video**: calls, recordings, transcription, closed captions, SFU, call statistics, user feedback analytics, and more.
+- **Moderation**: flags, review queue, moderation rules, config, appeals, moderation logs, and more.
+- Push notification types, preferences, and templates.
+- Webhook support: `WHEvent` envelope class for receiving webhook payloads, utility functions for decoding and verifying webhook signatures, and a full set of individual typed event dataclasses for every event across all products (Chat, Video, Moderation, Feeds) usable as discriminated event types.
+- Cursor-based pagination across all list endpoints.
+
+## [2.7.1] - 2026-02-18
+
+## [2.7.0] - 2026-02-03
+
+## [2.6.0] - 2025-12-11
+
+## [2.5.22] - 2025-10-15

{getstream-3.3.4 → getstream-3.5.0}/Makefile

@@ -56,11 +56,13 @@ TY_EXCLUDES := \
 
 ## Run non-video tests (chat, feeds, moderation, etc.)
 test:
-	uv run pytest -m "$(MARKER)" tests/ getstream/ $(VIDEO_IGNORE) $(MANUAL_IGNORE)
+	@uv run pytest -m "$(MARKER)" tests/ getstream/ $(VIDEO_IGNORE) $(MANUAL_IGNORE); \
+	ec=$$?; if [ $$ec -eq 5 ]; then echo "No tests matched marker '$(MARKER)' — treating as success."; exit 0; else exit $$ec; fi
 
 ## Run video/WebRTC tests only
 test-video:
-	uv run pytest -m "$(MARKER)" $(VIDEO_PATHS)
+	@uv run pytest -m "$(MARKER)" $(VIDEO_PATHS); \
+	ec=$$?; if [ $$ec -eq 5 ]; then echo "No tests matched marker '$(MARKER)' — treating as success."; exit 0; else exit $$ec; fi
 
 ## Run all tests (non-video + video), excluding manual tests
 test-all:

{getstream-3.3.4 → getstream-3.5.0}/PKG-INFO

@@ -1,15 +1,15 @@
 Metadata-Version: 2.4
 Name: getstream
-Version: 3.3.4
+Version: 3.5.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
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Requires-Python: <4.0.0,>=3.10
 Requires-Dist: dataclasses-json<0.7,>=0.6.0
 Requires-Dist: httpx>=0.28.1
@@ -31,13 +31,15 @@ Provides-Extra: webrtc
 Requires-Dist: aiohttp<4,>=3.13.2; extra == 'webrtc'
 Requires-Dist: aiortc<1.15.0,>=1.14.0; extra == 'webrtc'
 Requires-Dist: av<17,>=14.2.0; extra == 'webrtc'
-Requires-Dist: numpy<2.3,>=2.2.6; extra == 'webrtc'
+Requires-Dist: numpy<2.3,>=2.2.6; (python_version < '3.14') and extra == 'webrtc'
+Requires-Dist: numpy<2.4,>=2.3.2; (python_version >= '3.14') and extra == 'webrtc'
 Requires-Dist: numpy>=2.2.6; extra == 'webrtc'
 Requires-Dist: ping3>=4.0.8; extra == 'webrtc'
 Requires-Dist: protobuf>=4.25.1; extra == 'webrtc'
 Requires-Dist: protobuf>=6.31.1; extra == 'webrtc'
 Requires-Dist: python-dateutil>=2.8.2; extra == 'webrtc'
-Requires-Dist: scipy<1.16,>=1.15.3; extra == 'webrtc'
+Requires-Dist: scipy<1.16,>=1.15.3; (python_version < '3.14') and extra == 'webrtc'
+Requires-Dist: scipy<1.17,>=1.16.1; (python_version >= '3.14') and extra == 'webrtc'
 Requires-Dist: scipy>=1.15.3; extra == 'webrtc'
 Requires-Dist: soundfile>=0.13.1; extra == 'webrtc'
 Requires-Dist: structlog<24; extra == 'webrtc'
@@ -175,7 +177,7 @@ We use [uv](https://github.com/astral-sh/uv) to manage dependencies and run test
 ### 🚀 Quick Start
 
 **Prerequisites:**
-- Python 3.9+ (recommended: 3.12.2)
+- Python 3.10+ (recommended: 3.12.2)
 - [uv](https://github.com/astral-sh/uv) package manager
 
 **Setup:**
@@ -280,6 +282,23 @@ uv run pytest -v -s
 uv run pytest tests/test_video.py::test_specific_function -v
 ```
 
+## Releases
+
+Releases use two paths:
+
+- **Default**: automatic release when a PR is merged to `main`. The PR title (and body) drives the semver bump.
+- **Fallback**: manual release via the `Release` workflow's `workflow_dispatch` (admin use). Select a `version_bump` (`patch`/`minor`/`major`). `use_current_version=true` skips the bump and publishes whatever is already in `pyproject.toml`.
+
+Automatic semver bump rules:
+
+- `feat:` -> minor
+- `fix:` (or `bug:`) -> patch
+- `feat!:`, `<type>(scope)!:`, or `BREAKING CHANGE` in the PR body/title -> major
+
+PRs with any other prefix do not trigger a release.
+
+The release pipeline runs lint, type-check, and the full test matrix (unit + integration, across all supported Python versions) on the merged commit before publishing to PyPI via Trusted Publishing (OIDC). Each step in the publish job is idempotent: a failed run can be re-dispatched from the Actions UI.
+
 ## License
 
 This project is licensed under the [MIT License](LICENSE).

{getstream-3.3.4 → getstream-3.5.0}/README.md

@@ -125,7 +125,7 @@ We use [uv](https://github.com/astral-sh/uv) to manage dependencies and run test
 ### 🚀 Quick Start
 
 **Prerequisites:**
-- Python 3.9+ (recommended: 3.12.2)
+- Python 3.10+ (recommended: 3.12.2)
 - [uv](https://github.com/astral-sh/uv) package manager
 
 **Setup:**
@@ -230,6 +230,23 @@ uv run pytest -v -s
 uv run pytest tests/test_video.py::test_specific_function -v
 ```
 
+## Releases
+
+Releases use two paths:
+
+- **Default**: automatic release when a PR is merged to `main`. The PR title (and body) drives the semver bump.
+- **Fallback**: manual release via the `Release` workflow's `workflow_dispatch` (admin use). Select a `version_bump` (`patch`/`minor`/`major`). `use_current_version=true` skips the bump and publishes whatever is already in `pyproject.toml`.
+
+Automatic semver bump rules:
+
+- `feat:` -> minor
+- `fix:` (or `bug:`) -> patch
+- `feat!:`, `<type>(scope)!:`, or `BREAKING CHANGE` in the PR body/title -> major
+
+PRs with any other prefix do not trigger a release.
+
+The release pipeline runs lint, type-check, and the full test matrix (unit + integration, across all supported Python versions) on the merged commit before publishing to PyPI via Trusted Publishing (OIDC). Each step in the publish job is idempotent: a failed run can be re-dispatched from the Actions UI.
+
 ## License
 
 This project is licensed under the [MIT License](LICENSE).

{getstream-3.3.4 → getstream-3.5.0}/generate.sh

@@ -17,7 +17,10 @@ fi
 set -ex
 
 # cd in API repo, generate new spec and then generate code from it
-( cd $SOURCE_PATH ; make openapi ; go run ./cmd/chat-manager openapi generate-client --language python --spec ./releases/v2/serverside-api.yaml --output ../stream-py/getstream/ )
+( cd $SOURCE_PATH ; make openapi ; ./build/chat-manager openapi generate-client --language python --spec ./releases/v2/serverside-api.yaml --output ../stream-py/getstream/ )
+
+# Regenerate webhook conformance fixtures (CHA-2961)
+( cd $SOURCE_PATH ; ./build/chat-manager openapi generate-webhook-fixtures --output ../stream-py/tests/assets/webhooks --time-format=unix-ns )
 
 # lint + auto-fix, then format generated code with ruff (align with pre-commit)
 uv run ruff check --fix getstream/ tests/

getstream-3.5.0/getstream/__init__.py

@@ -0,0 +1,9 @@
+from getstream.exceptions import (  # noqa: F401
+    StreamApiException,
+    StreamException,
+    StreamRateLimitException,
+    StreamTaskException,
+    StreamTransportException,
+)
+from getstream.stream import Stream  # noqa: F401
+from getstream.stream import AsyncStream  # noqa: F401