gh-115258: Fix hanging tests for threading queue shutdown (#115940)

This reinstates `test_shutdown_immediate_all_methods_in_many_threads`
and improves `test_shutdown_all_methods_in_many_threads`.

Lib/test/test_queue.py

@@ -317,97 +317,107 @@ class BaseQueueTestMixin(BlockingTestMixin):
     def test_shutdown_immediate_all_methods_in_one_thread(self):
         return self._shutdown_all_methods_in_one_thread(True)
 
-    def _write_msg_thread(self, q, n, results, delay,
+    def _write_msg_thread(self, q, n, results,
-                            i_when_exec_shutdown,
+                            i_when_exec_shutdown, event_shutdown,
-                            event_start, event_end):
+                            barrier_start):
-        event_start.wait()
+        # All `write_msg_threads`
-        for i in range(1, n+1):
+        # put several items into the queue.
+        for i in range(0, i_when_exec_shutdown//2):
+            q.put((i, 'LOYD'))
+        # Wait for the barrier to be complete.
+        barrier_start.wait()
+
+        for i in range(i_when_exec_shutdown//2, n):
             try:
                 q.put((i, "YDLO"))
-                results.append(True)
             except self.queue.ShutDown:
                 results.append(False)
-            # triggers shutdown of queue
+                break
-            if i == i_when_exec_shutdown:
-                event_end.set()
-            time.sleep(delay)
-        # end of all puts
-        q.join()
 
-    def _read_msg_thread(self, q, nb, results, delay, event_start):
+            # Trigger queue shutdown.
-        event_start.wait()
+            if i == i_when_exec_shutdown:
-        block = True
+                # Only one thread should call shutdown().
-        while nb:
+                if not event_shutdown.is_set():
-            time.sleep(delay)
+                    event_shutdown.set()
-            try:
-                # Get at least one message
-                q.get(block)
-                block = False
-                q.task_done()
                     results.append(True)
-                nb -= 1
+
+    def _read_msg_thread(self, q, results, barrier_start):
+        # Get at least one item.
+        q.get(True)
+        q.task_done()
+        # Wait for the barrier to be complete.
+        barrier_start.wait()
+        while True:
+            try:
+                q.get(False)
+                q.task_done()
             except self.queue.ShutDown:
-                results.append(False)
+                results.append(True)
-                nb -= 1
+                break
             except self.queue.Empty:
                 pass
-        q.join()
 
-    def _shutdown_thread(self, q, event_end, immediate):
+    def _shutdown_thread(self, q, results, event_end, immediate):
         event_end.wait()
         q.shutdown(immediate)
-        q.join()
+        results.append(q.qsize() == 0)
 
-    def _join_thread(self, q, delay, event_start):
+    def _join_thread(self, q, barrier_start):
-        event_start.wait()
+        # Wait for the barrier to be complete.
-        time.sleep(delay)
+        barrier_start.wait()
         q.join()
 
     def _shutdown_all_methods_in_many_threads(self, immediate):
+        # Run a 'multi-producers/consumers queue' use case,
+        # with enough items into the queue.
+        # When shutdown, all running threads will be joined.
         q = self.type2test()
         ps = []
-        ev_start = threading.Event()
-        ev_exec_shutdown = threading.Event()
         res_puts = []
         res_gets = []
-        delay = 1e-4
+        res_shutdown = []
-        read_process = 4
+        write_threads = 4
-        nb_msgs = read_process * 16
+        read_threads = 6
-        nb_msgs_r = nb_msgs // read_process
+        join_threads = 2
-        when_exec_shutdown = nb_msgs // 2
+        nb_msgs = 1024*64
-        lprocs = (
+        nb_msgs_w = nb_msgs // write_threads
-            (self._write_msg_thread, 1,  (q, nb_msgs, res_puts, delay,
+        when_exec_shutdown = nb_msgs_w // 2
-                                            when_exec_shutdown,
+        # Use of a Barrier to ensure that
-                                            ev_start, ev_exec_shutdown)),
+        # - all write threads put all their items into the queue,
-            (self._read_msg_thread, read_process, (q, nb_msgs_r,
+        # - all read thread get at least one item from the queue,
-                                                    res_gets, delay*2,
+        #   and keep on running until shutdown.
-                                                    ev_start)),
+        # The join thread is started only when shutdown is immediate.
-            (self._join_thread, 2, (q, delay*2, ev_start)),
+        nparties = write_threads + read_threads
-            (self._shutdown_thread, 1, (q, ev_exec_shutdown, immediate)),
+        if immediate:
-            )
+            nparties += join_threads
-        # start all threds
+        barrier_start = threading.Barrier(nparties)
+        ev_exec_shutdown = threading.Event()
+        lprocs = [
+            (self._write_msg_thread, write_threads, (q, nb_msgs_w, res_puts,
+                                            when_exec_shutdown, ev_exec_shutdown,
+                                            barrier_start)),
+            (self._read_msg_thread, read_threads, (q, res_gets, barrier_start)),
+            (self._shutdown_thread, 1, (q, res_shutdown, ev_exec_shutdown, immediate)),
+            ]
+        if immediate:
+            lprocs.append((self._join_thread, join_threads, (q, barrier_start)))
+        # start all threads.
         for func, n, args in lprocs:
             for i in range(n):
                 ps.append(threading.Thread(target=func, args=args))
                 ps[-1].start()
-        # set event in order to run q.shutdown()
+        for thread in ps:
-        ev_start.set()
-
-        if not immediate:
-            assert(len(res_gets) == len(res_puts))
-            assert(res_gets.count(True) == res_puts.count(True))
-        else:
-            assert(len(res_gets) <= len(res_puts))
-            assert(res_gets.count(True) <= res_puts.count(True))
-
-        for thread in ps[1:]:
             thread.join()
 
-    @unittest.skip("test times out (gh-115258)")
+        self.assertTrue(True in res_puts)
+        self.assertEqual(res_gets.count(True), read_threads)
+        if immediate:
+            self.assertListEqual(res_shutdown, [True])
+            self.assertTrue(q.empty())
+
     def test_shutdown_all_methods_in_many_threads(self):
         return self._shutdown_all_methods_in_many_threads(False)
 
-    @unittest.skip("test times out (gh-115258)")
     def test_shutdown_immediate_all_methods_in_many_threads(self):
         return self._shutdown_all_methods_in_many_threads(True)