move to tools and rename podio_test_hashes (#881)

* move to tools and rename podio_test_hashes

* add docs

Author: m-fila

doc/tools.md

@@ -107,3 +107,15 @@ Example usage:
 podio-vis --fmt svg my_model.yaml
 firefox gv.svg
 ```
+
+## Testing hash collisions in collection names: `podio-test-hashes`
+
+`podio-test-hashes` is a small utility that checks whether a list of collection names produces collisions when hashed into PODIO collection IDs.
+The names should be provided in a test file, separated by whitespace.
+If any collisions are found, the tool will return status code `1` and print the colliding names along with their computed hash IDs.
+
+Example usage:
+
+```bash
+podio-test-hashes collection_names.txt
+```

src/CMakeLists.txt

@@ -252,10 +252,3 @@ if (ENABLE_DATASOURCE)
     DESTINATION "${CMAKE_INSTALL_LIBDIR}"
     )
 endif()
-
-add_executable(podio_test_hashes test_hashes.cpp)
-target_link_libraries(podio_test_hashes PRIVATE podio::podio)
-install(TARGETS podio_test_hashes
-  EXPORT podioTargets
-  DESTINATION "${CMAKE_INSTALL_BINDIR}"
-)

tools/CMakeLists.txt

@@ -1,3 +1,8 @@
+
+add_executable(podio-test-hashes src/podio-test-hashes.cpp)
+target_link_libraries(podio-test-hashes PRIVATE podio::podio)
+install(TARGETS podio-test-hashes EXPORT podioTargets DESTINATION "${CMAKE_INSTALL_BINDIR}")
+
 add_executable(podio-dump-tool src/podio-dump-tool.cpp)
 target_link_libraries(podio-dump-tool PRIVATE podio::podio podio::podioIO fmt::fmt)
 

src/test_hashes.cpp tools/src/podio-test-hashes.cppsrc/test_hashes.cpp renamed to tools/src/podio-test-hashes.cpp

@@ -1,4 +1,4 @@
-#include "MurmurHash3.h"
+#include "../src/MurmurHash3.h"
 
 #include <fstream>
 #include <iomanip>
@@ -87,7 +87,7 @@ std::ostream& operator<<(std::ostream& os, const std::vector<T, A>& vec) {
   return os << ']';
 }
 
-constexpr static auto usage = R"USAGE(usage: podio_test_hashes [-h] collNameFile)USAGE";
+constexpr static auto usage = R"USAGE(usage: podio-test-hashes [-h] collNameFile)USAGE";
 constexpr static auto help = R"HELP(
 Check if any of the collection names provided lead to a collision in the collection IDs