Land src/core/package: the pure RSBK container — format ladder, JSON manifest, framing/layout codec
Two-integer ladder (formatVersion/minReaderVersion), bare-name-only entries validated on encode and decode, prefix decode that proves exact file size without ever reading a payload.
This commit is contained in:
@@ -0,0 +1,248 @@
|
||||
// Standalone tests for reasampler::package's manifest codec — no REAPER, no
|
||||
// test framework. The round-trip fixture exercises every manifest field and
|
||||
// every Sample optional in both present and absent states; the rejection suite
|
||||
// pins the entry-name rule on encode AND decode.
|
||||
|
||||
#include "../src/core/package/package_manifest.h"
|
||||
|
||||
#include <cstdio>
|
||||
#include <optional>
|
||||
#include <string>
|
||||
|
||||
using namespace reasampler::package;
|
||||
using namespace reasampler::model;
|
||||
|
||||
static int g_fail = 0;
|
||||
#define CHECK(cond) do { if(!(cond)) { \
|
||||
std::printf("FAIL line %d: %s\n", __LINE__, #cond); ++g_fail; } } while(0)
|
||||
|
||||
// --- fixtures ----------------------------------------------------------------
|
||||
|
||||
// Every Sample field populated, every optional PRESENT.
|
||||
static Sample fullSample() {
|
||||
Sample s;
|
||||
s.id = "smp-full";
|
||||
s.displayName = "Kick (wet)";
|
||||
s.relativePath = "reasampler_bank/kick.wav";
|
||||
s.sourceMode = SourceMode::RazorArea;
|
||||
s.sourceRange = {1.25, 3.5, 480.0, 1920.0};
|
||||
s.trackGuids = {"{AAA}", "{BBB}"};
|
||||
s.wetDry = 0.75;
|
||||
s.channelCount = 2;
|
||||
s.sampleRate = 48000;
|
||||
s.lengthSeconds = 2.25;
|
||||
s.lengthBeats = 4.5;
|
||||
s.captureTempo = 120.5;
|
||||
s.captureTimeSigNum = 7;
|
||||
s.captureTimeSigDenom = 8;
|
||||
s.key = "F#m";
|
||||
s.rootNote = 60;
|
||||
s.loop = LoopPoints{100, 4800};
|
||||
s.levels = {-0.3, -12.7, -14.0};
|
||||
s.clipped = true;
|
||||
s.tier = Tier::Archive;
|
||||
s.contentHash = "W0123456789abcdef";
|
||||
s.provenance = Provenance{"smp-parent", "fx-snapshot"};
|
||||
s.createdTimestamp = 1754000000;
|
||||
return s;
|
||||
}
|
||||
|
||||
// Every Sample optional ABSENT (key, rootNote, loop, provenance).
|
||||
static Sample bareSample() {
|
||||
Sample s;
|
||||
s.id = "smp-bare";
|
||||
s.displayName = "Snare";
|
||||
s.relativePath = "reasampler_bank/snare.wav";
|
||||
s.sourceMode = SourceMode::Realtime;
|
||||
s.contentHash = "Wfedcba9876543210";
|
||||
s.createdTimestamp = 1754000001;
|
||||
return s;
|
||||
}
|
||||
|
||||
static PackageManifest fixture() {
|
||||
PackageManifest m;
|
||||
m.bankDisplayName = "Drums \"live\""; // escaping exercised
|
||||
m.exportTimestamp = 1754100000;
|
||||
m.entries.push_back({"kick.wav", 96000, "1111222233334444", fullSample()});
|
||||
m.entries.push_back({"snare.wav", 0, "5555666677778888", bareSample()}); // 0-length legal
|
||||
m.slots.append("smp-full");
|
||||
m.slots.append("smp-bare");
|
||||
m.slots.remove("smp-full"); // leaves a gap: slots round-trip must keep it
|
||||
return m;
|
||||
}
|
||||
|
||||
// --- round trip --------------------------------------------------------------
|
||||
|
||||
static void testRoundTripEveryField() {
|
||||
const PackageManifest m = fixture();
|
||||
auto json = serializeManifest(m);
|
||||
CHECK(json.has_value());
|
||||
auto back = deserializeManifest(*json);
|
||||
CHECK(back.has_value());
|
||||
CHECK(*back == m);
|
||||
// Spot-check both optional states survived (== above proves it; these name
|
||||
// the claim so a failure reads directly).
|
||||
CHECK(back->entries[0].sample.loop.has_value());
|
||||
CHECK(back->entries[0].sample.provenance.has_value());
|
||||
CHECK(!back->entries[1].sample.key.has_value());
|
||||
CHECK(!back->entries[1].sample.rootNote.has_value());
|
||||
CHECK(back->slots.idAt(0).empty()); // the slot gap survived
|
||||
CHECK(back->slots.slotOf("smp-bare") == 1);
|
||||
}
|
||||
|
||||
static void testEmptyManifestRoundTrips() {
|
||||
PackageManifest m;
|
||||
auto json = serializeManifest(m);
|
||||
CHECK(json.has_value());
|
||||
auto back = deserializeManifest(*json);
|
||||
CHECK(back.has_value());
|
||||
CHECK(*back == m);
|
||||
}
|
||||
|
||||
// --- forward compatibility ---------------------------------------------------
|
||||
|
||||
static void testUnknownKeysSkippedAtEveryLevel() {
|
||||
// A future additive manifest: unknown keys at the root and inside an entry.
|
||||
const std::string json =
|
||||
"{\"bankName\":\"B\",\"exported\":7,"
|
||||
"\"instrumentState\":{\"nested\":[1,2,{\"x\":\"y\"}]},"
|
||||
"\"entries\":[{\"name\":\"a.wav\",\"length\":10,\"hash\":\"h\","
|
||||
"\"futureField\":\"ignored\","
|
||||
"\"index\":{\"version\":1,\"samples\":[{\"id\":\"s1\","
|
||||
"\"relativePath\":\"bank/a.wav\"}]}}],"
|
||||
"\"slots\":[],\"trailingUnknown\":null}";
|
||||
auto m = deserializeManifest(json);
|
||||
CHECK(m.has_value());
|
||||
CHECK(m->bankDisplayName == "B");
|
||||
CHECK(m->exportTimestamp == 7);
|
||||
CHECK(m->entries.size() == 1);
|
||||
CHECK(m->entries[0].fileName == "a.wav");
|
||||
CHECK(m->entries[0].byteLength == 10);
|
||||
CHECK(m->entries[0].sample.id == "s1");
|
||||
}
|
||||
|
||||
// --- rejection: entry names, both directions ---------------------------------
|
||||
|
||||
static void testEncodeRejectsBadEntryName() {
|
||||
for (const char* bad : {"..\\evil.wav", "../evil.wav", "dir/a.wav", "C:\\a.wav", "", ".."}) {
|
||||
PackageManifest m = fixture();
|
||||
m.entries[0].fileName = bad;
|
||||
CHECK(!serializeManifest(m).has_value());
|
||||
}
|
||||
}
|
||||
|
||||
static void testDecodeRejectsBadEntryName() {
|
||||
for (const char* bad : {"..\\\\evil.wav", "../evil.wav", "dir/a.wav", "C:\\\\a.wav", ".."}) {
|
||||
// Hand-rolled JSON: a hostile package is not limited to what encode emits.
|
||||
std::string json =
|
||||
std::string("{\"entries\":[{\"name\":\"") + bad +
|
||||
"\",\"length\":1,\"hash\":\"h\","
|
||||
"\"index\":{\"version\":1,\"samples\":[{\"id\":\"s1\","
|
||||
"\"relativePath\":\"bank/a.wav\"}]}}]}";
|
||||
CHECK(!deserializeManifest(json).has_value());
|
||||
}
|
||||
}
|
||||
|
||||
static void testDuplicateEntryNamesRejectedBothWays() {
|
||||
PackageManifest m = fixture();
|
||||
m.entries[1].fileName = m.entries[0].fileName;
|
||||
CHECK(!serializeManifest(m).has_value());
|
||||
|
||||
// Decode side, from a hand-built duplicate (a hostile package is not
|
||||
// limited to what encode emits).
|
||||
const std::string dup =
|
||||
"{\"entries\":["
|
||||
"{\"name\":\"a.wav\",\"length\":1,\"hash\":\"h\","
|
||||
"\"index\":{\"version\":1,\"samples\":[{\"id\":\"s1\",\"relativePath\":\"p\"}]}},"
|
||||
"{\"name\":\"a.wav\",\"length\":2,\"hash\":\"i\","
|
||||
"\"index\":{\"version\":1,\"samples\":[{\"id\":\"s2\",\"relativePath\":\"q\"}]}}]}";
|
||||
CHECK(!deserializeManifest(dup).has_value());
|
||||
}
|
||||
|
||||
// --- rejection: structural ---------------------------------------------------
|
||||
|
||||
static void testEncodeRejectsUnrepresentableSample() {
|
||||
PackageManifest m = fixture();
|
||||
m.entries[0].sample.id.clear(); // BankModel::add rejects an empty id
|
||||
CHECK(!serializeManifest(m).has_value());
|
||||
|
||||
PackageManifest m2 = fixture();
|
||||
m2.entries[0].sample.relativePath = "C:/abs/kick.wav"; // and an absolute path
|
||||
CHECK(!serializeManifest(m2).has_value());
|
||||
}
|
||||
|
||||
static void testDecodeRejectsMalformedShapes() {
|
||||
CHECK(!deserializeManifest("").has_value());
|
||||
CHECK(!deserializeManifest("not json").has_value());
|
||||
CHECK(!deserializeManifest("[]").has_value());
|
||||
CHECK(!deserializeManifest("{\"entries\":[{}]}").has_value()); // entry missing fields
|
||||
// Missing one required entry field apiece.
|
||||
CHECK(!deserializeManifest(
|
||||
"{\"entries\":[{\"length\":1,\"hash\":\"h\","
|
||||
"\"index\":{\"version\":1,\"samples\":[{\"id\":\"s\",\"relativePath\":\"p\"}]}}]}")
|
||||
.has_value());
|
||||
CHECK(!deserializeManifest(
|
||||
"{\"entries\":[{\"name\":\"a.wav\",\"hash\":\"h\","
|
||||
"\"index\":{\"version\":1,\"samples\":[{\"id\":\"s\",\"relativePath\":\"p\"}]}}]}")
|
||||
.has_value());
|
||||
CHECK(!deserializeManifest(
|
||||
"{\"entries\":[{\"name\":\"a.wav\",\"length\":1,"
|
||||
"\"index\":{\"version\":1,\"samples\":[{\"id\":\"s\",\"relativePath\":\"p\"}]}}]}")
|
||||
.has_value());
|
||||
CHECK(!deserializeManifest(
|
||||
"{\"entries\":[{\"name\":\"a.wav\",\"length\":1,\"hash\":\"h\"}]}").has_value());
|
||||
// Negative length.
|
||||
CHECK(!deserializeManifest(
|
||||
"{\"entries\":[{\"name\":\"a.wav\",\"length\":-1,\"hash\":\"h\","
|
||||
"\"index\":{\"version\":1,\"samples\":[{\"id\":\"s\",\"relativePath\":\"p\"}]}}]}")
|
||||
.has_value());
|
||||
// A nested index that is not exactly one sample (zero and two).
|
||||
CHECK(!deserializeManifest(
|
||||
"{\"entries\":[{\"name\":\"a.wav\",\"length\":1,\"hash\":\"h\","
|
||||
"\"index\":{\"version\":1,\"samples\":[]}}]}").has_value());
|
||||
CHECK(!deserializeManifest(
|
||||
"{\"entries\":[{\"name\":\"a.wav\",\"length\":1,\"hash\":\"h\","
|
||||
"\"index\":{\"version\":1,\"samples\":[{\"id\":\"s1\",\"relativePath\":\"p\"},"
|
||||
"{\"id\":\"s2\",\"relativePath\":\"q\"}]}}]}").has_value());
|
||||
// A nested sample BankModel::add drops (absolute path) fails the entry —
|
||||
// the silent drop must not half-parse into an empty index.
|
||||
CHECK(!deserializeManifest(
|
||||
"{\"entries\":[{\"name\":\"a.wav\",\"length\":1,\"hash\":\"h\","
|
||||
"\"index\":{\"version\":1,\"samples\":[{\"id\":\"s\","
|
||||
"\"relativePath\":\"C:/abs.wav\"}]}}]}").has_value());
|
||||
// An out-of-range enum inside the nested Sample blob fails the entry: the
|
||||
// manifest defines no enum of its own, and bank_model's codec REJECTS an
|
||||
// unknown sourceMode/tier rather than degrading — so growing one of those
|
||||
// vocabularies is a minReaderVersion bump, not an additive change (see this
|
||||
// directory's CLAUDE.md).
|
||||
CHECK(!deserializeManifest(
|
||||
"{\"entries\":[{\"name\":\"a.wav\",\"length\":1,\"hash\":\"h\","
|
||||
"\"index\":{\"version\":1,\"samples\":[{\"id\":\"s\",\"relativePath\":\"p\","
|
||||
"\"sourceMode\":99}]}}]}").has_value());
|
||||
// Trailing garbage after the root object.
|
||||
auto json = serializeManifest(fixture());
|
||||
CHECK(json.has_value());
|
||||
CHECK(!deserializeManifest(*json + "x").has_value());
|
||||
// Truncation at a few JSON-level offsets (byte-level truncation of the whole
|
||||
// package is bank_package's suite).
|
||||
CHECK(!deserializeManifest(json->substr(0, json->size() / 2)).has_value());
|
||||
CHECK(!deserializeManifest(json->substr(0, 1)).has_value());
|
||||
}
|
||||
|
||||
int main() {
|
||||
testRoundTripEveryField();
|
||||
testEmptyManifestRoundTrips();
|
||||
testUnknownKeysSkippedAtEveryLevel();
|
||||
testEncodeRejectsBadEntryName();
|
||||
testDecodeRejectsBadEntryName();
|
||||
testDuplicateEntryNamesRejectedBothWays();
|
||||
testEncodeRejectsUnrepresentableSample();
|
||||
testDecodeRejectsMalformedShapes();
|
||||
|
||||
if (g_fail == 0) {
|
||||
std::printf("package_manifest_tests: all passed\n");
|
||||
return 0;
|
||||
}
|
||||
std::printf("package_manifest_tests: %d failure(s)\n", g_fail);
|
||||
return 1;
|
||||
}
|
||||
Reference in New Issue
Block a user