CKTIS / Python
asyncio.Semaphore
Begrenzt gleichzeitige Nutzer einer Ressource durch einen Zähler für Berechtigungen.
Version: Python 3.14; repository image, production runtime not attested
Syntax
asyncio.Semaphore(value=1)Begrenzt gleichzeitige Nutzer einer Ressource durch einen Zähler für Berechtigungen.
locked() zeigt, dass acquire nicht sofort gelingen kann. BoundedSemaphore löst bei release über die Anfangskapazität hinaus ValueError aus. acquire nimmt eine oder wartet bei null, release gibt eine zurück. Ein negativer Anfangswert löst ValueError aus. Beim normalen Semaphore kann ein überzähliges release die Anfangskapazität erhöhen.
Mit zwei Berechtigungen ergeben die verschachtelten Blöcke 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())
Beispiele
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())
Ergebnis
False True False
Mit zwei Berechtigungen ergeben die verschachtelten Blöcke False, True, False.