Auto File Management Part 3: Install data-management tool as command line program

CMakeLists.txt

@@ -130,9 +130,7 @@ the structure of this directory
   # these intentionally are not CACHE variables
   set(CMAKE_LIBRARY_OUTPUT_DIRECTORY ${stageDir}/${CMAKE_INSTALL_LIBDIR})
   set(CMAKE_ARCHIVE_OUTPUT_DIRECTORY ${stageDir}/${CMAKE_INSTALL_LIBDIR})
-
-  # don't currently need the following since grackle doesn't ship an executable
-  #set(CMAKE_RUNTIME_OUTPUT_DIRECTORY ${stageDir}/${CMAKE_INSTALL_BINDIR})
+  set(CMAKE_RUNTIME_OUTPUT_DIRECTORY ${stageDir}/${CMAKE_INSTALL_BINDIR})
 
   # the location where the export files go to export from build-tree
   set(GRACKLE_BUILD_EXPORT_PREFIX_PATH ${CMAKE_LIBRARY_OUTPUT_DIRECTORY})
@@ -171,10 +169,55 @@ if (UNIX AND NOT CMAKE_SYSTEM_NAME STREQUAL "Darwin")
   set_target_properties(toolchain::m PROPERTIES IMPORTED_LIBNAME "m")
 endif()
 
+
+# picohash is a vendored, self-contained, header-only library
+# -> it's a internal dependency of Grackle::Grackle (it shouldn't be exposed)
+# -> If it were an `INTERFACE` library, CMake would abort with an error when we
+#    declare rules for installing the "export information" for a static-lib
+#    build of Grackle::Grackle (there aren't problems for a shared-lib build)
+#    -> The "export information" includes autogenerated linking logic that gets
+#       evaluated by external CMake projects that consume Grackle::Grackle via
+#       `find_package`. This logic infers a list of any other libraries that
+#       are shipped by this project that need to be linked to use libgrackle.a
+#    -> When invoked, the logic goes through ALL of Grackle::Grackle's (public
+#       & private) depenedencies that COULD specify such linking requirements.
+#    -> CMake will complain if any INTERFACE library used by Grackle::Grackle
+#       isn't publicaly exported since it COULD specify this information.
+#    -> the BUILD_LOCAL_INTERFACE generator expression, (in CMake 3.26+) can
+#       work around this
+# -> this isn't an issue for INTERFACE IMPORTED libraries since IMPORTED
+#    libs should only specify linker requirements of prebuilt external libs,
+#    if there are any. (i.e. if there are any reqs, CMake expects the developer
+#    to manually add logic to the installed "export info")
+add_library(picohash INTERFACE IMPORTED)
+
+# we use the SYSTEM option to suppress any warnings
+target_include_directories(picohash SYSTEM INTERFACE
+  ${CMAKE_CURRENT_SOURCE_DIR}/external
+)
+
 # Main build targets
 # ------------------
 add_subdirectory(src/clib)
 
+# configure the grdata cli program
+# -> we are essentially performing some template substitutions on a python
+#    file so that the file can be executed as a standalone cli program
+include(CreateProgram-grdata)
+create_grdata_program(
+  GRACKLE_VERSION "${_GRACKLE_FULL_VERSION}"
+  TARGET_NAME Grackle::grdata
+)
+
+file(GENERATE
+  OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/grackle-buildpaths-$<CONFIG>.txt
+  CONTENT [[
+# This file lists paths where useful build products can be found in the build
+# directory (if/when the products are actually built)
+$<TARGET_FILE:Grackle::grdata>
+]])
+
+
 # declare build-recipies for examples
 if (GRACKLE_EXAMPLES)
   add_subdirectory(src/example)