Alexander
52 lines
1.7 KiB
Markdown
52 lines
1.7 KiB
Markdown
# 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
|
|
|
|
```sh
|
|
just e2e # full suite (creates VM, runs tests, destroys VM)
|
|
KEEP=1 just e2e # keep VM + DB alive after run for debugging
|
|
```
|
|
|
|
## What it tests
|
|
|
|
| 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) |
|
|
|
|
## 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
|
|
|
|
```sh
|
|
just up e2e # start client against e2e VM (manual testing)
|
|
```
|
|
|
|
Client uses `musicfs_e2e` database and `./logs/e2e` for logs.
|