Queue shutdown

Add a shutdown method to queue class (threading queue, multiprocessing, asyncio) which causes all future puts to raise (a queue.QueueShutdown) and all future gets once the queue is empty to also raise, unblocking all waiters. An optional argument immediate=True will skip the requirement for the queue to be empty.

This will enable producers and consumers to use the queue to know when to stop. This is important because both producers and consumers can be blocked waiting on the queue.

Previous discussion:

• queue termination on Discourse
• #81515

Linked PRs

• gh-96474
• gh-102499
• gh-104225
• gh-104228
• gh-104230
• gh-104750
• gh-115265
• gh-115838
• gh-116699
• gh-117621
• gh-138828

Esamina le pull requests collegate e la precedente discussione sulla terminazione di Queue prima di iniziare, poiché il lavoro è già stato esplorato in diversi punti. Il comportamento richiesto riguarda threading queue, multiprocessing queue e asyncio: l'arresto deve rifiutare i put futuri, sbloccare chi è in attesa e fare in modo che i get sollevino un'eccezione dopo lo svuotamento, con immediate=True che evita lo svuotamento.