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

supabase / supabase-py / 42007041034
98%

Build:
DEFAULT BRANCH: main
Ran 05 Nov 2026 10:00AM UTC
Jobs 42
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

05 Nov 2026 10:00AM UTC coverage: 95.446% (-0.01%) from 95.456%
42007041034

push

github

web-flow
fix(storage)!: treat object keys as literal strings (#1987)

Fixes #1984 on `main`. The `v2` fix is #1986, with the follow-up #1988.

## Problem

`relative_path_to_parts()` parsed every object key with `yarl.URL`. A
key is not a URL, so parts of it were read as URL syntax and dropped:

| Key                              | Sent as         |
| -------------------------------- | --------------- |
| `backup-2024-01-01T10:00:00.sql` | `00:00.sql`     |
| `user:42/avatar.png`             | `42/avatar.png` |
| `what?.txt`                      | `what`          |
| `report#1.pdf`                   | `report`        |
| `//folder/file.png`              | `file.png`      |

Every method that takes a path used the wrong key, so different keys
could overwrite each other and downloads could return another object's
bytes.

## Fix

An object key is now treated as a literal string. It is split on `/`
after stripping leading slashes, and `joinpath()` encodes each part when
the request URL is built. `:` is kept, and `?`, `#` and `%` are sent as
`%3F`, `%23` and `%25`.

A key with a `.` or `..` segment raises `ValueError`. Dot segments are
removed while a URL path is built or sent: by `joinpath()`, by httpx,
and by the WHATWG URL parser that storage-js uses. So
`folder?/../report.txt` would target `report.txt`, and `../../auth`
would leave the storage path entirely. Such keys cannot be addressed
reliably over HTTP, so they are rejected instead of being sent to a
different key.

## Breaking change

Keys are no longer percent-decoded. A pre-encoded key such as
`a%20b.png` used to be sent as `a b.png`. It is now sent as the literal
`a%20b.png`, which Storage should reject because `%` is not a valid key
character. Pass the decoded key, `a b.png`, instead.

A full URL passed as a key, such as `https://host/a/b`, is no longer
reduced to `a/b`.

## Tests

`tests/test_file_api.py` checks the request path sent by `upload()` for
both clients and the URL returned by `get_public_ur... (continued)

9600 of 10058 relevant lines covered (95.45%)

5.82 hits per line

Coverage Regressions

Lines Coverage ∆ File
2
98.36
-1.64% tests/test_file_api.py
Jobs
ID Job ID Ran Files Coverage
1 auth-py3.11-lowest-direct - 42007041034.1 05 Nov 2026 10:01AM UTC 36
91.55
GitHub Action Run
2 functions-py3.14-highest - 42007041034.2 05 Nov 2026 10:00AM UTC 15
97.61
GitHub Action Run
3 utils-py3.13-highest - 42007041034.3 05 Nov 2026 10:00AM UTC 19
99.51
GitHub Action Run
4 storage-py3.13-highest - 42007041034.4 05 Nov 2026 10:01AM UTC 22
93.67
GitHub Action Run
5 utils-py3.15-highest - 42007041034.5 05 Nov 2026 10:00AM UTC 19
99.5
GitHub Action Run
6 realtime-py3.13-highest - 42007041034.6 05 Nov 2026 10:02AM UTC 8
95.73
GitHub Action Run
7 utils-py3.14-highest - 42007041034.7 05 Nov 2026 10:00AM UTC 19
99.5
GitHub Action Run
8 postgrest-py3.14-highest - 42007041034.8 05 Nov 2026 10:02AM UTC 25
97.89
GitHub Action Run
9 functions-py3.11-lowest-direct - 42007041034.9 05 Nov 2026 10:00AM UTC 15
97.61
GitHub Action Run
10 auth-py3.11-highest - 42007041034.10 05 Nov 2026 10:01AM UTC 36
91.55
GitHub Action Run
11 supabase-py3.11-lowest-direct - 42007041034.11 05 Nov 2026 10:00AM UTC 22
97.77
GitHub Action Run
12 functions-py3.13-highest - 42007041034.12 05 Nov 2026 10:00AM UTC 15
97.61
GitHub Action Run
13 utils-py3.11-lowest-direct - 42007041034.13 05 Nov 2026 10:00AM UTC 19
99.51
GitHub Action Run
14 supabase-py3.11-highest - 42007041034.14 05 Nov 2026 10:00AM UTC 22
97.77
GitHub Action Run
15 auth-py3.13-highest - 42007041034.15 05 Nov 2026 10:01AM UTC 36
91.55
GitHub Action Run
16 supabase-py3.13-highest - 42007041034.16 05 Nov 2026 10:00AM UTC 22
97.77
GitHub Action Run
17 postgrest-py3.15-highest - 42007041034.17 05 Nov 2026 10:02AM UTC 25
97.89
GitHub Action Run
18 functions-py3.12-highest - 42007041034.18 05 Nov 2026 10:00AM UTC 15
97.61
GitHub Action Run
19 supabase-py3.15-highest - 42007041034.19 05 Nov 2026 10:01AM UTC 22
97.76
GitHub Action Run
20 storage-py3.11-lowest-direct - 42007041034.20 05 Nov 2026 10:02AM UTC 22
93.67
GitHub Action Run
21 functions-py3.15-highest - 42007041034.21 05 Nov 2026 10:00AM UTC 15
97.61
GitHub Action Run
22 utils-py3.11-highest - 42007041034.22 05 Nov 2026 10:00AM UTC 19
99.51
GitHub Action Run
23 storage-py3.14-highest - 42007041034.23 05 Nov 2026 10:01AM UTC 22
93.65
GitHub Action Run
24 supabase-py3.14-highest - 42007041034.24 05 Nov 2026 10:00AM UTC 22
97.76
GitHub Action Run
25 auth-py3.12-highest - 42007041034.25 05 Nov 2026 10:01AM UTC 36
91.55
GitHub Action Run
26 functions-py3.11-highest - 42007041034.26 05 Nov 2026 10:00AM UTC 15
97.61
GitHub Action Run
27 auth-py3.15-highest - 42007041034.27 05 Nov 2026 10:01AM UTC 36
91.52
GitHub Action Run
28 utils-py3.12-highest - 42007041034.28 05 Nov 2026 10:00AM UTC 19
99.51
GitHub Action Run
29 auth-py3.14-highest - 42007041034.29 05 Nov 2026 10:01AM UTC 36
91.52
GitHub Action Run
30 supabase-py3.12-highest - 42007041034.30 05 Nov 2026 10:00AM UTC 22
97.77
GitHub Action Run
31 realtime-py3.11-highest - 42007041034.31 05 Nov 2026 10:02AM UTC 8
96.04
GitHub Action Run
32 postgrest-py3.11-highest - 42007041034.32 05 Nov 2026 10:02AM UTC 25
97.89
GitHub Action Run
33 realtime-py3.15-highest - 42007041034.33 05 Nov 2026 10:01AM UTC 8
95.17
GitHub Action Run
34 storage-py3.12-highest - 42007041034.34 05 Nov 2026 10:01AM UTC 22
93.67
GitHub Action Run
35 realtime-py3.11-lowest-direct - 42007041034.35 05 Nov 2026 10:01AM UTC 8
96.04
GitHub Action Run
36 postgrest-py3.11-lowest-direct - 42007041034.36 05 Nov 2026 10:02AM UTC 25
97.89
GitHub Action Run
37 realtime-py3.12-highest - 42007041034.37 05 Nov 2026 10:02AM UTC 8
95.88
GitHub Action Run
38 storage-py3.15-highest - 42007041034.38 05 Nov 2026 10:03AM UTC 22
93.65
GitHub Action Run
39 postgrest-py3.12-highest - 42007041034.39 05 Nov 2026 10:02AM UTC 25
97.89
GitHub Action Run
40 realtime-py3.14-highest - 42007041034.40 05 Nov 2026 10:01AM UTC 8
95.17
GitHub Action Run
41 storage-py3.11-highest - 42007041034.41 05 Nov 2026 10:02AM UTC 22
93.67
GitHub Action Run
42 postgrest-py3.13-highest - 42007041034.42 05 Nov 2026 10:02AM UTC 25
97.89
GitHub Action Run
Source Files on build 42007041034
  • Tree
  • List 123
  • Changed 2
  • Source Changed 0
  • Coverage Changed 2
Coverage ∆ File Lines Relevant Covered Missed Hits/Line
  • Back to Repo
  • Github Actions Build #42007041034
  • b54cba4f on github
  • Prev Build on main (#42005876479)
  • Next Build on main (#42026831817)
  • 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