Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Python

asyncio.Semaphore

Limita gli utenti contemporanei di una risorsa con un contatore di permessi.

Versione: Python 3.14; repository image, production runtime not attested

Sintassi

asyncio.Semaphore(value=1)

Limita gli utenti contemporanei di una risorsa con un contatore di permessi.

locked() indica che acquire non potrebbe completarsi subito. BoundedSemaphore solleva ValueError se release supera la capacità iniziale. acquire ne prende uno oppure attende a zero, release ne restituisce uno. Un valore iniziale negativo solleva ValueError. Un release in eccesso può aumentare la capacità iniziale di un normale Semaphore.

Con due permessi i blocchi annidati danno False, True, False.

import asyncio
async def main():
    s = asyncio.Semaphore(1)
    assert await s.acquire() and s.locked()
    s.release()
    s.release()
    assert await s.acquire() and not s.locked()
    assert await s.acquire() and s.locked()
    try:
        asyncio.Semaphore(-1)
    except ValueError:
        pass
    else:
        raise AssertionError
asyncio.run(main())
import asyncio
async def main():
    b = asyncio.BoundedSemaphore(1)
    assert not b.locked()
    await b.acquire()
    assert b.locked()
    b.release()
    try:
        b.release()
    except ValueError:
        pass
    else:
        raise AssertionError
asyncio.run(main())

Esempi

import asyncio

async def main():
    sem = asyncio.Semaphore(2)
    async with sem:
        print(sem.locked())
        async with sem:
            print(sem.locked())
        print(sem.locked())

asyncio.run(main())

Risultato

False
True
False

Con due permessi i blocchi annidati danno False, True, False.

Fonti