musicfs E2E Tests

Full distributed-path tests: server in Incus VM, local FUSE client, tests run against the mountpoint.

Prerequisites

Inside devenv shell (provides ffmpeg, metaflac, id3v2, incus, grpcurl, Postgres)
Postgres running (devenv up postgres)
Incus installed and configured

Run

just e2e              # full suite (creates VM, runs tests, destroys VM)
KEEP=1 just e2e       # keep VM + DB alive after run for debugging
just e2e-resilience   # resilience suite (server stop/start, network partition, outage recovery)

What it tests

Functional suite (`just e2e`)

Phase	Description
structural	Virtual directory tree matches fixture tags
cache	First read = cache miss, second read = cache hit
FLAC read	metaflac reads tags through FUSE reassembly
FLAC write	metaflac writes vorbis comment, write handler persists
MP3 read	id3v2 reads ID3v2 tags through FUSE reassembly
MP3 write	id3v2 writes tags, write handler persists
chunked write	Non-metadata writes don't corrupt tag structure
persistence	Tags survive client restart (DB restore path)

Resilience suite (`just e2e-resilience`)

Scenario	Disruption	What it verifies
server stop/start	`systemctl stop/start` in VM	EIO on uncached reads, cached reads survive, watcher resubscribes within 10s
network partition	`incus pause/start` (silent drop)	EIO within 10s (tonic 3s timeout × kernel readahead), watcher detects via HTTP/2 keepalive within 30s
cache resilience	server stop, all files pre-cached	All reads/writes from cache, no server contact needed
long outage	`incus pause` for 15s+	Watcher detects via keepalive PING, resubscribes within 10s of recovery

Fixtures

make-fixtures.sh generates a deterministic library under target/e2e/music/:

E2E Artist A/E2E Album X/01 - Alpha.flac  (with cover art)
E2E Artist A/E2E Album X/02 - Beta.flac
E2E Artist B/E2E Album Y/01 - Gamma.mp3   (with cover art)
E2E Artist B/E2E Album Y/02 - Delta.mp3

All tags are known at test time → exact assertions.

Profiles

just up e2e    # start client against e2e VM (manual testing)

Client uses musicfs_e2e database and ./logs/e2e for logs.

2.7 KiB Raw Blame History Unescape Escape