supabase / supabase-flutter / 32470384127
89%

DEFAULT BRANCH: main
Ran
Jobs 10
Files 120
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
coverage: 88.564% (+0.02%) from 88.549%
32470384127

push

github

web-flow 
feat: introduce the supabase_testing package (#1747)

Follow-up to #1745, which consolidated the test helpers of all the
client suites into `supabase_common`'s testing library. This PR breaks
those helpers out into a new published `supabase_testing` package aimed
at consumers, keeps `supabase_common` a purely internal package, and
adds the helpers and documentation that make testing an app against
Supabase easy.

## The package split

- `packages/supabase_testing` is a new published package holding the
customer-facing helpers: the mock HTTP clients, JWT builders, auth
fixtures and realtime frame builders from #1745. All nine client package
suites now consume them from there as a dev dependency.
- `supabase_common` goes back to its internal branding (README, pubspec
description and topics). Its `testing.dart` shrinks back to the
repo-internal local stack configuration, which is tied to this
repository's `supabase/config.toml` and is not useful to consumers.
- `supabase_testing` is excluded from the capability-matrix scan, since
test helpers are not SDK client surface.

## New helpers

Built on top of the moved primitives, verified by their own test suite:

- **`MockSupabaseHttpClient`**: answers requests from stubs registered
per endpoint, with shorthands for the service layouts so tests never
spell out URL paths: `stubTable` (`/rest/v1/<table>`), `stubRpc`,
`stubEdgeFunction` and `stubSignIn` (a working token endpoint). The
latest matching stub wins, `times` limits how often a stub answers so
call sequences can be modeled, and an unmatched request throws a
`StateError` naming the request and the registered stubs. Every answered
request is recorded with its body already read (`request.jsonBody`), so
tests can assert on what the code under test sent.
- **`testSupabaseClient`**: a `SupabaseClient` wired for tests, removing
the footguns of constructing one by hand: in-memory pkce storage, token
auto refresh off so no timer outlives the test, and an unsign... (continued)

5901 of 6663 relevant lines covered (88.56%)

4.36 hits per line

Coverage Regressions

Lines Coverage ∆ File
63
69.48
 -0.24% packages/iceberg/lib/src/iceberg_types.dart
2
98.74
 0.0% packages/supabase_storage/lib/src/types.dart
Jobs
ID Job ID Ran Files Coverage
1 supabase_realtime - 32470384127.1 13
90.27
 GitHub Action Run
2 supabase - 32470384127.2 14
93.56
 GitHub Action Run
3 yet_another_json_isolate - 32470384127.3 1
98.41
 GitHub Action Run
4 supabase_flutter - 32470384127.4 11
81.82
 GitHub Action Run
5 iceberg - 32470384127.5 6
68.52
 GitHub Action Run
6 supabase_functions - 32470384127.6 4
97.83
 GitHub Action Run
7 supabase_common - 32470384127.7 21
86.96
 GitHub Action Run
8 postgrest - 32470384127.8 11
84.48
 GitHub Action Run
9 supabase_storage - 32470384127.9 9
97.31
 GitHub Action Run
10 supabase_auth - 32470384127.10 30
90.67
 GitHub Action Run
Source Files on build 32470384127