• Home
  • Features
  • Pricing
  • Docs
  • Announcements
  • Sign In

supabase / supabase-py / 42219365473
98%

Build:
DEFAULT BRANCH: main
Ran 06 Nov 2026 12:39PM UTC
Jobs 35
Files 121
Run time 1min
Badge
Embed ▾
README BADGES
x

If you need to use a raster PNG badge, change the '.svg' to '.png' in the link

Markdown

Textile

RDoc

HTML

Rst

06 Nov 2026 12:39PM UTC coverage: 95.668% (+0.04%) from 95.631%
42219365473

push

github

web-flow
fix(realtime)!: honor heartbeat intervals below 15 seconds and accept float durations (#2006)

## What

The heartbeat loop slept for `max(heartbeat_interval, 15)`, so an
interval below 15 seconds was quietly raised to 15. Nothing warned about
it, and only the `RealtimeClientOptions` docstring and the SDK
compliance note mentioned it. The heartbeat durations were also typed
`int`, so a call like `heartbeat_timeout=2.5` failed type checking even
though it worked at runtime.

## Changes

- `RealtimeClient.heartbeat` now sleeps for exactly
`heartbeat_interval`.
- `heartbeat_interval` and `heartbeat_timeout` are typed `float` on
`connect_once`, `RealtimeClient` and `RealtimeClientOptions`.
- A new `realtime.types.validate_heartbeat` raises `ValueError` at
construction unless both durations are positive (NaN is rejected too).
`connect_once`, `RealtimeClient` and
`RealtimeClientOptions.__post_init__` all call it.
- `connect_once` gets a docstring that says the durations are in
seconds. The `RealtimeClientOptions` docstrings and the
`sdk-compliance.yaml` note no longer mention the 15 second minimum.
`MIGRATION.md` gets a section for the change.

## Breaking change

- Intervals below 15 seconds are now used as given, so heartbeats can be
sent more often than before.
- A zero or negative `heartbeat_interval` or `heartbeat_timeout` now
raises `ValueError`. Before, a zero or negative interval was raised to
15 seconds, and a zero or negative timeout made every heartbeat time
out.

## Tests

- `src/realtime/tests/test_heartbeat.py` starts a local WebSocket server
and checks that a 0.05 second interval sends 3 heartbeats within 5
seconds. With the old 15 second minimum this would have taken 30
seconds. The file also covers rejecting non-positive values and
accepting fractional ones.
- `src/supabase/tests/test_client_options.py` covers the same validation
and fractional values on `RealtimeClientOptions`.

SDK-2798

9805 of 10249 relevant lines covered (95.67%)

4.88 hits per line

Coverage Regressions

Lines Coverage ∆ File
12
93.75
1.64% src/realtime/client.py
3
97.92
0.07% src/realtime/types.py
Jobs
ID Job ID Ran Files Coverage
1 auth-py3.12-lowest-direct - 42219365473.1 06 Nov 2026 12:40PM UTC 36
91.53
GitHub Action Run
2 utils-py3.13-highest - 42219365473.2 06 Nov 2026 12:39PM UTC 19
99.51
GitHub Action Run
3 supabase-py3.15-highest - 42219365473.3 06 Nov 2026 12:40PM UTC 20
99.53
GitHub Action Run
4 functions-py3.14-highest - 42219365473.4 06 Nov 2026 12:39PM UTC 15
97.61
GitHub Action Run
5 storage-py3.14-highest - 42219365473.5 06 Nov 2026 12:41PM UTC 22
93.8
GitHub Action Run
6 utils-py3.14-highest - 42219365473.6 06 Nov 2026 12:39PM UTC 19
99.5
GitHub Action Run
7 auth-py3.13-highest - 42219365473.7 06 Nov 2026 12:40PM UTC 36
91.53
GitHub Action Run
8 supabase-py3.12-highest - 42219365473.8 06 Nov 2026 12:40PM UTC 20
99.53
GitHub Action Run
9 utils-py3.15-highest - 42219365473.9 06 Nov 2026 12:39PM UTC 19
99.5
GitHub Action Run
10 functions-py3.12-lowest-direct - 42219365473.10 06 Nov 2026 12:40PM UTC 15
97.61
GitHub Action Run
11 utils-py3.12-highest - 42219365473.11 06 Nov 2026 12:40PM UTC 19
99.51
GitHub Action Run
12 supabase-py3.13-highest - 42219365473.12 06 Nov 2026 12:40PM UTC 20
99.53
GitHub Action Run
13 storage-py3.12-highest - 42219365473.13 06 Nov 2026 12:41PM UTC 22
93.82
GitHub Action Run
14 storage-py3.15-highest - 42219365473.14 06 Nov 2026 12:42PM UTC 22
93.8
GitHub Action Run
15 realtime-py3.14-highest - 42219365473.15 06 Nov 2026 12:41PM UTC 9
95.93
GitHub Action Run
16 utils-py3.12-lowest-direct - 42219365473.16 06 Nov 2026 12:40PM UTC 19
99.51
GitHub Action Run
17 supabase-py3.14-highest - 42219365473.17 06 Nov 2026 12:40PM UTC 20
99.53
GitHub Action Run
18 storage-py3.12-lowest-direct - 42219365473.18 06 Nov 2026 12:41PM UTC 22
93.82
GitHub Action Run
19 realtime-py3.13-highest - 42219365473.19 06 Nov 2026 12:41PM UTC 9
96.38
GitHub Action Run
20 functions-py3.13-highest - 42219365473.20 06 Nov 2026 12:39PM UTC 15
97.61
GitHub Action Run
21 functions-py3.12-highest - 42219365473.21 06 Nov 2026 12:39PM UTC 15
97.61
GitHub Action Run
22 realtime-py3.12-lowest-direct - 42219365473.22 06 Nov 2026 12:41PM UTC 9
96.38
GitHub Action Run
23 postgrest-py3.14-highest - 42219365473.23 06 Nov 2026 12:41PM UTC 25
97.88
GitHub Action Run
24 postgrest-py3.15-highest - 42219365473.24 06 Nov 2026 12:41PM UTC 25
97.88
GitHub Action Run
25 storage-py3.13-highest - 42219365473.25 06 Nov 2026 12:41PM UTC 22
93.82
GitHub Action Run
26 auth-py3.14-highest - 42219365473.26 06 Nov 2026 12:40PM UTC 36
91.5
GitHub Action Run
27 auth-py3.12-highest - 42219365473.27 06 Nov 2026 12:40PM UTC 36
91.53
GitHub Action Run
28 realtime-py3.15-highest - 42219365473.28 06 Nov 2026 12:41PM UTC 9
96.1
GitHub Action Run
29 supabase-py3.12-lowest-direct - 42219365473.29 06 Nov 2026 12:39PM UTC 20
99.53
GitHub Action Run
30 realtime-py3.12-highest - 42219365473.30 06 Nov 2026 12:41PM UTC 9
96.53
GitHub Action Run
31 postgrest-py3.12-highest - 42219365473.31 06 Nov 2026 12:41PM UTC 25
97.89
GitHub Action Run
32 postgrest-py3.13-highest - 42219365473.32 06 Nov 2026 12:41PM UTC 25
97.89
GitHub Action Run
33 postgrest-py3.12-lowest-direct - 42219365473.33 06 Nov 2026 12:41PM UTC 25
97.89
GitHub Action Run
34 functions-py3.15-highest - 42219365473.34 06 Nov 2026 12:40PM UTC 15
97.61
GitHub Action Run
35 auth-py3.15-highest - 42219365473.35 06 Nov 2026 12:40PM UTC 36
91.5
GitHub Action Run
Source Files on build 42219365473
  • Tree
  • List 121
  • Changed 0
  • Source Changed 0
  • Coverage Changed 0
Coverage ∆ File Lines Relevant Covered Missed Hits/Line
  • Back to Repo
  • Github Actions Build #42219365473
  • c66e48ed on github
  • Prev Build on main (#42219341804)
  • Next Build on main (#42229782749)
  • Delete
STATUS · Troubleshooting · Open an Issue · Sales · Support · CAREERS · ENTERPRISE · START FREE TRIAL · SCHEDULE DEMO
ANNOUNCEMENTS · TWITTER · TOS & SLA · Supported CI Services · What's a CI service? · Automated Testing

© 2026 Coveralls, Inc