Initial import of libdpf.

Co-authored-by: Cursor <cursoragent@cursor.com>

test/README.md

@@ -0,0 +1,52 @@
+# How to build tests
+
+To build the existing tests, simply run the following:
+
+```
+mkdir build && cd build
+cmake ..
+cmake --build .
+```
+
+# How to run tests
+
+Specific test executables will be placed in the `bin` subdirectory of the build directory. These can be run individually.
+
+Alternatively the `all_test` executable in the build directory can be run which automatically runs all test executables.
+
+# How to generate coverage
+
+First, when building the tests, make sure `COVERAGE=ON` as follows:
+
+```
+cmake -D COVERAGE=ON ..
+```
+
+Then after running all tests, run the following for `gcovr` coverage report:
+
+```
+mkdir coverage
+gcovr --root '../..' --filter '\.\./\.\./include/.*' --html-details 'coverage/index.html' .
+```
+
+# Building specific binaries
+
+To build a specific binary, for example `eval_point_test`, use the following:
+
+```
+cmake --build . --target eval_point_test
+```
+
+# Running specific tests
+
+First, to list available tests use the following (using `eval_point_test` as the example executable):
+
+```
+./bin/eval_point_test --gtest_list_tests
+```
+
+Next, using the `--gtest_filter` option, specific tests can be run using pattern matching. `?` matches a single character, `*` matches any substring, `:` seperates two patterns, and `-` at the beginning of a pattern makes it a negative pattern. Following is an example to only run `Basic` tests and ensure `BasicPathMemoizer` tests are not run:
+
+```
+./bin/eval_point_test --gtest_filter='*Basic*:-*BasicPathMemoizer*'
+```