qa: Add feature_framework_rpc_failure_details.py

test/functional/feature_framework_rpc_failure_details.py

@@ -0,0 +1,55 @@
+#!/usr/bin/env python3
+# Copyright (c) 2024-present The Bitcoin Core developers
+# Distributed under the MIT software license, see the accompanying
+# file COPYING or http://www.opensource.org/licenses/mit-license.php.
+"""
+Verify timing out in connecting to bitcoind's RPC interface throws an exception
+including details on what kind of failures happened before timing out.
+"""
+
+from test_framework.test_node import (
+    FailedToStartError,
+    TestNode,
+)
+from test_framework.util import (
+    assert_raises_message,
+    rpc_port,
+)
+from test_framework.test_framework import BitcoinTestFramework
+
+import re
+
+class FeatureFrameworkRPCFailureDetails(BitcoinTestFramework):
+    def set_test_params(self):
+        self.num_nodes = 1
+        # Lower the timeout so we don't wait that long
+        self.rpc_timeout = 3
+
+    # Overridden to avoid syncing non-started nodes.
+    def setup_network(self):
+        self.setup_nodes()
+
+    # Overridden to avoid starting nodes before run_test.
+    def setup_nodes(self):
+        self.add_nodes(self.num_nodes, self.extra_args)
+
+    def run_test(self):
+        e = assert_raises_message(
+            exc=AssertionError,
+            message="[node 0] Unable to connect to bitcoind after ",
+            fun=BitcoinTestFramework.start_node,
+            self=self,
+            i=0,
+            # Override RPC port to something TestNode isn't expecting so that we are
+            # unable to establish an RPC connection.
+            extra_args=[f'-rpcport={rpc_port(2)}'],
+        )
+        assert re.match(
+            r"^\[node 0\] Unable to connect to bitcoind after \ds \(ignored errors: {'.*'OSError ECONNREFUSED': .*, latest error: .*$", \
+            str(e)), \
+            f'Didn\'t find expected details in "{e}"'
+        self.log.info("One WARNING expected - Explicitly stopping the node to verify it completes cleanly during the test")
+        self.nodes[0].stop_node(avoid_exceptions=True)
+
+if __name__ == '__main__':
+    FeatureFrameworkRPCFailureDetails(__file__).main()

test/functional/test_framework/util.py

@@ -88,7 +88,7 @@ def assert_greater_than_or_equal(thing1, thing2):
 
 
 def assert_raises(exc, fun, *args, **kwds):
-    assert_raises_message(exc, None, fun, *args, **kwds)
+    return assert_raises_message(exc, None, fun, *args, **kwds)
 
 
 def assert_raises_message(exc, message, fun, *args, **kwds):
@@ -100,6 +100,7 @@ def assert_raises_message(exc, message, fun, *args, **kwds):
         if message is not None and message not in str(e):
             raise AssertionError(
                 f"Expected substring not found in error:\nsubstring: '{message}'\nerror: '{str(e)}'.")
+        return e
     except Exception as e:
         raise AssertionError("Unexpected exception raised: " + type(e).__name__)
     else:

test/functional/test_runner.py

@@ -405,6 +405,7 @@
     'feature_dirsymlinks.py',
     'feature_help.py',
     'feature_framework_rpc_failure.py',
+    'feature_framework_rpc_failure_details.py',
     'feature_shutdown.py',
     'wallet_migration.py',
     'p2p_ibd_txrelay.py',