Add ExecutionContext class

Author: adazem009

CMakeLists.txt

@@ -67,6 +67,10 @@ target_sources(scratchcpp
 
 if (LIBSCRATCHCPP_USE_LLVM)
     target_compile_definitions(scratchcpp PUBLIC USE_LLVM)
+    target_sources(scratchcpp
+      PUBLIC
+        include/scratchcpp/dev/executioncontext.h
+    )
 
 else()
     target_sources(scratchcpp

include/scratchcpp/dev/executioncontext.h

@@ -0,0 +1,28 @@
+// SPDX-License-Identifier: Apache-2.0
+
+#pragma once
+
+#include "../global.h"
+#include "../spimpl.h"
+
+namespace libscratchcpp
+{
+
+class Target;
+class ExecutionContextPrivate;
+
+/*! \brief The ExecutionContext represents the execution context of a target (can be a clone) with variables, lists, etc. */
+class LIBSCRATCHCPP_EXPORT ExecutionContext
+{
+    public:
+        ExecutionContext(Target *target);
+        ExecutionContext(const ExecutionContext &) = delete;
+        virtual ~ExecutionContext() { }
+
+        Target *target() const;
+
+    private:
+        spimpl::unique_impl_ptr<ExecutionContextPrivate> impl;
+};
+
+} // namespace libscratchcpp

src/dev/CMakeLists.txt

@@ -1 +1,2 @@
 add_subdirectory(blocks)
+add_subdirectory(engine)

src/dev/engine/CMakeLists.txt

@@ -0,0 +1,6 @@
+target_sources(scratchcpp
+  PRIVATE
+    executioncontext.cpp
+    executioncontext_p.cpp
+    executioncontext_p.h
+)

src/dev/engine/executioncontext.cpp

@@ -0,0 +1,19 @@
+// SPDX-License-Identifier: Apache-2.0
+
+#include <scratchcpp/dev/executioncontext.h>
+
+#include "executioncontext_p.h"
+
+using namespace libscratchcpp;
+
+/*! Constructs ExecutionContext. */
+ExecutionContext::ExecutionContext(Target *target) :
+    impl(spimpl::make_unique_impl<ExecutionContextPrivate>(target))
+{
+}
+
+/*! Returns the Target of this context. */
+Target *ExecutionContext::target() const
+{
+    return impl->target;
+}

src/dev/engine/executioncontext_p.cpp

@@ -0,0 +1,10 @@
+// SPDX-License-Identifier: Apache-2.0
+
+#include "executioncontext_p.h"
+
+using namespace libscratchcpp;
+
+ExecutionContextPrivate::ExecutionContextPrivate(Target *target) :
+    target(target)
+{
+}

src/dev/engine/executioncontext_p.h

@@ -0,0 +1,17 @@
+// SPDX-License-Identifier: Apache-2.0
+
+#pragma once
+
+namespace libscratchcpp
+{
+
+class Target;
+
+struct ExecutionContextPrivate
+{
+        ExecutionContextPrivate(Target *target);
+
+        Target *target = nullptr;
+};
+
+} // namespace libscratchcpp

test/dev/CMakeLists.txt

@@ -1 +1,2 @@
 add_subdirectory(blocks)
+add_subdirectory(executioncontext)

test/dev/executioncontext/CMakeLists.txt

@@ -0,0 +1,12 @@
+add_executable(
+  executioncontext_test
+  executioncontext_test.cpp
+)
+
+target_link_libraries(
+  executioncontext_test
+  GTest::gtest_main
+  scratchcpp
+)
+
+gtest_discover_tests(executioncontext_test)

test/dev/executioncontext/executioncontext_test.cpp

@@ -0,0 +1,13 @@
+#include <scratchcpp/dev/executioncontext.h>
+#include <scratchcpp/target.h>
+
+#include "../../common.h"
+
+using namespace libscratchcpp;
+
+TEST(ExecutionContextTest, Constructor)
+{
+    Target target;
+    ExecutionContext ctx(&target);
+    ASSERT_EQ(ctx.target(), &target);
+}