Extract debug_utilities.hpp/cu from column_utilities.hpp/cu

cpp/CMakeLists.txt

@@ -835,6 +835,7 @@ if(CUDF_BUILD_TESTUTIL)
     tests/io/metadata_utilities.cpp
     tests/utilities/base_fixture.cpp
     tests/utilities/column_utilities.cu
+    tests/utilities/debug_utilities.cu
     tests/utilities/table_utilities.cu
     tests/utilities/tdigest_utilities.cu
   )

cpp/include/cudf_test/column_utilities.hpp

@@ -16,6 +16,11 @@
 
 #pragma once
 
+//
+// Do NOT include any header that directly or indirectly depends on gtest.
+// It is to make sure this file can be used and compiled outside of the test framework.
+//
+
 #include <cudf/column/column.hpp>
 #include <cudf/column/column_view.hpp>
 #include <cudf/detail/utilities/vector_factories.hpp>
@@ -140,39 +145,6 @@ void expect_equal_buffers(void const* lhs, void const* rhs, std::size_t size_byt
  */
 void expect_column_empty(cudf::column_view const& col);
 
-/**
- * @brief Formats a column view as a string
- *
- * @param col The column view
- * @param delimiter The delimiter to put between strings
- */
-std::string to_string(cudf::column_view const& col, std::string const& delimiter);
-
-/**
- * @brief Formats a null mask as a string
- *
- * @param null_mask The null mask buffer
- * @param null_mask_size Size of the null mask (in rows)
- */
-std::string to_string(std::vector<bitmask_type> const& null_mask, size_type null_mask_size);
-
-/**
- * @brief Convert column values to a host vector of strings
- *
- * @param col The column view
- */
-std::vector<std::string> to_strings(cudf::column_view const& col);
-
-/**
- * @brief Print a column view to an ostream
- *
- * @param os        The output stream
- * @param col       The column view
- */
-void print(cudf::column_view const& col,
-           std::ostream& os             = std::cout,
-           std::string const& delimiter = ",");
-
 /**
  * @brief Copy the null bitmask from a column view to a host vector
  *

cpp/include/cudf_test/debug_utilities.hpp

@@ -0,0 +1,56 @@
+/*
+ * Copyright (c) 2020-2023, NVIDIA CORPORATION.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+#pragma once
+
+//
+// Do NOT include any header that directly or indirectly depends on gtest.
+// It is to make sure this file can be used and compiled outside of the test framework.
+//
+// In order to use the APIs listed below outside of the test framework, simply include this header
+// and add the corresponding source file `test/utilities/debug_utilities.cu` into the CMake
+// target build.
+//
+
+#include <cudf/column/column_view.hpp>
+#include <cudf/null_mask.hpp>
+
+namespace cudf::test {
+
+/**
+ * @brief Formats a column view as a string
+ *
+ * @param col The input column view
+ * @param delimiter The delimiter to put between strings
+ */
+std::string to_string(cudf::column_view const& col, std::string const& delimiter);
+
+/**
+ * @brief Convert column values to a host vector of strings
+ *
+ * @param col The input column view
+ */
+std::vector<std::string> to_strings(cudf::column_view const& col);
+
+/**
+ * @brief Print a column view to an ostream
+ *
+ * @param col The input column view
+ * @param os The output stream
+ */
+void print(cudf::column_view const& col, std::ostream& os = std::cout);
+
+}  // namespace cudf::test

cpp/tests/groupby/structs_tests.cpp

@@ -18,6 +18,7 @@
 
 #include <cudf_test/base_fixture.hpp>
 #include <cudf_test/column_wrapper.hpp>
+#include <cudf_test/debug_utilities.hpp>
 #include <cudf_test/iterator_utilities.hpp>
 #include <cudf_test/type_lists.hpp>