MhZddlZddlZGddeZGddeZdZdZdS)NcZeZdZdZejZdZdZdZ dZ dZ dZ dZ dZdS) Singletona A base class for a class of a singleton object. For any derived class T, the first invocation of T() will create the instance, and any future invocations of T() will return that instance. Concurrent invocations of T() from different threads are safe. Nc|ddr-t|t|zdks Jd|js|j>|j5|jt j|_dddn #1swxYwY|jsf|j5|js@t||_|j d|_ dddn #1swxYwY|jS)NsharedFrz\Cannot use constructor arguments when accessing a Singleton without specifying shared=False.cdSN)argskwargss X/var/www/html/test/jupyter/venv/lib/python3.11/site-packages/debugpy/common/singleton.pyz#Singleton.__new__..=st) getlen _instance_lock _lock_lock threadingRLockobject__new____init__)clsr r s r rzSingleton.__new__ s ::h.. 3t99s6{{3Jq2P2P2P '3Q2P2P} Dy ^66y($-O$5$5 666666666666666 = DYDD=D(.s(;(;  ..000'C'C DDDDDDDDDDDDDDD}s% BB  B AC22C69C6c|dd}|5|r5t|jdus Jddt|_nt|j JdddddS#1swxYwYdS)aIInitializes the singleton instance. Guaranteed to only be invoked once for any given type derived from Singleton. If shared=False, the caller is requesting a singleton instance for their own exclusive use. This is only allowed if the singleton has not been created yet; if so, it is created and marked as being in exclusive use. While it is marked as such, all attempts to obtain an existing instance of it immediately raise an exception. The singleton can eventually be promoted to shared use by calling share() on it. rTFz%Cannot access a non-shared Singleton.NzSingleton is already created.)poptype _is_shared)selfr r rs r rzSingleton.__init__AsHd++  V V VJJ)666:766(,T %%Dzz,446U444 V V V V V V V V V V V V V V V V V VsAA<<BBcRt|j|S)z1Lock this singleton to prevent concurrent access.)rracquirers r __enter__zSingleton.__enter__Ws" T   """ rcRt|jdS)z1Unlock this singleton to allow concurrent access.N)rrrelease)rexc_type exc_valueexc_tbs r __exit__zSingleton.__exit__\s# T   """""rc.dt|_dS)zEShare this singleton, if it was originally created with shared=False.TN)rrr!s r sharezSingleton.share`s $T r)__name__ __module__ __qualname____doc__rrrrrrrrr"r(r*r rr rr s!""J EIJBVVV, ###%%%%%rrcpeZdZdZeZ eZ fdZedZ dZ dZ xZ S)ThreadSafeSingletonaZA singleton that incorporates a lock for thread-safe access to its members. The lock can be acquired using the context manager protocol, and thus idiomatic use is in conjunction with a with-statement. For example, given derived class T:: with T() as t: t.x = t.frob(t.y) All access to the singleton from the outside should follow this pattern for both attributes and method calls. Singleton members can assume that self is locked by the caller while they're executing, but recursive locking of the same singleton on the same thread is also permitted. ctj|i|tt|jt|_dSr)superrsetrreadonly_attrs)rr r __class__s r rzThreadSafeSingleton.__init__sD$)&)))$'T (A$B$BT !!!rct|j}|ds Jd|dS)NF)blockingzThreadSafeSingleton accessed without locking. Either use with-statement, or if it is a method or property, mark it as @threadsafe_method or with @autolocked_method, as appropriate.)rrr r$)rlocks r assert_lockedz!ThreadSafeSingleton.assert_lockedsRDzz||U|++   2   rct||}|t|jt|jzvr+t |ddst ||S)Nis_threadsafe_methodF)r__getattribute__rthreadsafe_attrsr4getattrr0r9rnamevalues r r<z$ThreadSafeSingleton.__getattribute__sg''d33 T 3d4jj6OO P P5"8%@@ 8#11$777 rc|t|jvs Jd|t|jvrt|t |||S)NzThis attribute is read-only.)rr4r=r0r9r __setattr__r?s r rCzThreadSafeSingleton.__setattr__se4::44446T444 tDzz2 2 2  - -d 3 3 3!!$e444r) r+r,r-r. frozensetr=r4r staticmethodr9r<rC __classcell__)r5s@r r0r0es  !y{{ Y[[NCCCCC\5555555rr0cd|_|S)zMarks a method of a ThreadSafeSingleton-derived class as inherently thread-safe. A method so marked must either not use any singleton state, or lock it appropriately. T)r;)funcs r threadsafe_methodrIs !%D Krc`tjtfd}|S)zAutomatically synchronizes all calls of a method of a ThreadSafeSingleton-derived class by locking the singleton for the duration of each call. cT|5|g|Ri|cdddS#1swxYwYdSrr )rr r rHs r lock_and_callz(autolocked_method..lock_and_calls / /4.t...v.. / / / / / / / / / / / / / / / / / /s !!) functoolswrapsrI)rHrLs` r autolocked_methodrOsF _T///// r)rMrrrr0rIrOr rr rPs Y%Y%Y%Y%Y%Y%Y%Y%x<5<5<5<5<5)<5<5<5~     r