$g dZddlmZddlZddlZddlmZer ddlmZddl m Z Gdde Z Gd d e Z Gd d ejZddZddZdS)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)TrickceZdZdS)UnsupportedLibcErrorN)__name__ __module__ __qualname__W/var/www/html/netbox-4.1.3/venv/lib/python3.11/site-packages/watchdog/utils/__init__.pyrrsDr rceZdZdZdS)WatchdogShutdownErrorz=Semantic exception used to signal an external shutdown event.N)r r r __doc__r r rrrsGGGGr rcZeZdZdZddZeddZddZdd Zdd Z dd Z dd Z d S) BaseThreadz1Convenience class for creating stoppable threads.returnNonectj|t|drd|_n|dtj|_dS)NdaemonT) threadingThread__init__hasattrr setDaemonEvent_stopped_eventselfs rrzBaseThread.__init__&s\!!$''' 4 " " !DKK NN4 'o//r threading.Eventc|jSN)rrs r stopped_eventzBaseThread.stopped_event.s ""r boolc6|j S)z6Determines whether the thread should continue running.)ris_setrs rshould_keep_runningzBaseThread.should_keep_running2s&--////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. Nr rs ron_thread_stopzBaseThread.on_thread_stop6r c`|j|dS)zSignals the thread to stop.N)rsetr*rs rstopzBaseThread.stop=s/ !!! r cdS)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 ron_thread_startzBaseThread.on_thread_startBr+r cl|tj|dSr#)r0rrstartrs rr2zBaseThread.startJs1 t$$$$$r N)rr)rr!)rr%) r r r rrpropertyr$r(r*r.r0r2r r rrr#s;;0000###X#0000         %%%%%%r r module_namestrrrc t|n'#t$r}d|}t||d}~wwxYwtj|S)z;Imports a module given its name and returns a handle to it.zNo module named N) __import__ ImportErrorsysmodules)r4eerrors r load_moduler=Osc(; (((0;00%  a'( ;{ ##s 616 dotted_path type[Trick]cR|d}t|dkrd|d}t||d}d|dd}t |}t ||rt ||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 ValueErrorjoinr=rgetattrAttributeError)r>dotted_path_splitr< klass_namer4modules r load_classrMYs*$))#.. ""^k^^^"2&J((,SbS122K  % %Fvz""+vz*** Nk N N* N NE   r )r4r5rr)r>r5rr?)r __future__rr9rtypingrtypesrwatchdog.tricksr Exceptionrrrrr=rMr r rrSs2  #"""""  &      %%%%%%     9   HHHHHIHHH)%)%)%)%)%!)%)%)%X$$$$! ! ! ! ! ! r