jCdZddlmZddlZddlZddlmZGddeZGddeZ Gd d ejZ d Z d Z esejd k\rddlmZyGddZy)u:module: watchdog.utils :synopsis: Utility classes and functions. :author: yesudeep@google.com (Yesudeep Mangalapilly) :author: contact@tiger-222.fr (Mickaël Schoentgen) Classes ------- .. autoclass:: BaseThread :members: :show-inheritance: :inherited-members: ) annotationsN) TYPE_CHECKINGc eZdZy)UnsupportedLibcN__name__ __module__ __qualname__T/var/www/photos/backend/venv/lib/python3.12/site-packages/watchdog/utils/__init__.pyrr&sr rceZdZdZy)WatchdogShutdownz=Semantic exception used to signal an external shutdown event.N)rr r __doc__r r r rr*sGr rcDeZdZdZdZedZdZdZdZ dZ dZ y ) BaseThreadz1Convenience class for creating stoppable threads.ctjj|t|drd|_n|j dtj |_y)NdaemonT) threadingThread__init__hasattrr setDaemonEvent_stopped_eventselfs r rzBaseThread.__init__1sB!!$' 4 "DK NN4 'oo/r c|jSN)rrs r stopped_eventzBaseThread.stopped_event9s"""r c8|jj S)z6Determines whether the thread should continue running.)ris_setrs r should_keep_runningzBaseThread.should_keep_running=s&&--///r cy)zOverride this method instead of :meth:`stop()`. :meth:`stop()` calls this method. This method is called immediately after the thread is signaled to stop. Nr rs r on_thread_stopzBaseThread.on_thread_stopAr cX|jj|jy)zSignals the thread to stop.N)rsetr%rs r stopzBaseThread.stopHs  ! r cy)zOverride this method instead of :meth:`start()`. :meth:`start()` calls this method. This method is called right before this thread is started and this object's run() method is invoked. Nr rs r on_thread_startzBaseThread.on_thread_startMr&r cb|jtjj|yr)r+rrstartrs r r-zBaseThread.startUs" t$r N) rr r rrpropertyr r#r%r)r+r-r r r rr.s7;0##0   %r rc t|tj|S#t$r}td||d}~wwxYw)z;Imports a module given its name and returns a handle to it.zNo module named N) __import__ ImportErrorsysmodules) module_namees r load_moduler6ZsJC; ;;{ ## C,[M:;BCs =8=c|jd}t|dkrtd|d|d}dj|dd}t |}t ||r t ||Std|d|) aLoads and returns a class definition provided a dotted path specification the last part of the dotted path is the class name and there is at least one module name preceding the class name. Notes ----- You will need to ensure that the module you are trying to load exists in the Python path. Examples -------- - module.name.ClassName # Provided module.name is in the Python path. - module.ClassName # Provided module is in the Python path. What won't work: - ClassName - modle.name.ClassName # Typo in module name. - module.name.ClasNam # Typo in classname. .zDotted module path z+ must contain a module name and a classnameNzModule z does not have class attribute )splitlen ValueErrorjoinr6rgetattrAttributeError) dotted_pathdotted_path_split klass_namer4modules r load_classrEcs*$))#. ".{m;fghh"2&J((,Sb12K  %Fvz"vz** 7;-/Nzl[ \\r ))Protocolc eZdZy)rHNrr r r rHrHsr rH)r __future__rr2rtypingr Exceptionrrrrr6rE version_inforHr r r rNsn" #   i HyH)%!!)%X$!]HC$$.+ r