Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Python

asyncio.Semaphore

Limita os utilizadores simultâneos de um recurso com um contador de permissões.

Versão: Python 3.14; repository image, production runtime not attested

Sintaxe

asyncio.Semaphore(value=1)

Limita os utilizadores simultâneos de um recurso com um contador de permissões.

locked() indica que acquire não poderia concluir imediatamente. BoundedSemaphore gera ValueError se release ultrapassar a capacidade inicial. acquire retira uma ou espera a zero e release repõe uma. Um valor inicial negativo gera ValueError. Um release a mais pode aumentar a capacidade inicial de um Semaphore normal.

Com duas permissões os blocos aninhados dão 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())

Exemplos

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())

Resultado

False
True
False

Com duas permissões os blocos aninhados dão False, True, False.

Fontes