Repalce usage of legacy vars <Package>_[LIB|TEST]_[REQUIRED|OPTIONAL]_DEP_[PACKAGES|TPLS] (#63)

test/core/CMakeLists.txt

@@ -49,7 +49,7 @@ tribits_add_advanced_test( TestingFunctionMacro_UnitTests
       -D${PROJECT_NAME}_TRIBITS_DIR=${${PROJECT_NAME}_TRIBITS_DIR}
       -P "${CMAKE_CURRENT_SOURCE_DIR}/TestingFunctionMacro_UnitTests.cmake"
     PASS_REGULAR_EXPRESSION_ALL
-      "Final UnitTests Result: num_run = 719"
+      "Final UnitTests Result: num_run = 721"
       "Final UnitTests Result: PASSED"
   )
 

test/core/TestingFunctionMacro_UnitTests.cmake

@@ -65,6 +65,7 @@ include(TribitsTplFindIncludeDirsAndLibraries)
 include(TribitsReportInvalidTribitsUsage)
 include(TribitsGitRepoVersionInfo)
 include(TribitsDeprecatedHelpers)
+include(TribitsCreateReverseList)
 include(UnitTestHelpers)
 include(GlobalSet)
 include(GlobalNullSet)
@@ -132,6 +133,26 @@ function(unittest_append_string_var)
 endfunction()
 
 
+function(unittest_tribit_create_reverse_list)
+
+  message("\n***")
+  message("*** Testing tribit_create_reverse_list()")
+  message("***\n")
+
+  message("tribit_create_reverse_list() with empty list")
+  set(someEmptyList "")
+  tribit_create_reverse_list(someEmptyList  someEmptyList_reversed)
+  unittest_compare_const(someEmptyList_reversed "")
+
+
+  message("tribit_create_reverse_list() with non-empty list")
+  set(someList a b c d)
+  tribit_create_reverse_list(someList  someList_reversed)
+  unittest_compare_const(someList_reversed "d;c;b;a")
+
+endfunction()
+
+
 function(unittest_tribits_find_python_interp)
 
   message("\n***")
@@ -4740,6 +4761,7 @@ message("*** Testing misc TriBITS functions and macros")
 message("***\n")
 
 unittest_append_string_var()
+unittest_tribit_create_reverse_list()
 unittest_tribits_find_python_interp()
 unittest_tribits_standardize_abs_paths()
 unittest_tribits_dir_is_basedir()
@@ -4813,4 +4835,4 @@ message("*** Determine final result of all unit tests")
 message("***\n")
 
 # Pass in the number of expected tests that must pass!
-unittest_final_result(719)
+unittest_final_result(721)

tribits/core/utils/TribitsCreateReverseList.cmake

@@ -0,0 +1,52 @@
+# @HEADER
+# ************************************************************************
+#
+#            TriBITS: Tribal Build, Integrate, and Test System
+#                    Copyright 2013 Sandia Corporation
+#
+# Under the terms of Contract DE-AC04-94AL85000 with Sandia Corporation,
+# the U.S. Government retains certain rights in this software.
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are
+# met:
+#
+# 1. Redistributions of source code must retain the above copyright
+# notice, this list of conditions and the following disclaimer.
+#
+# 2. Redistributions in binary form must reproduce the above copyright
+# notice, this list of conditions and the following disclaimer in the
+# documentation and/or other materials provided with the distribution.
+#
+# 3. Neither the name of the Corporation nor the names of the
+# contributors may be used to endorse or promote products derived from
+# this software without specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED BY SANDIA CORPORATION "AS IS" AND ANY
+# EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+# PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL SANDIA CORPORATION OR THE
+# CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+# EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+# PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
+# PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+# LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+# NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+# SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+#
+# ************************************************************************
+# @HEADER
+
+
+# @MACRO: tribit_create_reverse_list()
+#
+# Create a reverse list var in one shot.
+#
+# Usage::
+#
+#   tribit_create_reverse_list(<oldListName> <newListName>)
+#
+macro(tribit_create_reverse_list  oldListName  newListName)
+  set(${newListName} ${${oldListName}})
+  list(REVERSE ${newListName})
+endmacro()

tribits/doc/guides/UtilsMacroFunctionDocTemplate.rst

@@ -42,6 +42,7 @@
 @FUNCTION: tribits_add_enum_cache_var() +
 @FUNCTION: tribits_deprecated() +
 @FUNCTION: tribits_deprecated_command() +
+@MACRO:    tribit_create_reverse_list() +
 @FUNCTION: tribits_strip_quotes_from_str() +
 @FUNCTION: unittest_compare_const() +
 @FUNCTION: unittest_has_substr_const() +