From 2c7759b5bcb8c82452a3f01f5df815ef2d41de13 Mon Sep 17 00:00:00 2001
From: Jun Aruga <jaruga@redhat.com>
Date: Tue, 17 Dec 2024 16:38:31 +0100
Subject: [PATCH] README.md: Add how to test with a rpms/ruby PR.

Note I used the `koji download-task` command rather than `koji download-build`,
because it seems the `koji download-build` doesn't work for scratch build.[1]

[1] https://pagure.io/koji/issue/4283
---
 README.md | 29 +++++++++++++++++++++++++++++
 1 file changed, 29 insertions(+)

diff --git a/README.md b/README.md
index 77effe8..4ba8132 100644
--- a/README.md
+++ b/README.md
@@ -64,3 +64,32 @@ $ tmt -c distro=fedora-rawhide run --all \
   provision -h virtual -i fedora-rawhide \
   tests -n '^/systemtap-static-probes-in-ruby$'
 ```
+
+#### Testing with a rpms/ruby pull-request
+
+Run a scratch build x86_64 on the branch used for the rpms/ruby pull-request
+that you want to test:
+
+```
+$ fedpkg --release rawhide scratch-build --srpm --arches x86_64
+```
+
+Run the following command with the above build's x86_64 task ID (not build ID)
+to download the RPM packages. Remove the SRPM file to keep only binary RPM files
+in the `/path/to/packages` directory to avoid an error on the later `tmt`
+command.
+
+```
+$ pwd
+/path/to/packages
+$ koji download-task TASK_ID
+$ rm *.src.rpm
+```
+
+Run the following command to run the tests with the above RPM files.
+
+```
+$ tmt -c distro=fedora-rawhide run --all \
+  prepare --insert --how install -D /path/to/packages \
+  provision -h virtual -i fedora-rawhide
+```