build(cmake): Lower minimum Clang version for Velox compatibility: (#72)

Bill-hbrhbr · kirkrodrigues · web-flow · commit 9ed78cd04fad · 2025-08-18T01:42:06.000+08:00
Co-authored-by: kirkrodrigues &lt;2454684+kirkrodrigues@users.noreply.github.com&gt;
diff --git a/.github/workflows/unit-tests.yaml b/.github/workflows/unit-tests.yaml
@@ -43,21 +43,12 @@ jobs:
         run: "npm install -g @go-task/cli"
 
       - if: "'macos-14' == matrix.os"
-        name: "Install macOS 14 deps: coreutils (for md5sum) and Apple Clang 16 (for C++20)"
+        name: "Install coreutils (for md5sum)"
         run: |-
           brew install coreutils
-          brew install llvm@16
 
       - name: "Run unit tests and examples"
-        env: >-
-          ${{
-          'macos-14' == matrix.os
-          && fromJson('{
-          "CC": "/opt/homebrew/opt/llvm@16/bin/clang",
-          "CXX": "/opt/homebrew/opt/llvm@16/bin/clang++"
-          }')
-          || fromJson('{}')
-          }}
+
         # Currently unit tests rely on cassert and fail to compile in release mode.
         run: |-
           task test:run-debug
diff --git a/CMakeLists.txt b/CMakeLists.txt
@@ -5,32 +5,14 @@ project(ystdlib VERSION "0.1.0" LANGUAGES CXX)
 list(APPEND CMAKE_MODULE_PATH "${CMAKE_CURRENT_LIST_DIR}/cmake")
 include(CMakePackageConfigHelpers)
 include(GNUInstallDirs)
+include(Toolchains/utils)
 include(ystdlib-helpers)
 
+validate_compiler_versions()
+
 option(BUILD_SHARED_LIBS "Build using shared libraries." OFF)
 option(ystdlib_BUILD_TESTING "Build the testing tree for ystdlib." ON)
 
-# Require compiler versions that support the C++20 features necessary for compiling ystdlib
-if("AppleClang" STREQUAL "${CMAKE_CXX_COMPILER_ID}")
-    set(ystdlib_CMAKE_CXX_COMPILER_MIN_VERSION "16")
-elseif("Clang" STREQUAL "${CMAKE_CXX_COMPILER_ID}")
-    set(ystdlib_CMAKE_CXX_COMPILER_MIN_VERSION "16")
-elseif("GNU" STREQUAL "${CMAKE_CXX_COMPILER_ID}")
-    set(ystdlib_CMAKE_CXX_COMPILER_MIN_VERSION "11")
-else()
-    message(
-        FATAL_ERROR
-        "Unsupported compiler: ${CMAKE_CXX_COMPILER_ID}. Please use AppleClang, Clang, or GNU."
-    )
-endif()
-if("${CMAKE_CXX_COMPILER_VERSION}" VERSION_LESS "${ystdlib_CMAKE_CXX_COMPILER_MIN_VERSION}")
-    message(
-        FATAL_ERROR
-        "${CMAKE_CXX_COMPILER_ID} version ${CMAKE_CXX_COMPILER_VERSION} is too low. Must be at \
-        least ${ystdlib_CMAKE_CXX_COMPILER_MIN_VERSION}."
-    )
-endif()
-
 set(CMAKE_EXPORT_COMPILE_COMMANDS
     ON
     CACHE BOOL
diff --git a/cmake/Toolchains/utils.cmake b/cmake/Toolchains/utils.cmake
@@ -0,0 +1,26 @@
+# This file contains utility functions for validating toolchain versions to ensure compatibility
+# with the C++20 features required by the project.
+
+# Checks if the compiler ID and version meet the minimum requirements to support C++20 features
+# required by the project.
+function(validate_compiler_versions)
+    if("AppleClang" STREQUAL "${CMAKE_CXX_COMPILER_ID}")
+        set(CXX_COMPILER_MIN_VERSION "15")
+    elseif("Clang" STREQUAL "${CMAKE_CXX_COMPILER_ID}")
+        set(CXX_COMPILER_MIN_VERSION "15")
+    elseif("GNU" STREQUAL "${CMAKE_CXX_COMPILER_ID}")
+        set(CXX_COMPILER_MIN_VERSION "11")
+    else()
+        message(
+            FATAL_ERROR
+            "Unsupported compiler: ${CMAKE_CXX_COMPILER_ID}. Please use AppleClang, Clang, or GNU."
+        )
+    endif()
+    if("${CMAKE_CXX_COMPILER_VERSION}" VERSION_LESS "${CXX_COMPILER_MIN_VERSION}")
+        message(
+            FATAL_ERROR
+            "${CMAKE_CXX_COMPILER_ID} version ${CMAKE_CXX_COMPILER_VERSION} is too low. Must be at"
+            " least ${CXX_COMPILER_MIN_VERSION}."
+        )
+    endif()
+endfunction()
diff --git a/cmake/ystdlib-helpers.cmake b/cmake/ystdlib-helpers.cmake
@@ -114,7 +114,7 @@ function(add_cpp_library)
     )
 endfunction()
 
-# Adds a C++ 20 test executable named `unit-test-NAME` that will be built with `SOURCES` and linked
+# Adds a C++20 test executable named `unit-test-NAME` that will be built with `SOURCES` and linked
 # with `LINK_LIBRARIES`, in addition to Catch2.
 #
 # @param {string} NAME
diff --git a/src/ystdlib/containers/Array.hpp b/src/ystdlib/containers/Array.hpp
@@ -37,7 +37,7 @@ class Array {
             // NOLINTNEXTLINE(*-avoid-c-arrays)
             : m_data{std::make_unique<T[]>(list.size())},
               m_size{list.size()} {
-        std::ranges::copy(list, m_data.get());
+        std::copy(list.begin(), list.end(), m_data.get());
     }
 
     // Disable copy constructor and assignment operator
diff --git a/src/ystdlib/containers/test/test_Array.cpp b/src/ystdlib/containers/test/test_Array.cpp
@@ -1,7 +1,6 @@
 #include <algorithm>
 #include <concepts>
 #include <cstddef>
-#include <ranges>
 #include <stdexcept>
 #include <string>
 #include <string_view>
@@ -66,9 +65,12 @@ void test_list_initialization_in_function_call(
         ystdlib::containers::Array<PolymorphicConstructors> const& arr,
         std::vector<size_t> const& data
 ) {
-    REQUIRE(std::ranges::equal(
-            arr | std::views::transform([](auto const& obj) { return obj.get_value(); }),
-            data
+    REQUIRE(std::equal(
+            arr.begin(),
+            arr.end(),
+            data.begin(),
+            data.end(),
+            [](auto const& obj, size_t v) { return obj.get_value() == v; }
     ));
 }
 }  // namespace
@@ -88,7 +90,7 @@ TEST_CASE("test_array_reference", "[containers][Array]") {
         arr.at(idx) = idx;
     }
     auto const& arr_const_ref = arr;
-    REQUIRE(std::ranges::equal(arr, arr_const_ref));
+    REQUIRE(std::equal(arr.begin(), arr.end(), arr_const_ref.begin(), arr_const_ref.end()));
 }
 
 TEST_CASE("test_array_ranged_copy", "[containers][Array]") {
@@ -97,8 +99,8 @@ TEST_CASE("test_array_ranged_copy", "[containers][Array]") {
         vec.push_back(idx);
     }
     Array<size_t> arr(cBufferSize);
-    std::ranges::copy(vec, arr.begin());
-    REQUIRE(std::ranges::equal(vec, arr));
+    std::copy(vec.begin(), vec.end(), arr.begin());
+    REQUIRE(std::equal(vec.cbegin(), vec.cend(), arr.begin(), arr.end()));
 }
 
 TEST_CASE("test_array_movable", "[containers][Array]") {
@@ -109,7 +111,12 @@ TEST_CASE("test_array_movable", "[containers][Array]") {
         reference_array.at(idx) = idx;
     }
     auto const arr_moved{std::move(arr)};
-    REQUIRE(std::ranges::equal(reference_array, arr_moved));
+    REQUIRE(std::equal(
+            reference_array.begin(),
+            reference_array.end(),
+            arr_moved.begin(),
+            arr_moved.end()
+    ));
 }
 
 TEST_CASE("test_array_illegal_access", "[containers][Array]") {
@@ -143,8 +150,8 @@ TEMPLATE_TEST_CASE(
 ) {
     REQUIRE(std::is_fundamental_v<TestType>);
     Array<TestType> arr(cBufferSize);
-    std::ranges::for_each(arr, [](auto const& p) -> void {
-        REQUIRE((static_cast<TestType>(0) == p));
+    std::for_each(arr.begin(), arr.end(), [](auto const& p) {
+        REQUIRE(static_cast<TestType>(0) == p);
     });
 }
 
@@ -158,7 +165,7 @@ TEST_CASE("test_array_list_initialization", "[containers][Array]") {
             vec{"yscope", "clp", "ystdlib", "ystdlib::containers::Array", "default_initializable"};
     Array<std::string> const
             arr{"yscope", "clp", "ystdlib", "ystdlib::containers::Array", "default_initializable"};
-    REQUIRE(std::ranges::equal(vec, arr));
+    REQUIRE(std::equal(vec.cbegin(), vec.cend(), arr.begin(), arr.end()));
 
     // Test polymorphic list initialization
     REQUIRE(std::is_copy_constructible_v<PolymorphicConstructors>);
@@ -174,10 +181,12 @@ TEST_CASE("test_array_list_initialization", "[containers][Array]") {
                    cTestNum0,
                    std::string{cTestStr},
                    ExplicitConstructor{cTestNum1}};
-        REQUIRE(std::ranges::equal(
-                list_init_arr
-                        | std::views::transform([](auto const& obj) { return obj.get_value(); }),
-                data
+        REQUIRE(std::equal(
+                list_init_arr.begin(),
+                list_init_arr.end(),
+                data.cbegin(),
+                data.cend(),
+                [](auto const& obj, auto const& v) { return obj.get_value() == v; }
         ));
     }
 
diff --git a/src/ystdlib/error_handling/CMakeLists.txt b/src/ystdlib/error_handling/CMakeLists.txt
@@ -16,7 +16,6 @@ add_cpp_library(
     NAMESPACE ystdlib
     PUBLIC_HEADERS
         ErrorCode.hpp
-        TraceableException.hpp
         Result.hpp
         utils.hpp
     PUBLIC_LINK_LIBRARIES
@@ -30,7 +29,6 @@ if(ystdlib_ENABLE_TESTS)
         SOURCES
             test/test_ErrorCode.cpp
             test/test_Result.cpp
-            test/test_TraceableException.cpp
             test/types.cpp
         UNIFIED_TEST_TARGET "${UNIFIED_UNIT_TEST_TARGET}"
     )
diff --git a/src/ystdlib/error_handling/TraceableException.hpp b/src/ystdlib/error_handling/TraceableException.hpp
diff --git a/src/ystdlib/error_handling/test/test_ErrorCode.cpp b/src/ystdlib/error_handling/test/test_ErrorCode.cpp
@@ -49,11 +49,11 @@ TEST_CASE("test_error_code", "[error_handling][ErrorCode]") {
 
 TEST_CASE("test_error_code_failure_condition", "[error_handling][ErrorCode]") {
     std::error_code const failure_error_code{BinaryErrorCode{BinaryErrorCodeEnum::Failure}};
-    std::ranges::for_each(cFailureConditions, [&](auto const& failure_condition) {
-        REQUIRE((failure_error_code == failure_condition));
-    });
-    std::ranges::for_each(cNoneFailureConditions, [&](auto const& none_failure_condition) {
-        REQUIRE((failure_error_code != none_failure_condition));
-    });
+    for (auto const& failure_condition : cFailureConditions) {
+        REQUIRE(failure_error_code == failure_condition);
+    }
+    for (auto const& none_failure_condition : cNoneFailureConditions) {
+        REQUIRE(failure_error_code != none_failure_condition);
+    }
 }
 }  // namespace ystdlib::error_handling::test
diff --git a/src/ystdlib/error_handling/test/test_TraceableException.cpp b/src/ystdlib/error_handling/test/test_TraceableException.cpp
diff --git a/src/ystdlib/error_handling/test/types.cpp b/src/ystdlib/error_handling/test/types.cpp
@@ -61,7 +61,7 @@ auto BinaryErrorCategory::equivalent(
 ) const noexcept -> bool {
     switch (error_enum) {
         case BinaryErrorCodeEnum::Failure:
-            return std::ranges::any_of(
+            return std::any_of(
                     cFailureConditions.cbegin(),
                     cFailureConditions.cend(),
                     [&](auto failure_condition) -> bool { return condition == failure_condition; }

Original file line number	Diff line number	Diff line change
`@@ -114,7 +114,7 @@ function(add_cpp_library)`
`114`	`114`	`)`
`115`	`115`	`endfunction()`
`116`	`116`
`117`		-# Adds a C++ 20 test executable named `unit-test-NAME` that will be built with `SOURCES` and linked
	`117`	+# Adds a C++20 test executable named `unit-test-NAME` that will be built with `SOURCES` and linked
`118`	`118`	# with `LINK_LIBRARIES`, in addition to Catch2.
`119`	`119`	`#`
`120`	`120`	`# @param {string} NAME`
Original file line number	Diff line number	Diff line change
`@@ -37,7 +37,7 @@ class Array {`
`37`	`37`	`// NOLINTNEXTLINE(*-avoid-c-arrays)`
`38`	`38`	`: m_data{std::make_unique<T[]>(list.size())},`
`39`	`39`	`m_size{list.size()} {`
`40`		`- std::ranges::copy(list, m_data.get());`
	`40`	`+ std::copy(list.begin(), list.end(), m_data.get());`
`41`	`41`	`}`
`42`	`42`
`43`	`43`	`// Disable copy constructor and assignment operator`