From: Victor Stinner Date: Thu, 26 Feb 2015 09:39:16 +0000 (+0100) Subject: asyncio doc: lock classes are not thread safe X-Git-Tag: v3.5.0a2~85^2 X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=7b2c3c6840052ea6f8b41253faf38b9e24f9a453;p=thirdparty%2FPython%2Fcpython.git asyncio doc: lock classes are not thread safe --- diff --git a/Doc/library/asyncio-sync.rst b/Doc/library/asyncio-sync.rst index f53c7d0808ca..622ff5fd66dc 100644 --- a/Doc/library/asyncio-sync.rst +++ b/Doc/library/asyncio-sync.rst @@ -54,6 +54,8 @@ Lock Locks also support the context management protocol. ``(yield from lock)`` should be used as context manager expression. + This class is :ref:`not thread safe `. + Usage:: lock = Lock() @@ -117,6 +119,8 @@ Event method. The :meth:`wait` method blocks until the flag is true. The flag is initially false. + This class is :ref:`not thread safe `. + .. method:: clear() Reset the internal flag to false. Subsequently, coroutines calling @@ -160,6 +164,8 @@ Condition object, and it is used as the underlying lock. Otherwise, a new :class:`Lock` object is created and used as the underlying lock. + This class is :ref:`not thread safe `. + .. coroutinemethod:: acquire() Acquire the underlying lock. @@ -252,6 +258,8 @@ Semaphore defaults to ``1``. If the value given is less than ``0``, :exc:`ValueError` is raised. + This class is :ref:`not thread safe `. + .. coroutinemethod:: acquire() Acquire a semaphore. @@ -279,8 +287,8 @@ BoundedSemaphore .. class:: BoundedSemaphore(value=1, \*, loop=None) - A bounded semaphore implementation. Inherit from :class:`Semaphore`. + A bounded semaphore implementation. Inherit from :class:`Semaphore`. - This raises :exc:`ValueError` in :meth:`~Semaphore.release` if it would - increase the value above the initial value. + This raises :exc:`ValueError` in :meth:`~Semaphore.release` if it would + increase the value above the initial value.