zcdZddlZddlZGddeZGddeZGddejZd Zd Z dS) 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: NceZdZdS)UnsupportedLibcN)__name__ __module__ __qualname__7lib/python3.11/site-packages/watchdog/utils/__init__.pyrr%sDr rceZdZdZdS)WatchdogShutdownzG Semantic exception used to signal an external shutdown event. N)rrr__doc__rr r r r )s Dr r cLeZdZdZdZedZdZdZdZ dZ dZ d S) BaseThreadz3 Convenience class for creating stoppable threads. c(tj|t|drd|_n|dtj|_t|jds|jj|j_ dSdS)NdaemonTis_set) threadingThread__init__hasattrr setDaemonEvent_stopped_eventisSetrselfs r rzBaseThread.__init__3s!!$''' 4 " " !DKK NN4 'o//t*H55 C)-)<)BD  & & & C Cr c|jSN)rrs r stopped_eventzBaseThread.stopped_event>s ""r c6|j S)z6Determines whether the thread should continue running.)rrrs r should_keep_runningzBaseThread.should_keep_runningBs&--////r cdS)zOverride this method instead of :meth:`stop()`. :meth:`stop()` calls this method. This method is called immediately after the thread is signaled to stop. Nrrs r on_thread_stopzBaseThread.on_thread_stopFs r c`|j|dS)zSignals the thread to stop.N)rsetr#rs r stopzBaseThread.stopNs/ !!! r cdS)uOverride 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. Nrrs r on_thread_startzBaseThread.on_thread_startSs  r cl|tj|dSr)r(rrstartrs r r*zBaseThread.start\s1 t$$$$$r N) rrrr rpropertyrr!r#r&r(r*rr r rr0s== C C C##X#000       %%%%%r rc t|n #t$rtd|zwxYwtj|S)z;Imports a module given its name and returns a handle to it.zNo module named %s) __import__ ImportErrorsysmodules) module_names r load_moduler2asT>; >>>.<===> ;{ ##s/cL|d}t|dkrk|d}d|dd}t|}t ||rt ||}|St d|d|td|z)akLoads 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. .NzModule z does not have class attribute z@Dotted module path %s must contain a module name and a classname)splitlenjoinr2rgetattrAttributeError ValueError) dotted_pathdotted_path_split klass_namer1moduleklasss r load_classrBjs$$))#.. !^&r* hh0"566 [)) 6: & & ;FJ//EL!.!,jj":;; ; NQ\ \^^ ^r ) r r/r Exceptionrr rrr2rBrr r rDs&        i        y   .%.%.%.%.%!.%.%.%b$$$"^"^"^"^"^r