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

CKTIS / Python

asyncio.Lock

Um Lock partilhado reserva um recurso a uma tarefa do ciclo asyncio de cada vez.

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

Sintaxe

async with asyncio.Lock(): ...

Um Lock partilhado reserva um recurso a uma tarefa do ciclo asyncio de cada vez.

O bloqueio não regista proprietário. Cancelar uma tarefa que espera em acquire não liberta um bloqueio já adquirido por outra. As chamadas acquire em espera avançam pela ordem de chegada. async with liberta mesmo após exceção, daí True no bloco e False depois de ValueError. release num bloqueio livre gera RuntimeError.

Não sincroniza threads do sistema.

import asyncio
async def main():
    lock = asyncio.Lock()
    await lock.acquire()
    order = []
    async def take(i):
        async with lock:
            order.append(i)
    a, b = [asyncio.create_task(take(i)) for i in (1, 2)]
    await asyncio.sleep(0)
    lock.release()
    await asyncio.gather(a, b)
    assert order == [1, 2]
    try:
        lock.release()
    except RuntimeError:
        pass
    else:
        raise AssertionError
asyncio.run(main())
import asyncio
async def main():
    l = asyncio.Lock()
    await l.acquire()
    waiting = asyncio.create_task(l.acquire())
    await asyncio.sleep(0)
    waiting.cancel()
    try:
        await waiting
    except asyncio.CancelledError:
        pass
    assert l.locked()
    async def release_elsewhere():
        l.release()
    await asyncio.create_task(release_elsewhere())
    assert not l.locked()
asyncio.run(main())

Exemplos

import asyncio

async def main():
    lock = asyncio.Lock()
    try:
        async with lock:
            print(lock.locked())
            raise ValueError
    except ValueError:
        print(lock.locked())

asyncio.run(main())

Resultado

True
False

Não sincroniza threads do sistema.

Fontes