Quota reporting: storage.Usager + GET /api/v1/quota (v0.3) #8

Merged

Cordy merged 7 commits from feat/quota-reporting into main

2026-07-21 18:25:40 +00:00

Cordy commented

2026-07-21 18:24:18 +00:00

Owner

First v0.3 increment: storage-capacity reporting.

storage.Usager optional capability (Usage(ctx) (Usage, error)) + storage.Usage{Used,Free,Total} + ErrUnsupported.
POSIX driver implements it via statfs(2), build-tagged (usage_unix.go / usage_other.go) so non-unix builds fall back to ErrUnsupported.
GET /api/v1/quota — feature-detected: backends without Usager (S3 has no bucket-wide capacity notion) return 501.
Tests: POSIX Usage against a real tmpdir; API 200 (with Usager) / 501 (without).

Additive and backward-compatible — no existing behaviour changes. Closes the first of the v0.3 "quotas" items; WebDAV RFC-4331 quota props (so Finder shows free space) are a planned follow-up.

First v0.3 increment: storage-capacity reporting. - `storage.Usager` optional capability (`Usage(ctx) (Usage, error)`) + `storage.Usage{Used,Free,Total}` + `ErrUnsupported`. - POSIX driver implements it via `statfs(2)`, build-tagged (`usage_unix.go` / `usage_other.go`) so non-unix builds fall back to `ErrUnsupported`. - `GET /api/v1/quota` — feature-detected: backends without `Usager` (S3 has no bucket-wide capacity notion) return 501. - Tests: POSIX `Usage` against a real tmpdir; API 200 (with Usager) / 501 (without). Additive and backward-compatible — no existing behaviour changes. Closes the first of the v0.3 "quotas" items; WebDAV RFC-4331 quota props (so Finder shows free space) are a planned follow-up.

Cordy added 7 commits

2026-07-21 18:24:19 +00:00