ci: make the intermittent connect hang diagnosable and self-healing

.github/workflows/test.yml

@@ -34,8 +34,12 @@ jobs:
         python -m pip install -e .
 
     - name: Test
-      timeout-minutes: 1
-      run: python -m pytest --cov-report=xml --cov=.
+      # Leave room for faulthandler_timeout (60s) to dump stacks and for
+      # asyncssh's login_timeout (120s) to raise before the step is killed.
+      timeout-minutes: 3
+      run: >-
+        python -m pytest --cov-report=xml --cov=.
+        --reruns 1 --reruns-delay 2
 
     - name: Upload coverage to Codecov
       uses: codecov/codecov-action@v5

pyproject.toml

@@ -49,6 +49,13 @@ namespaces = false
 
 [tool.setuptools_scm]
 
+[tool.pytest.ini_options]
+# The suite intermittently hangs on the first SSH connection against
+# mock-ssh-server (Linux only). Dump all thread stacks when a test
+# exceeds this, so a hang in CI is diagnosable instead of a mute
+# step-timeout kill.
+faulthandler_timeout = 60
+
 [tool.black]
 line-length = 79
 target-version = ['py39']

requirements-dev.txt

@@ -1,5 +1,6 @@
 pytest
 pytest-asyncio
 pytest-cov
+pytest-rerunfailures
 mock-ssh-server
 importlib-metadata >= 6.0.0