WIP feat: Implement initial C++ library

Author: seffradev

CMakeLists.txt

@@ -10,6 +10,7 @@ include(CTest)
 
 add_subdirectory(testcontainers-bridge)
 add_subdirectory(testcontainers-c)
+add_subdirectory(testcontainers-cpp)
 add_subdirectory(modules)
 if(NOT DEFINED SKIP_DEMOS)
     add_subdirectory(demo)

demo/CMakeLists.txt

@@ -2,3 +2,4 @@
 add_subdirectory(generic-container)
 add_subdirectory(wiremock)
 add_subdirectory(google-test)
+add_subdirectory(google-test-cpp)

demo/google-test-cpp/CMakeLists.txt

@@ -0,0 +1,32 @@
+# Google Test demo
+# This is based on https://google.github.io/googletest/quickstart-cmake.html
+cmake_minimum_required (VERSION 3.26)
+project (google-test-cpp-demo
+    VERSION 0.1.0
+    DESCRIPTION "Demonstrates usage of Testcontainers C++ in Google Test"
+    LANGUAGES CXX
+)
+
+set(TARGET_OUT ${PROJECT_NAME}.out)
+
+# GoogleTest requires at least C++14
+set(CMAKE_CXX_STANDARD 23)
+set(CMAKE_CXX_STANDARD_REQUIRED ON)
+include(FetchContent)
+FetchContent_Declare(
+    googletest
+    GIT_REPOSITORY https://github.com/google/googletest.git
+    GIT_TAG v1.17.0
+)
+set(gtest_force_shared_crt ON CACHE BOOL "" FORCE)
+FetchContent_MakeAvailable(googletest)
+
+enable_testing()
+file(COPY test_data DESTINATION ${CMAKE_CURRENT_BINARY_DIR})
+
+add_executable(${TARGET_OUT} test.cpp)
+target_link_libraries(${TARGET_OUT} PRIVATE testcontainers-cpp)
+target_link_libraries(${TARGET_OUT} PRIVATE GTest::gtest_main)
+
+include(GoogleTest)
+gtest_discover_tests(${TARGET_OUT})

demo/google-test-cpp/README.md

