From 4e1e887203ef069bf293ecabd945f7567d6a4879 Mon Sep 17 00:00:00 2001 From: "Miss Islington (bot)" <31488909+miss-islington@users.noreply.github.com> Date: Wed, 29 May 2019 11:24:32 -0700 Subject: [PATCH] bpo-36794: Document that Lock.acquire is fair. (GH-13082) MIME-Version: 1.0 Content-Type: text/plain; charset=utf8 Content-Transfer-Encoding: 8bit https://bugs.python.org/issue36794 (cherry picked from commit 34f4f5efea730504216ee19f237734e0bb0104ee) Co-authored-by: Hrvoje Nikšić --- Doc/library/asyncio-sync.rst | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/Doc/library/asyncio-sync.rst b/Doc/library/asyncio-sync.rst index 291310d71414..993bd13fb030 100644 --- a/Doc/library/asyncio-sync.rst +++ b/Doc/library/asyncio-sync.rst @@ -66,6 +66,13 @@ Lock This method waits until the lock is *unlocked*, sets it to *locked* and returns ``True``. + When more than one coroutine is blocked in :meth:`acquire` + waiting for the lock to be unlocked, only one coroutine + eventually proceeds. + + Acquiring a lock is *fair*: the coroutine that proceeds will be + the first coroutine that started waiting on the lock. + .. method:: release() Release the lock. -- 2.47.3