[_TENTATIVE_SQUASH] mostly review based changes ...

(including the below commits):

reorganize directory structure

more misc. changes, mostly review-based

add comment re pg_isready

update key download & signing

make directory /etc/apt/keyrings

specify location of xmlrunner reports in multiple-node README

get rid of symlinks

include all tests

add shebang line

Author: d-w-moore

.github/workflows/README.md

@@ -2,6 +2,8 @@
 # https://github.com/actions/starter-workflows/blob/master/ci/python-package.yml
 # (C) Github, MIT License
 
+# Static type checking tests using `mypy`.
+
 name: "Python type checking"
 
 on: [push, pull_request]

.github/workflows/main.yml

@@ -0,0 +1,40 @@
+# Run a set of tests, each in its own container and with a potentially customized setup.
+
+# To this end, each test is launched via docker_container_driver.sh, part of the single-node
+# test harness machinery whose implementation and documentation is to be found in the
+# `irods/test/harness` directory.
+
+# A test may be written as a Bash or BATS script, but the only real requirement is that it be
+# executable.
+
+name: run-test-programs-single-node
+
+on: [push, pull_request]
+
+jobs:
+  tests:
+    name: Python ${{ matrix.python }}, iRODS ${{ matrix.irods_server }}
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+          working-directory: ./test_harness/single_node
+    strategy:
+      matrix:
+        python: ['3.9','3.13']
+        irods_server: ['4.3.4','5.0.2']
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Build images
+        run: ./create_docker_images.sh "${{ matrix.irods_server }}" "${{ matrix.python }}"
+
+      - name: run tests
+        run: |
+          for script in \
+              ../../irods/test/scripts/test[0-9]* \
+              ../../irods/test/login_auth_test_*.py
+          do
+              ./docker_container_driver.sh -V $script
+          done

.github/workflows/run-local-suite.yml

@@ -1,16 +1,17 @@
-name: run-the-tests
+# Create a networked set of containers (via a Docker compose project) on which to run the client test suite.
+# (For further information, see the README in `docker-testing`.)
+
+name: run-test-suite-multiple-node
 
 on: [push, pull_request]
 
 jobs:
   tests:
-    timeout-minutes: 20
-
     name: Python ${{ matrix.python }}, iRODS ${{ matrix.irods_server }}
     runs-on: ubuntu-latest
     defaults:
       run:
-          working-directory: ./docker-testing
+          working-directory: ./test_harness/multiple_node
     strategy:
       matrix:
         python: ['3.9','3.13']
@@ -31,8 +32,8 @@ jobs:
             sleep 1
           done
           echo "client_container = [$client_container]"
-          docker exec "${client_container}" /repo_root/docker-testing/run_tests.sh
+          docker exec "${client_container}" /repo_root/test_harness/multiple_node/run_tests.sh
 
       - name: Stop containers
         if: always()
-        run: ./stop_containers.sh "${{ matrix.irods_server }}" "${{ matrix.python }}"
+        run: ./stop_containers.sh "${{ matrix.irods_server }}"

.github/workflows/run-test-programs-single-node.yml

@@ -1,16 +1,17 @@
-name: run-bats-tests
+# Run the client test suite in a Docker container, targeting a locally running instance of the iRODS server.
+# (Documentation and implementation for the test harness may be found in `irods/test/harness`.)
+
+name: run-test-suite-single-node
 
 on: [push, pull_request]
 
 jobs:
   tests:
-    timeout-minutes: 20
-
     name: Python ${{ matrix.python }}, iRODS ${{ matrix.irods_server }}
     runs-on: ubuntu-latest
     defaults:
       run:
-          working-directory: ./irods/test/harness
+          working-directory: ./test_harness/single_node
     strategy:
       matrix:
         python: ['3.9','3.13']
@@ -25,6 +26,4 @@ jobs:
 
       - name: run tests
         run: |
-          for script in ../scripts/test[0-9]*; do
-              ./docker_container_driver.sh -V $script
-          done
+          ./docker_container_driver.sh -V ../../irods/test/scripts/run_suite_locally.sh