getstream 3.0.1__tar.gz → 3.0.2__tar.gz

getstream-3.0.2/.github/workflows/run_tests.yml

@@ -0,0 +1,92 @@
+name: _run-tests
+on:
+  workflow_call:
+    inputs:
+      marker:
+        description: 'pytest -m expression (e.g., `not integration` or `integration`)'
+        required: true
+        type: string
+    secrets: { }
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+env:
+  # If set, uv will run without updating the uv.lock file. Equivalent to the `uv run --frozen`.
+  UV_FROZEN: "1"
+
+jobs:
+  ruff:
+    name: Ruff
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v5
+      - name: Install dependencies
+        uses: ./.github/actions/python-uv-setup
+      - name: Run linter
+        run: make lint
+
+  typecheck:
+    name: Type Check (ty)
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v5
+      - name: Install dependencies
+        uses: ./.github/actions/python-uv-setup
+      - name: Run type checker
+        run: make typecheck
+
+  # ── Non-video tests (chat, feeds, etc.) ────────────────────────────
+  # Uses STREAM_CHAT_* credentials which do NOT have video enabled.
+  # Video paths and manual test paths are defined in the Makefile.
+  test-non-video:
+    name: Non-video tests (${{ matrix.python-version }})
+    environment:
+      name: ci
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13"]
+    timeout-minutes: 30
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v5
+      - name: Install dependencies
+        uses: ./.github/actions/python-uv-setup
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Run tests
+        env:
+          STREAM_API_KEY: ${{ vars.STREAM_CHAT_API_KEY }}
+          STREAM_API_SECRET: ${{ secrets.STREAM_CHAT_API_SECRET }}
+          STREAM_BASE_URL: ${{ vars.STREAM_CHAT_BASE_URL }}
+        run: make test MARKER="${{ inputs.marker }}"
+
+  # ── Video tests (video-enabled credentials) ─────────────────────
+  # Uses STREAM_* credentials which have video enabled.
+  test-video:
+    name: Video tests (${{ matrix.python-version }})
+    environment:
+      name: ci
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13"]
+    timeout-minutes: 30
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v5
+      - name: Install dependencies
+        uses: ./.github/actions/python-uv-setup
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Run tests
+        env:
+          STREAM_API_KEY: ${{ vars.STREAM_API_KEY }}
+          STREAM_API_SECRET: ${{ secrets.STREAM_API_SECRET }}
+          STREAM_BASE_URL: ${{ vars.STREAM_BASE_URL }}
+        run: make test-video MARKER="${{ inputs.marker }}"

getstream-3.0.2/DEVELOPMENT.md

@@ -0,0 +1,92 @@
+# Getstream Python SDK
+
+### Setup
+
+Clone the repo and install dependencies:
+
+```
+git clone git@github.com:GetStream/stream-py.git
+uv sync --no-sources --all-packages --all-extras --dev
+cp .env.example .env   # fill in your Stream credentials
+pre-commit install      # optional: enable commit hooks
+```
+
+### Running tests
+
+Run `make help` to see all available targets. The most common ones:
+
+```
+make test          # non-video tests (chat, feeds, moderation, etc.)
+make test-video    # video/WebRTC tests only
+make test-all      # both of the above
+```
+
+Non-video and video tests are split because they require different Stream credentials.
+The `MARKER` variable defaults to `"not integration"`. Override it for integration tests:
+
+```
+make test-integration              # runs both groups with -m "integration"
+make test MARKER="integration"     # or target a single group
+```
+
+Two manual tests exist for local telemetry inspection (excluded from CI):
+
+```
+make test-jaeger       # requires local Jaeger (docker run ... jaegertracing/all-in-one)
+make test-prometheus   # requires getstream[telemetry] deps
+```
+
+### Linting and type checking
+
+```
+make lint        # ruff check + format check
+make typecheck   # ty type checker (excludes generated code)
+```
+
+To auto-fix lint issues and format:
+
+```
+make format
+```
+
+Run lint, typecheck, and non-video tests in one go:
+
+```
+make check
+```
+
+### Code generation
+
+```
+make regen    # regenerate OpenAPI + WebRTC protobuf code
+```
+
+### Legacy: dev.py
+
+`dev.py` is an older CLI tool that predates the Makefile. It still works but does not
+handle the video/non-video test split or manual test exclusions. Prefer `make` targets.
+
+## Release
+
+Create a new release on Github, CI handles the rest. If you do need to do it manually follow these instructions:
+
+```
+rm -rf dist
+git tag v0.0.15
+uv run hatch version # this should show the right version
+git push origin main --tags
+uv build --all
+uv publish
+```
+
+## OpenAPI & Protobuf
+
+Most API endpoints use openAPI definitions.
+Part of the video endpoints use Protobuf.
+Use these commands to regenerate:
+
+```
+./generate.sh
+./generate_webrtc.sh
+```
+

