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

supabase / supabase-py / 42050400294
98%

Build:
DEFAULT BRANCH: main
Ran 05 Nov 2026 02:59PM UTC
Jobs 42
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

05 Nov 2026 02:59PM UTC coverage: 95.606% (+0.007%) from 95.599%
42050400294

push

github

web-flow
fix(supabase)!: replace the last option typeddicts with dataclasses (#1999)

Point 2 of #1251 is to stop using `dict` and `TypedDict` for options.
Realtime was converted earlier. This PR converts the option types that
were still left in `supabase` and `storage3`.

## Changes

- `supabase.RealtimeClientOptions` is now a frozen dataclass with
`heartbeat_interval` (default 25) and `heartbeat_timeout` (default 5).
`ClientOptions.realtime` defaults to `RealtimeClientOptions()` instead
of `None`, and `AsyncClient.realtime` passes the fields to
`connect_once` instead of unpacking a dict. `RealtimeClientOptions` is
now exported from `supabase`.
- `storage3.types.SortByV2` is now a dataclass with `column` (default
`"name"`) and `order` (default `"asc"`), like the v1 `SortByType`. These
are also the defaults the storage server uses when `sortBy` is left out.
- The unused `SearchV2Options` and `UploadData` `TypedDict`s are
removed, also from `sdk-compliance.yaml`.
- `realtime.types.DEFAULT_HEARTBEAT_TIMEOUT` holds the 5 second default,
so `connect_once`, `RealtimeClient` and `RealtimeClientOptions` share
it.
- `MIGRATION.md` describes the change.

`FunctionsApiErrorDict` stays a `TypedDict`, since it describes a parsed
error payload and is not an option.

## Breaking changes

```python
# Before
ClientOptions(realtime={"heartbeat_interval": 30})
bucket.list_v2(sort_by={"column": "created_at", "order": "desc"})

# After
ClientOptions(realtime=RealtimeClientOptions(heartbeat_interval=30))
bucket.list_v2(sort_by=SortByV2(column="created_at", order="desc"))
```

## Tests

- `ClientOptions.replace` keeps and replaces realtime options, and the
defaults match realtime's.
- `AsyncClient.realtime` passes the configured heartbeat values to the
connection.
- `list_v2` sends `sortBy` correctly, with and without explicit values,
for both the sync and async clients.

Linear: SDK-2853

9705 of 10151 relevant lines covered (95.61%)

5.85 hits per line

Coverage Regressions

Lines Coverage ∆ File
11
92.63
0.0% src/realtime/client.py
2
97.84
0.02% src/realtime/types.py
2
98.66
0.11% tests/test_file_api.py
1
97.52
0.0% src/supabase/client.py
Jobs
ID Job ID Ran Files Coverage
1 supabase-py3.13-highest - 42050400294.1 05 Nov 2026 02:59PM UTC 20
99.46
GitHub Action Run
2 auth-py3.13-highest - 42050400294.2 05 Nov 2026 03:00PM UTC 36
91.55
GitHub Action Run
3 realtime-py3.11-highest - 42050400294.3 05 Nov 2026 03:01PM UTC 9
96.24
GitHub Action Run
4 supabase-py3.11-lowest-direct - 42050400294.4 05 Nov 2026 03:00PM UTC 20
99.46
GitHub Action Run
5 utils-py3.15-highest - 42050400294.5 05 Nov 2026 02:59PM UTC 19
99.5
GitHub Action Run
6 auth-py3.15-highest - 42050400294.6 05 Nov 2026 03:00PM UTC 36
91.52
GitHub Action Run
7 utils-py3.12-highest - 42050400294.7 05 Nov 2026 02:59PM UTC 19
99.51
GitHub Action Run
8 functions-py3.14-highest - 42050400294.8 05 Nov 2026 02:59PM UTC 15
97.61
GitHub Action Run
9 functions-py3.11-lowest-direct - 42050400294.9 05 Nov 2026 02:59PM UTC 15
97.61
GitHub Action Run
10 supabase-py3.11-highest - 42050400294.10 05 Nov 2026 02:59PM UTC 20
99.46
GitHub Action Run
11 functions-py3.15-highest - 42050400294.11 05 Nov 2026 03:00PM UTC 15
97.61
GitHub Action Run
12 postgrest-py3.12-highest - 42050400294.12 05 Nov 2026 03:01PM UTC 25
97.89
GitHub Action Run
13 utils-py3.11-lowest-direct - 42050400294.13 05 Nov 2026 02:59PM UTC 19
99.51
GitHub Action Run
14 utils-py3.11-highest - 42050400294.14 05 Nov 2026 02:59PM UTC 19
99.51
GitHub Action Run
15 realtime-py3.12-highest - 42050400294.15 05 Nov 2026 03:01PM UTC 9
95.95
GitHub Action Run
16 storage-py3.15-highest - 42050400294.16 05 Nov 2026 03:02PM UTC 22
93.8
GitHub Action Run
17 functions-py3.12-highest - 42050400294.17 05 Nov 2026 02:59PM UTC 15
97.61
GitHub Action Run
18 storage-py3.11-highest - 42050400294.18 05 Nov 2026 03:01PM UTC 22
93.82
GitHub Action Run
19 functions-py3.13-highest - 42050400294.19 05 Nov 2026 02:59PM UTC 15
97.61
GitHub Action Run
20 storage-py3.14-highest - 42050400294.20 05 Nov 2026 03:01PM UTC 22
93.8
GitHub Action Run
21 supabase-py3.12-highest - 42050400294.21 05 Nov 2026 02:59PM UTC 20
99.46
GitHub Action Run
22 functions-py3.11-highest - 42050400294.22 05 Nov 2026 02:59PM UTC 15
97.61
GitHub Action Run
23 utils-py3.14-highest - 42050400294.23 05 Nov 2026 02:59PM UTC 19
99.5
GitHub Action Run
24 postgrest-py3.13-highest - 42050400294.24 05 Nov 2026 03:01PM UTC 25
97.89
GitHub Action Run
25 postgrest-py3.14-highest - 42050400294.25 05 Nov 2026 03:01PM UTC 25
97.89
GitHub Action Run
26 utils-py3.13-highest - 42050400294.26 05 Nov 2026 02:59PM UTC 19
99.51
GitHub Action Run
27 realtime-py3.11-lowest-direct - 42050400294.27 05 Nov 2026 03:01PM UTC 9
96.1
GitHub Action Run
28 realtime-py3.15-highest - 42050400294.28 05 Nov 2026 03:01PM UTC 9
95.62
GitHub Action Run
29 storage-py3.11-lowest-direct - 42050400294.29 05 Nov 2026 03:01PM UTC 22
93.82
GitHub Action Run
30 auth-py3.14-highest - 42050400294.30 05 Nov 2026 03:00PM UTC 36
91.52
GitHub Action Run
31 postgrest-py3.11-highest - 42050400294.31 05 Nov 2026 03:01PM UTC 25
97.89
GitHub Action Run
32 auth-py3.11-lowest-direct - 42050400294.32 05 Nov 2026 03:00PM UTC 36
91.55
GitHub Action Run
33 auth-py3.11-highest - 42050400294.33 05 Nov 2026 03:00PM UTC 36
91.55
GitHub Action Run
34 auth-py3.12-highest - 42050400294.34 05 Nov 2026 03:00PM UTC 36
91.55
GitHub Action Run
35 postgrest-py3.15-highest - 42050400294.35 05 Nov 2026 03:01PM UTC 25
97.89
GitHub Action Run
36 realtime-py3.14-highest - 42050400294.36 05 Nov 2026 03:01PM UTC 9
95.62
GitHub Action Run
37 supabase-py3.14-highest - 42050400294.37 05 Nov 2026 02:59PM UTC 20
99.46
GitHub Action Run
38 supabase-py3.15-highest - 42050400294.38 05 Nov 2026 03:01PM UTC 20
99.46
GitHub Action Run
39 storage-py3.12-highest - 42050400294.39 05 Nov 2026 03:01PM UTC 22
93.82
GitHub Action Run
40 realtime-py3.13-highest - 42050400294.40 05 Nov 2026 03:01PM UTC 9
95.95
GitHub Action Run
41 storage-py3.13-highest - 42050400294.41 05 Nov 2026 03:01PM UTC 22
93.82
GitHub Action Run
42 postgrest-py3.11-lowest-direct - 42050400294.42 05 Nov 2026 03:01PM UTC 25
97.89
GitHub Action Run
Source Files on build 42050400294
  • Tree
  • List 121
  • Changed 10
  • Source Changed 0
  • Coverage Changed 10
Coverage ∆ File Lines Relevant Covered Missed Hits/Line
  • Back to Repo
  • Github Actions Build #42050400294
  • 82f4ce99 on github
  • Prev Build on main (#42035907963)
  • Next Build on main (#42052437034)
  • 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