Function main

tests/main.cpp:123–148

 */

int main(int argc, char* argv[]) {

    // prepare QuEST before anything else, since many
    // testing utility functions repurpose QuEST ones
    initQuESTEnv();
    setInputErrorHandler(validationErrorHandler);

    // ensure RNG consensus among all nodes
    setRandomTestStateSeeds();

    // prepare persistent Quregs
    createCachedQuregs();
    createCachedFullStateDiagMatrs();

    // disable Catch2 output on non-root nodes
    if (getQuESTEnv().rank != 0)
        std::cout.rdbuf(nullptr);

    // launch Catch2, triggering above event listener
    int result = Catch::Session().run( argc, argv );

    destroyCachedFullStateDiagMatrs();
    destroyCachedQuregs();
    finalizeQuESTEnv();
    return result;
}