getstream-3.0.2/Makefile

@@ -0,0 +1,124 @@
+.DEFAULT_GOAL := help
+
+# ── Pytest marker expression ───────────────────────────────────────
+# Override on the command line:  make test MARKER="integration"
+# Default excludes integration tests for everyday local development.
+MARKER ?= not integration
+
+# ── Video-related test paths (single source of truth) ──────────────
+# When you add a new video test file, add it here. Both test (via
+# --ignore) and test-video (via positional args) stay in sync.
+VIDEO_PATHS := \
+	getstream/video \
+	tests/rtc \
+	tests/test_audio_stream_track.py \
+	tests/test_connection_manager.py \
+	tests/test_connection_utils.py \
+	tests/test_signaling.py \
+	tests/test_video_examples.py \
+	tests/test_video_integration.py \
+	tests/test_video_openai.py \
+	tests/test_webrtc_generation.py
+
+# ── Manual tests (require local infrastructure, never run in CI) ───
+MANUAL_PATHS := \
+	tests/test_tracing_jaeger_manual.py \
+	tests/test_metrics_prometheus_manual.py
+
+# ── Derived ignore flags ──────────────────────────────────────────
+VIDEO_IGNORE  := $(addprefix --ignore=,$(VIDEO_PATHS))
+MANUAL_IGNORE := $(addprefix --ignore=,$(MANUAL_PATHS))
+
+# ── Typecheck exclusions ──────────────────────────────────────────
+TY_EXCLUDES := \
+	--exclude "getstream/models/" \
+	--exclude "getstream/video/rtc/pb/" \
+	--exclude "**/rest_client.py" \
+	--exclude "**/async_rest_client.py" \
+	--exclude "getstream/chat/channel.py" \
+	--exclude "getstream/chat/async_channel.py" \
+	--exclude "getstream/chat/client.py" \
+	--exclude "getstream/chat/async_client.py" \
+	--exclude "getstream/common/client.py" \
+	--exclude "getstream/common/async_client.py" \
+	--exclude "getstream/moderation/client.py" \
+	--exclude "getstream/moderation/async_client.py" \
+	--exclude "getstream/video/client.py" \
+	--exclude "getstream/video/async_client.py" \
+	--exclude "getstream/video/call.py" \
+	--exclude "getstream/video/async_call.py" \
+	--exclude "getstream/feeds/client.py" \
+	--exclude "getstream/feeds/feeds.py" \
+	--exclude "getstream/stream.py"
+
+# ── Targets ───────────────────────────────────────────────────────
+
+.PHONY: test test-video test-all test-integration test-jaeger test-prometheus lint format typecheck check regen help
+
+## Run non-video tests (chat, feeds, moderation, etc.)
+test:
+	uv run pytest -m "$(MARKER)" tests/ getstream/ $(VIDEO_IGNORE) $(MANUAL_IGNORE)
+
+## Run video/WebRTC tests only
+test-video:
+	uv run pytest -m "$(MARKER)" $(VIDEO_PATHS)
+
+## Run all tests (non-video + video), excluding manual tests
+test-all:
+	uv run pytest -m "$(MARKER)" tests/ getstream/ $(MANUAL_IGNORE)
+
+## Run integration tests for both groups
+test-integration:
+	$(MAKE) test MARKER="integration"
+	$(MAKE) test-video MARKER="integration"
+
+## Run the Jaeger tracing manual test (requires local Jaeger on :4317)
+test-jaeger:
+	uv run pytest -m "integration" tests/test_tracing_jaeger_manual.py
+
+## Run the Prometheus metrics manual test (requires telemetry deps)
+test-prometheus:
+	uv run pytest -m "integration" tests/test_metrics_prometheus_manual.py
+
+## Run Ruff linter and formatter check
+lint:
+	uv run ruff check .
+	uv run ruff format --check .
+
+## Auto-fix lint issues and format
+format:
+	uv run ruff check --fix .
+	uv run ruff format .
+
+## Run ty type checker
+typecheck:
+	uvx ty@0.0.24 check getstream/ $(TY_EXCLUDES)
+
+## Run full check: lint + typecheck + non-video tests
+check: lint typecheck test
+
+## Regenerate all generated code (OpenAPI + WebRTC protobuf)
+regen:
+	./generate.sh
+	./generate_webrtc.sh
+
+## Show available targets
+help:
+	@echo "Usage: make <target> [MARKER=\"...\"]"
+	@echo ""
+	@echo "Test targets:"
+	@echo "  test              Non-video tests (default MARKER='not integration')"
+	@echo "  test-video        Video/WebRTC tests only"
+	@echo "  test-all          All tests except manual infrastructure tests"
+	@echo "  test-integration  Integration tests (both non-video and video)"
+	@echo "  test-jaeger       Jaeger tracing manual test (needs Docker Jaeger)"
+	@echo "  test-prometheus   Prometheus metrics manual test (needs telemetry deps)"
+	@echo ""
+	@echo "Quality targets:"
+	@echo "  lint              Ruff linter + format check"
+	@echo "  format            Auto-fix lint issues and format code"
+	@echo "  typecheck         ty type checker"
+	@echo "  check             Full check: lint + typecheck + non-video tests"
+	@echo ""
+	@echo "Code generation:"
+	@echo "  regen             Regenerate OpenAPI + WebRTC protobuf code"

