CKTIS / Python
asyncio.Queue
Transmet les éléments entre tâches dans l’ordre FIFO.
Version : Python 3.14; repository image, production runtime not attested
Syntaxe
asyncio.Queue(maxsize=0)Transmet les éléments entre tâches dans l’ordre FIFO.
join attend le compteur de travaux inachevés et un task_done en trop lève ValueError. shutdown(immediate=True) peut écarter des éléments non traités. asyncio.wait_for impose un délai. La file ne garantit pas la sûreté entre fils. Avec maxsize<=0 la capacité est illimitée. put attend une place et get des données, les variantes immédiates lèvent QueueFull ou QueueEmpty. Ici 9 est refusé, get renvoie 8 et task_done permet à join de finir.
Depuis 3.13 shutdown normal refuse les dépôts et permet de vider la file.
import asyncio
async def main():
q = asyncio.Queue(maxsize=1)
await q.put(7)
try:
q.put_nowait(8)
except asyncio.QueueFull:
pass
q.shutdown()
assert await q.get() == 7
q.task_done()
await q.join()
try:
await q.get()
except asyncio.QueueShutDown:
pass
else:
raise AssertionError
asyncio.run(main())
import asyncio
async def main():
q = asyncio.Queue()
await q.put(1)
q.shutdown(immediate=True)
await asyncio.wait_for(q.join(), 1)
assert q.empty()
try:
q.task_done()
except ValueError:
pass
else:
raise AssertionError
asyncio.run(main())
Exemples
import asyncio
async def main():
queue = asyncio.Queue(maxsize=1)
await queue.put(8)
try:
queue.put_nowait(9)
except asyncio.QueueFull:
print(queue.full())
print(await queue.get())
queue.task_done()
await queue.join()
asyncio.run(main())
Résultat
True 8
Depuis 3.13 shutdown normal refuse les dépôts et permet de vider la file.