biggy
facd5c5b5e
Layout: - scripts/ holds the four build scripts plus the new clean.sh - cmake/ holds mingw64-toolchain.cmake - the scripts default to build/linux, build/macos, build/windows, build/harness - docs/ holds the audit documents, with the round 1 task list archived Cleanup: - scripts/clean.sh removes generated output, with --dry-run, --staging, --legacy and --all, and refuses tracked, protected or outside paths - the Windows VST3 manifest now comes from cmake/moduleinfo.json.in, so its version, vendor and class IDs follow cmake/Plugin.cmake instead of a hand-written heredoc that could drift - deleted the unused Source/GUI/Slider, which no code constructed - fixed the hidden double processBlock overload: three warning lines to zero - unslopped the build scripts, the two .cjs helpers and the CMake comments - .gitignore covers the upstream JUCE Projucer and DemoRunner binaries Verified: five scripts pass bash -n; the harness passes CTest with zero warning lines; the Linux VST3 and Standalone link; the Windows cross-build passes its x86-64, runtime-import and entry-point checks; each configure exposes only its own targets; and a full build leaves Source/ and third_party/JUCE unchanged. The generated manifest is identical to the previous hand-written one.
41 lines
1.4 KiB
Markdown
41 lines
1.4 KiB
Markdown
# tests module
|
|
|
|
## Owned files
|
|
|
|
- TestMain.cpp
|
|
|
|
## Rules
|
|
|
|
- Keep this a headless console harness that drives the real SerumAltAudioProcessor.
|
|
- Check rendered blocks for NaN and inf. Check non-silence over the full preset render, not each block, because note release can legitimately produce silent blocks.
|
|
- Print PASS or FAIL per preset to `std::cout`.
|
|
- Return a non-zero exit code when any check fails.
|
|
- Never show a JUCE alert window.
|
|
- Do not add GUI interaction beyond `juce::ScopedJuceInitialiser_GUI`.
|
|
|
|
## IF-THEN
|
|
|
|
- IF a check fails THEN increment the failure count and print the preset name.
|
|
- Build and run natively from the repository root with `./scripts/build_harness.sh --run`. Building the `SerumAltTest` target alone does not run checks.
|
|
- The harness-only configuration sets `SERUMALT_BUILD_PLUGIN=OFF` and `SERUMALT_BUILD_TESTS=ON`. Production scripts disable the harness.
|
|
- The harness links the real processor and editor sources but creates no plugin bundles. Keep that build separation when adding checks.
|
|
|
|
## Examples
|
|
|
|
```cpp
|
|
// BAD: a failing check does not fail the run
|
|
bool ok = ! hasNaN (buffer) && peak (buffer) > 0.001f; // result ignored
|
|
return 0;
|
|
```
|
|
|
|
```cpp
|
|
// GOOD: accumulate failures and exit non-zero
|
|
int failures = 0;
|
|
const bool ok = ! hasNaN (buffer) && peak (buffer) > 0.001f;
|
|
if (! ok) ++failures;
|
|
...
|
|
return failures == 0 ? 0 : 1;
|
|
```
|
|
|
|
This file overrides /AGENTS.md where they conflict.
|