{getstream-3.0.1 → getstream-3.0.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: getstream
-Version: 3.0.1
+Version: 3.0.2
 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

{getstream-3.0.1 → getstream-3.0.2}/dev.py

@@ -2,6 +2,11 @@
 """
 Development CLI tool for getstream SDK.
 Essential dev commands for testing, linting, and type checking.
+
+NOTE: Prefer using the Makefile instead (run `make help` for available targets).
+The Makefile is a superset of this script.
+
+This script is kept for backwards compatibility.
 """
 
 import os

{getstream-3.0.1 → getstream-3.0.2}/getstream/video/rtc/audio_track.py

@@ -130,7 +130,7 @@ class AudioStreamTrack(aiortc.mediastreams.MediaStreamTrack):
                 )
 
                 # Drop from the beginning of the buffer to keep latest data
-                self._buffer = self._buffer[bytes_to_drop:]
+                del self._buffer[:bytes_to_drop]
 
             buffer_duration_ms = (
                 len(self._buffer)
@@ -192,7 +192,7 @@ class AudioStreamTrack(aiortc.mediastreams.MediaStreamTrack):
             if len(self._buffer) >= self._bytes_per_frame:
                 # We have enough data
                 audio_bytes = bytes(self._buffer[: self._bytes_per_frame])
-                self._buffer = self._buffer[self._bytes_per_frame :]
+                del self._buffer[: self._bytes_per_frame]
             elif len(self._buffer) > 0:
                 # We have some data but not enough - pad with silence
                 audio_bytes = bytes(self._buffer)

getstream-3.0.1/.github/workflows/run_tests.yml

@@ -1,108 +0,0 @@
-name: _run-tests
-on:
-  workflow_call:
-    inputs:
-      marker:
-        description: 'pytest -m expression (e.g., `not integration` or `integration`)'
-        required: true
-        type: string
-    secrets: { }
-concurrency:
-  group: ${{ github.workflow }}-${{ github.ref }}
-  cancel-in-progress: true
-
-env:
-  # If set, uv will run without updating the uv.lock file. Equivalent to the `uv run --frozen`.
-  UV_FROZEN: "1"
-
-jobs:
-  ruff:
-    name: Ruff
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v5
-      - name: Install dependencies
-        uses: ./.github/actions/python-uv-setup
-      - name: Run Ruff linter
-        run: uv run ruff check .
-      - name: Run Ruff formatter
-        run: uv run ruff format --check .
-
-  typecheck:
-    name: Type Check (ty)
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v5
-      - name: Install dependencies
-        uses: ./.github/actions/python-uv-setup
-      - name: Run ty type checker
-        run: |
-          uvx ty check getstream/ \
-            --exclude "getstream/models/" \
-            --exclude "getstream/video/rtc/pb/" \
-            --exclude "**/rest_client.py" \
-            --exclude "**/async_rest_client.py" \
-            --exclude "getstream/chat/channel.py" \
-            --exclude "getstream/chat/async_channel.py" \
-            --exclude "getstream/chat/client.py" \
-            --exclude "getstream/chat/async_client.py" \
-            --exclude "getstream/common/client.py" \
-            --exclude "getstream/common/async_client.py" \
-            --exclude "getstream/moderation/client.py" \
-            --exclude "getstream/moderation/async_client.py" \
-            --exclude "getstream/video/client.py" \
-            --exclude "getstream/video/async_client.py" \
-            --exclude "getstream/video/call.py" \
-            --exclude "getstream/video/async_call.py" \
-            --exclude "getstream/feeds/client.py" \
-            --exclude "getstream/feeds/feeds.py" \
-            --exclude "getstream/stream.py"
-
-  test:
-    name: Test "${{ inputs.marker }}"
-    environment:
-      name: ci
-    runs-on: ubuntu-latest
-    strategy:
-      fail-fast: false
-      matrix:
-        python-version: ["3.10", "3.11", "3.12", "3.13"]
-    timeout-minutes: 30
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v5
-      - name: Install dependencies
-        uses: ./.github/actions/python-uv-setup
-        with:
-          python-version: ${{ matrix.python-version }}
-      - name: Run non-video tests
-        env:
-          STREAM_API_KEY: ${{ vars.STREAM_CHAT_API_KEY }}
-          STREAM_API_SECRET: ${{ secrets.STREAM_CHAT_API_SECRET }}
-          STREAM_BASE_URL: ${{ vars.STREAM_CHAT_BASE_URL }}
-        run: |
-          uv run pytest -m "${{ inputs.marker }}" tests/ getstream/ \
-            --ignore=tests/rtc \
-            --ignore=tests/test_video_examples.py \
-            --ignore=tests/test_video_integration.py \
-            --ignore=tests/test_video_openai.py \
-            --ignore=tests/test_signaling.py \
-            --ignore=tests/test_audio_stream_track.py \
-            --ignore=getstream/video
-      - name: Run video tests
-        env:
-          STREAM_API_KEY: ${{ vars.STREAM_API_KEY }}
-          STREAM_API_SECRET: ${{ secrets.STREAM_API_SECRET }}
-          STREAM_BASE_URL: ${{ vars.STREAM_BASE_URL }}
-        run: |
-          uv run pytest -m "${{ inputs.marker }}" \
-            tests/rtc \
-            tests/test_video_examples.py \
-            tests/test_video_integration.py \
-            tests/test_video_openai.py \
-            tests/test_signaling.py \
-            tests/test_audio_stream_track.py \
-            getstream/video
-

getstream-3.0.1/DEVELOPMENT.md

@@ -1,80 +0,0 @@
-# Getstream Python SDK
-
-### Running tests
-
-Clone the repo and sync
-
-```
-git clone git@github.com:GetStream/stream-py.git
-uv sync --no-sources --all-packages --all-extras --dev
-```
-
-Env setup
-
-```
-cp .env.example .env
-```
-
-Run tests
-
-```
-uv run pytest -m "not integration" tests/ getstream/
-```
-
-### Commit hook
-
-```
-pre-commit install
-```
-
-### Check
-
-Shortcut to ruff, ty (type checker) and non integration tests:
-
-```
-uv run python dev.py
-```
-
-### Formatting
-
-```
-uv run ruff check --fix
-```
-
-### Type checking (ty)
-
-Type checking is run via the `ty` type checker, excluding generated code:
-
-```
-uv run python dev.py ty
-```
-
-Or manually (note: requires exclude flags for generated code - see dev.py for the full list):
-```
-uvx ty check getstream/ --exclude "getstream/models/" --exclude "getstream/video/rtc/pb/" ...
-```
-
-## Release
-
-Create a new release on Github, CI handles the rest. If you do need to do it manually follow these instructions:
-
-```
-rm -rf dist
-git tag v0.0.15
-uv run hatch version # this should show the right version
-git push origin main --tags
-uv build --all
-uv publish
-```
-
-## OpenAPI & Protobuf
-
-Most API endpoints use openAPI definitions.
-Part of the video endpoints use Protobuf.
-Use these commands to regenerate:
-
-```
-./generate.sh
-./generate_webrtc.sh
-```
-