ó õ^‚Rc@sPdZddlmZedddƒ[ddlmZdd d„ƒYZd S( sJMutual exclusion -- for use with module sched A mutex has two pieces of state -- a 'locked' bit and a queue. When the mutex is not locked, the queue is empty. Otherwise, the queue contains 0 or more (function, argument) pairs representing functions (or methods) waiting to acquire the lock. When the mutex is unlocked while the queue is not empty, the first queue entry is removed and its function(argument) pair called, implying it now has the lock. Of course, no multi-threading is implied -- hence the funny interface for lock, where a function is called once the lock is aquired. iÿÿÿÿ(twarnpy3ks/the mutex module has been removed in Python 3.0t stackleveli(tdequetmutexcBs5eZd„Zd„Zd„Zd„Zd„ZRS(cCst|_tƒ|_dS(s)Create a new mutex -- initially unlocked.N(tFalsetlockedRtqueue(tself((s/usr/lib/python2.7/mutex.pyt__init__s cCs|jS(s!Test the locked bit of the mutex.(R(R((s/usr/lib/python2.7/mutex.pyttestscCs|jst|_tStSdS(s[Atomic test-and-set -- grab the lock if it is not set, return True if it succeeded.N(RtTrueR(R((s/usr/lib/python2.7/mutex.pyt testandsets  cCs3|jƒr||ƒn|jj||fƒdS(s¦Lock a mutex, call the function with supplied argument when it is acquired. If the mutex is already locked, place function and argument in the queue.N(R Rtappend(Rtfunctiontargument((s/usr/lib/python2.7/mutex.pytlock's  cCs8|jr+|jjƒ\}}||ƒn t|_dS(s]Unlock a mutex. If the queue is not empty, call the next function with its argument.N(RtpopleftRR(RR R((s/usr/lib/python2.7/mutex.pytunlock0s  (t__name__t __module__RR R RR(((s/usr/lib/python2.7/mutex.pyRs    N((t__doc__twarningsRt collectionsRR(((s/usr/lib/python2.7/mutex.pyt s