o h @sdZddlmZddlZddlZddlmZer$ddlmZddl m Z Gddde Z Gd d d e Z Gd d d ejZdddZdddZdS)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_CHECKING) ModuleType)Trickc@s eZdZdS)UnsupportedLibcErrorN)__name__ __module__ __qualname__r r K/var/www/vscode/kcb/lib/python3.10/site-packages/watchdog/utils/__init__.pyrsrc@seZdZdZdS)WatchdogShutdownErrorz=Semantic exception used to signal an external shutdown event.N)rrr __doc__r r r r r sr c@sZeZdZdZdddZedddZdd d Zdd d ZdddZ dddZ dddZ dS) BaseThreadz1Convenience class for creating stoppable threads.returnNonecCs6tj|t|drd|_n|dt|_dS)NdaemonT) threadingThread__init__hasattrr setDaemonEvent_stopped_eventselfr r r r&s   zBaseThread.__init__threading.EventcCs|jSN)rrr r r stopped_event.szBaseThread.stopped_eventboolcCs |j S)z6Determines whether the thread should continue running.)ris_setrr r r should_keep_running2s zBaseThread.should_keep_runningcCdS)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 rr r r on_thread_stop6zBaseThread.on_thread_stopcCs|j|dS)zSignals the thread to stop.N)rsetr"rr r r stop=s  zBaseThread.stopcCr!)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 rr r r on_thread_startBr#zBaseThread.on_thread_startcCs|tj|dSr)r&rrstartrr r r r'JszBaseThread.startN)rr)rr)rr) rrr r rpropertyrr r"r%r&r'r r r r r#s      r module_namestrrrc CsDzt|Wnty}z d|}t||d}~wwtj|S)z;Imports a module given its name and returns a handle to it.zNo module named N) __import__ ImportErrorsysmodules)r)eerrorr r r load_moduleOs    r1 dotted_path type[Trick]cCsx|d}t|dkrd|d}t||d}d|dd}t|}t||r0t||Sd|d|}t|) 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 ValueErrorjoinr1rgetattrAttributeError)r2dotted_path_splitr0 klass_namer)moduler r r load_classYs     r@)r)r*rr)r2r*rr3)r __future__rr-rtypingrtypesrwatchdog.tricksr Exceptionrr rrr1r@r r r r s     ,