feat: add client compatibility endpoints and a smoke test script
- getMusicDirectory for folder/album browsing - server-side play queues with savePlayQueue/getPlayQueue and index variants - jukebox status and internet radio compatibility responses - scripts/smoke.sh generates a tagged MP3 library, runs the server and verifies all endpoints clients use, including Range, download and covers
This commit is contained in:
1 parent
46266d8071
commit
4d313a2846
9 files changed
+474
No files matched your search
@@ -592,6 +592,10 @@ For every `/rest/*` call (except an optional health check):
|
||||
- `createPlaylist(playlistId, name, songId)`: owner is the caller.
|
||||
- `updatePlaylist(playlistId, name, comment, public, songIdToAdd, songIndexToRemove)`: owner only; indices are applied in order.
|
||||
- `deletePlaylist(playlistId)`: owner only.
|
||||
- `getMusicDirectory(id)`: folder IDs return their albums as directories; album IDs return their songs. Used by folder-browsing clients.
|
||||
- `savePlayQueue` / `getPlayQueue` (and the `*ByIndex` variants): per-user queue kept in memory.
|
||||
- `jukeboxControl(action=status)` returns a stopped status; other jukebox actions report that jukebox is unsupported.
|
||||
- `getInternetRadioStations` returns an empty list; radio mutation endpoints report that radio is unsupported.
|
||||
|
||||
No `createUser` / `updateUser` / `deleteUser` endpoints: config/Vault is the source of truth.
|
||||
|
||||
@@ -660,8 +664,21 @@ The server fails its readiness probe if a configured root path is missing or unr
|
||||
- `search3` with Unicode and wildcards
|
||||
- scrobble/star/rating/bookmark isolation between users
|
||||
- playlist ownership and public visibility
|
||||
- music directory browsing and server-side play queues
|
||||
- transcoding: `maxBitRate` produces MP3, `timeOffset` seeks (skipped when `ffmpeg` is unavailable)
|
||||
|
||||
### Compatibility smoke test
|
||||
|
||||
`scripts/smoke.sh` generates a tagged MP3 with ffmpeg, starts the real server against a temporary library, and checks every endpoint a Subsonic client uses (browsing, feeds, search, stars, ratings, bookmarks, playlists, queues, stream with Range, download and covers). It prints PASS/FAIL per endpoint and exits non-zero on the first failure summary:
|
||||
|
||||
```bash
|
||||
nix-shell --run scripts/smoke.sh
|
||||
# or, with ffmpeg/sqlite/curl installed:
|
||||
scripts/smoke.sh
|
||||
```
|
||||
|
||||
The work directory can be passed as the first argument; the server log is kept there for debugging.
|
||||
|
||||
---
|
||||
|
||||
## 11. Implementation Order
|
||||
|
||||
Reference in new issue
Block a user