Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / Python

asyncio.Semaphore

Limite les utilisateurs simultanés d’une ressource via un compteur de permis.

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

Syntaxe

asyncio.Semaphore(value=1)

Limite les utilisateurs simultanés d’une ressource via un compteur de permis.

locked() indique que acquire ne pourrait pas aboutir immédiatement. BoundedSemaphore lève ValueError si release dépasse la capacité initiale. acquire en prend un ou attend à zéro, release en rend un. Une valeur initiale négative lève ValueError. Un release en trop peut augmenter la capacité initiale d’un Semaphore ordinaire.

Avec deux permis les blocs imbriqués donnent 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())

Exemples

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

Résultat

False
True
False

Avec deux permis les blocs imbriqués donnent False, True, False.

Sources