@@ -0,0 +1,28 @@
+# Using Testcontainers C in Google Test
+
+Demonstrates usage of Testcontainers C in [Google Test](https://github.com/google/googletest).
+See [test.cpp](./test.cpp) for the code.
+
+## Run the demo
+
+```bash
+cmake .
+cmake --build .
+cd demo/google-test
+ctest --output-on-failure
+```
+
+## Sample output
+
+```shell
+onenashev:~/testcontainers-c/demo/google-test$ ctest --output-on-failure
+Test project /home/onenashev/testcontainers-c/demo/google-test
+    Start 1: WireMockTestContainer.HelloWorld
+1/5 Test #1: WireMockTestContainer.HelloWorld ......................   Passed    3.31 sec
+    Start 2: WireMockTestContainer.HelloWorldFromResource
+2/5 Test #2: WireMockTestContainer.HelloWorldFromResource ..........   Passed    3.97 sec
+    Start 3: WireMockTestContainer.HelloWorldFromMissingResource
+3/5 Test #3: WireMockTestContainer.HelloWorldFromMissingResource ...   Passed    3.91 sec
+
+100% tests passed, 0 tests failed out of 3
+```

demo/google-test-cpp/test.cpp

@@ -0,0 +1,61 @@
+#include <iostream>
+#include <string>
+#include <gtest/gtest.h>
+#include "testcontainers.hpp"
+
+using namespace testcontainers;
+
+class WireMockTestContainerClass : public ::testing::Test {
+
+const char* WIREMOCK_IMAGE = "wiremock/wiremock:3.0.1-1";
+const char* WIREMOCK_ADMIN_MAPPING_ENDPOINT = "/__admin/mappings";
+
+protected:
+    void SetUp() override {
+        std::cout << "Creating new container: " << WIREMOCK_IMAGE << '\n';
+
+        container = std::make_unique<Container>(WIREMOCK_IMAGE);
+        container->expose_port(TcpPort{8080});
+        container->wait_for_http(TcpPort{8080}, WIREMOCK_ADMIN_MAPPING_ENDPOINT);
+        container->with_file("test_data/hello.json", "/home/wiremock/mappings/hello.json");
+        container->with_file("test_data/hello_with_resource.json", "/home/wiremock/mappings/hello2.json");
+        container->with_file("test_data/hello_with_missing_resource.json", "/home/wiremock/mappings/hello3.json");
+        container->with_file("test_data/response.xml", "/home/wiremock/__files/response.xml");
+
+        auto result = container->run();
+
+        EXPECT_TRUE(!result.has_value()) << "Failed to run the container: " << result.error();
+    };
+
+    std::unique_ptr<Container> container;
+};
+
+TEST_F(WireMockTestContainerClass, HelloWorld) {
+    std::cout << "Sending HTTP request to the container\n";
+
+    auto [code, response] = container->send_http(HttpMethod::Get, TcpPort{8080}, "/hello");
+
+    ASSERT_TRUE(response.has_value()) << "Failed to send HTTP request: " << response.error();
+    ASSERT_EQ(code, 200) << "Received wrong response code: " << response.error();
+
+    std::cout << "Server Response: HTTP-" << code << '\n' << response.value() << '\n';
+}
+
+TEST_F(WireMockTestContainerClass, HelloWorldFromResource) {
+    std::cout << "Sending HTTP request to the container\n";
+
+    auto [code, response] = container->send_http(HttpMethod::Get, TcpPort{8080}, "/hello-from-resource");
+
+    ASSERT_TRUE(response.has_value()) << "Failed to send HTTP request: " << response.error();
+    ASSERT_EQ(code, 200) << "Received wrong response code: " << response.error();
+
+    std::cout << "Server Response: HTTP-" << code << '\n' << response.value() << '\n';
+}
+
+TEST_F(WireMockTestContainerClass, HelloWorldFromMissingResource) {
+    std::cout << "Sending HTTP request to the container\n";
+
+    auto [code, response] = container->send_http(HttpMethod::Get, TcpPort{8080}, "/hello-from-missing-resource");
+
+    ASSERT_EQ(code, 500) << "The request should have failed";
+}

demo/google-test-cpp/test_data/hello.json

@@ -0,0 +1,12 @@
+{
+    "request": {
+      "method": "GET",
+      "url": "/hello"
+    },
+  
+    "response": {
+      "status": 200,
+      "body": "Hello, world!"
+    }
+  }
+  

demo/google-test-cpp/test_data/hello_with_missing_resource.json

@@ -0,0 +1,10 @@
+{
+  "request": {
+    "method": "GET",
+    "url": "/hello-from-missing-resource"
+  },
+  "response": {
+    "status": 200,
+    "bodyFileName": "response_missing.xml"
+  }
+}

demo/google-test-cpp/test_data/hello_with_resource.json

@@ -0,0 +1,10 @@
+{
+  "request": {
+    "method": "GET",
+    "url": "/hello-from-resource"
+  },
+  "response": {
+    "status": 200,
+    "bodyFileName": "response.xml"
+  }
+}

demo/google-test-cpp/test_data/response.xml

@@ -0,0 +1,6 @@
+<note>
+  <to>you</to>
+  <from>WireMock</from>
+  <heading>Response</heading>
+  <body>Hello, world!</body>
+</note>

testcontainers-cpp/CMakeLists.txt

@@ -0,0 +1,23 @@
+set(TARGET testcontainers-cpp)
+set(TARGET_NAME ${TARGET})
+set(TARGET_DESCRIPTION "Testcontainer library for C++")
+set(TARGET_VERSION ${PROJECT_VERSION})
+
+add_library(${TARGET} INTERFACE)
+
+set(CMAKE_CXX_STANDARD 23)
+set(CMAKE_CXX_STANDARD_REQUIRED ON)
+
+target_sources(${TARGET}
+    PUBLIC FILE_SET HEADERS
+    BASE_DIRS .
+    FILES testcontainers.hpp
+)
+
+target_link_libraries(${TARGET} INTERFACE testcontainers-c)
+
+configure_file(cmake.pc.in ${TARGET}.pc @ONLY)
+install(TARGETS ${TARGET}
+    LIBRARY DESTINATION ${CMAKE_INSTALL_LIBDIR}
+    PUBLIC_HEADER DESTINATION ${CMAKE_INSTALL_INCLUDEDIR})
+install(FILES ${CMAKE_BINARY_DIR}/${TARGET}.pc DESTINATION ${CMAKE_INSTALL_DATAROOTDIR}/pkgconfig)