aboutsummaryrefslogtreecommitdiffstats
path: root/pkg-test/README.md
diff options
context:
space:
mode:
authorJay Berkenbilt <ejb@ql.org>2022-03-18 02:06:23 +0100
committerJay Berkenbilt <jberkenbilt@users.noreply.github.com>2022-03-19 00:53:18 +0100
commite316e90d1f3124e1ddb7f33f77b91af178b963bd (patch)
tree810730d6012f5f865743e5bcdfadd38ea00b0466 /pkg-test/README.md
parentacdf5b2e7a9b3074125bc95bfcf7e6abdc9704b4 (diff)
downloadqpdf-e316e90d1f3124e1ddb7f33f77b91af178b963bd.tar.zst
Add installed package smoke tests in pkg-test directory
Diffstat (limited to 'pkg-test/README.md')
-rw-r--r--pkg-test/README.md14
1 files changed, 14 insertions, 0 deletions
diff --git a/pkg-test/README.md b/pkg-test/README.md
new file mode 100644
index 00000000..95f7ecb8
--- /dev/null
+++ b/pkg-test/README.md
@@ -0,0 +1,14 @@
+# Tests for installed packages
+
+The files in this directory are called by autopkgtest in the debian package but can be used by any packager to verify installed packages. Each test-* script should be run from the top of the source tree and takes an empty directory as its single argument. The test passes if the script exits with a zero exit status. Note that these tests write to stderr because they use set -x in the shell.
+
+On a GNU/Linux system, you can run `./pkg-test/run-all` from the top-level directory to run all the tests. For example:
+
+```
+cmake -S . -B build
+cmake --build build -j$(nproc)
+DESTDIR=/tmp/inst cmake --install build
+env PKG_CONFIG_PATH=/tmp/inst/usr/local/lib/pkgconfig \
+ CMAKE_PREFIX_PATH=/tmp/inst/usr/local \
+ ./pkg-test/run-all
+```