supabase / supabase-flutter
87%

DEFAULT BRANCH: main
Repo Added
Token z3GUkNtD1PDnCOWpuPvCMvjUB924F4R9N regen
Build 1096 Last
Files 95
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

LAST BUILD ON BRANCH main
branch: SELECT
CHANGE BRANCH
x
Sync Branches

coverage: 87.204% (+0.003%) from 87.201%
29287704963

push

github

web-flow 
feat(postgrest): configurable auto-retry and request timeout (#1560)

## Summary

Makes the PostgREST client's automatic retry behavior configurable and
adds an optional per-request timeout that actually cancels a stalled
attempt. Previously the retry count and the retryable conditions were
hard-coded, and there was no way to bound the duration of a request.
Rebased on top of the request abort feature (#1368), whose
`AbortableRequest` support is what makes a real timeout possible.

All defaults preserve the current behavior, so the change is
non-breaking.

## Configurable auto-retry

New optional configuration on `PostgrestClient` (and per request via
`PostgrestBuilder.retry`):

- `retryEnabled` (default `true`): whether retries are performed for
retryable GET and HEAD requests.
- `retryCount` (default `3`): number of retry attempts for a retryable
request. A negative value throws an `ArgumentError`.
- `retryableStatusCodes` (default `{503, 520}`): HTTP status codes that
trigger a retry. The set is copied defensively so later mutation of the
caller's set does not change retry behavior.
- `PostgrestBuilder.retry({bool enabled = true, int? count, Duration?
requestTimeout})`: the per-request override now also accepts a `count`
and a `requestTimeout`. A `null` `requestTimeout` keeps the client-level
timeout.

The default retryable status codes are exposed as
`PostgrestClient.defaultRetryableStatusCodes`, since the client is where
retries are configured.

## Request timeout

`requestTimeout` is available on `PostgrestClient` and
`PostgrestClientOptions`, and can be overridden per request through
`PostgrestBuilder.retry`. It bounds how long a single request attempt
may take and is built on top of the abort mechanism from #1368, so it
actually cancels a stalled attempt through `AbortableRequest` rather
than leaving it running the way `Future.timeout` would. When `null` (the
default) no timeout is applied.

It is a per-attempt timeout, not a whole-operation d... (continued)

101 of 115 new or added lines in 10 files covered. (87.83%)

4743 of 5439 relevant lines covered (87.2%)

4.1 hits per line

Relevant lines Covered
5439 RELEVANT LINES 4743 COVERED LINES
4.1 HITS PER LINE
Source Files on main

Recent builds

Builds Branch Commit Type Ran Committer Via Coverage
29287704963 main feat(postgrest): configurable auto-retry and request timeout (#1560) ## Summary Makes the PostgREST client's automatic retry behavior configurable and adds an optional per-request timeout that actually cancels a stalled attempt. Previously the r... push web-flow github
87.2
29287244996 worktree-SDK-1270 Merge d6c4f9a7c into 697fed100 Pull #1560 web-flow github
85.02
29286858136 worktree-SDK-1270 Merge f3e7fc35c into 697fed100 Pull #1560 web-flow github
87.39
29286384847 worktree-SDK-1270 Merge 7846be11d into 697fed100 Pull #1560 web-flow github
87.39
29284004526 worktree-SDK-1270 Merge 36a253af6 into 697fed100 Pull #1560 web-flow github
87.34
29283234107 worktree-SDK-1270 Merge e60f5f9dd into 697fed100 Pull #1560 web-flow github
87.53
29272455154 worktree-SDK-1270 Merge e77276c69 into 697fed100 Pull #1560 web-flow github
87.39
29271555465 worktree-SDK-1270 Merge 1150bf70b into 697fed100 Pull #1560 web-flow github
87.39
29256853434 lukasklingsbo/sdk-1309-iceberg-catalog Merge 8aacf0f56 into 7455d34fd Pull #1591 web-flow github
85.45
29259685204 lukasklingsbo/sdk-1310-featfunctions-request-cancellation-for-invoke-flutter-sdk Merge fae14e8be into 697fed100 Pull #1593 web-flow github
82.92
See All Builds (1092)

Badge your Repo: supabase-flutter

We detected this repo isn’t badged! Grab the embed code to the right, add it to your repo to show off your code coverage, and when the badge is live hit the refresh button to remove this message.
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

Refresh