Basic execution context framework (#1004)

Fixes #1187

unittests/util/async/AnyStopTokenTests.cpp

@@ -0,0 +1,59 @@
+//------------------------------------------------------------------------------
+/*
+    This file is part of clio: https://github.com/XRPLF/clio
+    Copyright (c) 2024, the clio developers.
+
+    Permission to use, copy, modify, and distribute this software for any
+    purpose with or without fee is hereby granted, provided that the above
+    copyright notice and this permission notice appear in all copies.
+
+    THE  SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+    WITH  REGARD  TO  THIS  SOFTWARE  INCLUDING  ALL  IMPLIED  WARRANTIES  OF
+    MERCHANTABILITY  AND  FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+    ANY  SPECIAL,  DIRECT,  INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+    WHATSOEVER  RESULTING  FROM  LOSS  OF USE, DATA OR PROFITS, WHETHER IN AN
+    ACTION  OF  CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+    OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+*/
+//==============================================================================
+
+#include "util/async/AnyStopToken.hpp"
+
+#include <gtest/gtest.h>
+
+using namespace util::async;
+using namespace ::testing;
+
+namespace {
+struct FakeStopToken {
+    bool isStopRequested_ = false;
+    bool
+    isStopRequested() const
+    {
+        return isStopRequested_;
+    }
+};
+}  // namespace
+
+struct AnyStopTokenTests : public TestWithParam<bool> {};
+
+INSTANTIATE_TEST_CASE_P(AnyStopTokenGroup, AnyStopTokenTests, ValuesIn({true, false}), [](auto const& info) {
+    return info.param ? "true" : "false";
+});
+
+TEST_P(AnyStopTokenTests, CanCopy)
+{
+    AnyStopToken stopToken{FakeStopToken{GetParam()}};
+    AnyStopToken token = stopToken;
+
+    EXPECT_EQ(token, stopToken);
+}
+
+TEST_P(AnyStopTokenTests, IsStopRequestedCallPropagated)
+{
+    auto const flag = GetParam();
+    AnyStopToken stopToken{FakeStopToken{flag}};
+
+    EXPECT_EQ(stopToken.isStopRequested(), flag);
+    EXPECT_EQ(stopToken, flag);
+}