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

supabase / supabase-py / 42251592050
98%

Build:
DEFAULT BRANCH: main
Ran 06 Nov 2026 04:21PM UTC
Jobs 35
Files 123
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 04:21PM UTC coverage: 95.837% (+0.2%) from 95.675%
42251592050

push

github

web-flow
feat!: add configurable request timeouts for every service (#2010)

## Summary

The v3 HTTP layer had no timeout concept. The storage clients accepted
`timeout` and ignored it, and the only way to change a timeout was to
pass your own httpx or aiohttp client, which set one value for every
service. With the client `create_client` builds, httpx's default of 5
seconds applied to everything, which cuts off edge functions and slow
storage transfers.

This follows the Flutter design (SDK-2133): one global timeout, a
per-service override, and per-call overrides for the database and
functions.

## Changes

**utils**
* `Request` and `EmptyRequest` get a `timeout` field, and `SyncHttpIO`
and `AsyncHttpIO` take a default `request_timeout` that fills it in for
requests without their own.
* The httpx adapter sends it as a `Timeout` on the request (connect,
read, write and pool). The aiohttp adapter sends it as a `ClientTimeout`
with `connect`, `sock_connect` and `sock_read`, and no total. Both are
idle timeouts: the timer restarts whenever data moves, so a large
transfer that keeps moving is not cut short.
* Both adapters raise the new `RequestTimeoutError`, a subclass of the
built-in `TimeoutError`, instead of a raw httpx or aiohttp exception.
This also applies to timeouts configured on the HTTP client itself.
* Non-positive and NaN timeouts are rejected with `ValueError`.

**Sub-clients**
* The postgrest, auth, admin, storage and functions client constructors
take a keyword-only `request_timeout`. `PostgrestClient.schema()` keeps
it.
* `request_timeout(seconds)` on postgrest query builders, next to
`retry()`, overrides it for one query. Retries keep it.
* `FunctionsClient.invoke()` takes `request_timeout` to override it for
one invocation.

**supabase**
* `ClientOptions` and `AsyncClientOptions` get a global
`request_timeout`, plus `postgrest_options`, `auth_options`,
`storage_options` and `functions_options` holding the new
`PostgrestClientOptions`, `AuthClient... (continued)

10082 of 10520 relevant lines covered (95.84%)

4.9 hits per line

Coverage Regressions

Lines Coverage ∆ File
35
77.25
0.0% src/supabase_auth/client.py
23
94.83
0.04% src/postgrest/request_builder.py
7
90.54
2.54% src/storage3/client.py
4
97.55
0.08% src/supabase/client.py
1
98.28
1.72% src/postgrest/client.py
Jobs
ID Job ID Ran Files Coverage
1 auth-py3.12-highest - 42251592050.1 06 Nov 2026 04:22PM UTC 36
91.54
GitHub Action Run
2 functions-py3.15-highest - 42251592050.2 06 Nov 2026 04:21PM UTC 15
97.55
GitHub Action Run
3 auth-py3.15-highest - 42251592050.3 06 Nov 2026 04:22PM UTC 36
91.51
GitHub Action Run
4 realtime-py3.14-highest - 42251592050.4 06 Nov 2026 04:22PM UTC 9
95.38
GitHub Action Run
5 supabase-py3.12-lowest-direct - 42251592050.5 06 Nov 2026 04:21PM UTC 20
99.57
GitHub Action Run
6 functions-py3.13-highest - 42251592050.6 06 Nov 2026 04:21PM UTC 15
97.55
GitHub Action Run
7 utils-py3.14-highest - 42251592050.7 06 Nov 2026 04:21PM UTC 20
99.57
GitHub Action Run
8 utils-py3.13-highest - 42251592050.8 06 Nov 2026 04:21PM UTC 20
99.58
GitHub Action Run
9 auth-py3.12-lowest-direct - 42251592050.9 06 Nov 2026 04:22PM UTC 36
91.54
GitHub Action Run
10 utils-py3.15-highest - 42251592050.10 06 Nov 2026 04:21PM UTC 20
99.57
GitHub Action Run
11 utils-py3.12-lowest-direct - 42251592050.11 06 Nov 2026 04:21PM UTC 20
99.58
GitHub Action Run
12 supabase-py3.13-highest - 42251592050.12 06 Nov 2026 04:21PM UTC 20
99.57
GitHub Action Run
13 postgrest-py3.12-highest - 42251592050.13 06 Nov 2026 04:22PM UTC 26
97.94
GitHub Action Run
14 storage-py3.12-highest - 42251592050.14 06 Nov 2026 04:22PM UTC 23
95.54
GitHub Action Run
15 auth-py3.13-highest - 42251592050.15 06 Nov 2026 04:22PM UTC 36
91.54
GitHub Action Run
16 auth-py3.14-highest - 42251592050.16 06 Nov 2026 04:22PM UTC 36
91.51
GitHub Action Run
17 functions-py3.12-lowest-direct - 42251592050.17 06 Nov 2026 04:21PM UTC 15
97.55
GitHub Action Run
18 realtime-py3.12-highest - 42251592050.18 06 Nov 2026 04:22PM UTC 9
95.88
GitHub Action Run
19 utils-py3.12-highest - 42251592050.19 06 Nov 2026 04:21PM UTC 20
99.58
GitHub Action Run
20 storage-py3.12-lowest-direct - 42251592050.20 06 Nov 2026 04:22PM UTC 23
95.54
GitHub Action Run
21 storage-py3.15-highest - 42251592050.21 06 Nov 2026 04:24PM UTC 23
95.53
GitHub Action Run
22 postgrest-py3.15-highest - 42251592050.22 06 Nov 2026 04:23PM UTC 26
97.93
GitHub Action Run
23 postgrest-py3.13-highest - 42251592050.23 06 Nov 2026 04:23PM UTC 26
97.94
GitHub Action Run
24 storage-py3.14-highest - 42251592050.24 06 Nov 2026 04:22PM UTC 23
95.53
GitHub Action Run
25 supabase-py3.12-highest - 42251592050.25 06 Nov 2026 04:21PM UTC 20
99.57
GitHub Action Run
26 realtime-py3.15-highest - 42251592050.26 06 Nov 2026 04:23PM UTC 9
95.54
GitHub Action Run
27 functions-py3.14-highest - 42251592050.27 06 Nov 2026 04:21PM UTC 15
97.55
GitHub Action Run
28 supabase-py3.15-highest - 42251592050.28 06 Nov 2026 04:22PM UTC 20
99.57
GitHub Action Run
29 realtime-py3.13-highest - 42251592050.29 06 Nov 2026 04:23PM UTC 9
95.88
GitHub Action Run
30 functions-py3.12-highest - 42251592050.30 06 Nov 2026 04:21PM UTC 15
97.55
GitHub Action Run
31 realtime-py3.12-lowest-direct - 42251592050.31 06 Nov 2026 04:22PM UTC 9
95.88
GitHub Action Run
32 supabase-py3.14-highest - 42251592050.32 06 Nov 2026 04:21PM UTC 20
99.57
GitHub Action Run
33 storage-py3.13-highest - 42251592050.33 06 Nov 2026 04:22PM UTC 23
95.54
GitHub Action Run
34 postgrest-py3.12-lowest-direct - 42251592050.34 06 Nov 2026 04:23PM UTC 26
97.94
GitHub Action Run
35 postgrest-py3.14-highest - 42251592050.35 06 Nov 2026 04:23PM UTC 26
97.93
GitHub Action Run
Source Files on build 42251592050
  • Tree
  • List 123
  • Changed 22
  • Source Changed 0
  • Coverage Changed 22
Coverage ∆ File Lines Relevant Covered Missed Hits/Line
  • Back to Repo
  • Github Actions Build #42251592050
  • 50354b63 on github
  • Prev Build on main (#42245346092)
  • Next Build on main (#42591179073)
  • 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