zcj?dZddlZddlZddlZddlmZdZdZdZ dZ dZ Gd d Z Gd d e Z Gd de ZGdde ZGdde ZGdde ZGdde ZGdde ZGdde ZGdde ZGdde ZGdd ZGd!d"eZGd#d$eZGd%d&eZd'Zd(ZdS))u+ :module: watchdog.events :synopsis: File system events and event handlers. :author: yesudeep@google.com (Yesudeep Mangalapilly) :author: contact@tiger-222.fr (Mickaël Schoentgen) Event Classes ------------- .. autoclass:: FileSystemEvent :members: :show-inheritance: :inherited-members: .. autoclass:: FileSystemMovedEvent :members: :show-inheritance: .. autoclass:: FileMovedEvent :members: :show-inheritance: .. autoclass:: DirMovedEvent :members: :show-inheritance: .. autoclass:: FileModifiedEvent :members: :show-inheritance: .. autoclass:: DirModifiedEvent :members: :show-inheritance: .. autoclass:: FileCreatedEvent :members: :show-inheritance: .. autoclass:: FileClosedEvent :members: :show-inheritance: .. autoclass:: DirCreatedEvent :members: :show-inheritance: .. autoclass:: FileDeletedEvent :members: :show-inheritance: .. autoclass:: DirDeletedEvent :members: :show-inheritance: Event Handler Classes --------------------- .. autoclass:: FileSystemEventHandler :members: :show-inheritance: .. autoclass:: PatternMatchingEventHandler :members: :show-inheritance: .. autoclass:: RegexMatchingEventHandler :members: :show-inheritance: .. autoclass:: LoggingEventHandler :members: :show-inheritance: N)match_any_pathsmoveddeletedcreatedmodifiedclosedcteZdZdZdZ dZ dZ dZedZ dZ dZ edZ d Z d Zd ZdS) FileSystemEventa  Immutable type that represents a file system event that is triggered when a change occurs on the monitored file system. All FileSystemEvent objects are required to be immutable and hence can be used as keys in dictionaries or be added to sets. NFc||_dSN _src_path)selfsrc_paths /lib/python3.11/site-packages/watchdog/events.py__init__zFileSystemEvent.__init__s !c|jS)z@Source path of the file system object that triggered this event.r rs rrzFileSystemEvent.src_paths ~rc*|Sr )__repr__rs r__str__zFileSystemEvent.__str__s}}rc`dt|jj|j|j|jzS)Nza<%(class_name)s: event_type=%(event_type)s, src_path=%(src_path)r, is_directory=%(is_directory)s>) class_name event_typer is_directory)dict __class____name__rrrrs rrzFileSystemEvent.__repr__s=1 $ 7 $"m"&"3 5556 6rc*|j|j|jfSr )rrrrs rkeyzFileSystemEvent.keys0ABBrc"|j|jkSr r!revents r__eq__zFileSystemEvent.__eq__x59$$rc"|j|jkSr r#r$s r__ne__zFileSystemEvent.__ne__r'rc*t|jSr )hashr!rs r__hash__zFileSystemEvent.__hash__sDH~~r)r __module__ __qualname____doc__rr is_syntheticrpropertyrrrr!r&r)r,rrr r isJ,LEL"""X666CCXC%%%%%%rr cXeZdZdZeZfdZedZedZ dZ xZ S)FileSystemMovedEventzJ File system event representing any kind of file system movement. cXt|||_dSr )superr _dest_path)rr dest_pathrs rrzFileSystemMovedEvent.__init__s& """#rc|jS)z'The destination path of the move event.)r7rs rr8zFileSystemMovedEvent.dest_paths rc6|j|j|j|jfSr )rrr8rrs rr!zFileSystemMovedEvent.keys@QRRrc`dt|jj|j|j|jzS)Nz_<%(class_name)s: src_path=%(src_path)r, dest_path=%(dest_path)r, is_directory=%(is_directory)s>)rrr8r)rrrrr8rrs rrzFileSystemMovedEvent.__repr__s<1T^%<#'=$(N'+'8:::; ;r) rr-r.r/EVENT_TYPE_MOVEDrrr1r8r!r __classcell__rs@rr4r4s"J$$$$$X SSXS;;;;;;;rr4ceZdZdZeZdS)FileDeletedEventz@File system event representing file deletion on the file system.N)rr-r.r/EVENT_TYPE_DELETEDrr2rrr@r@JJ#JJJrr@ceZdZdZeZdS)FileModifiedEventzDFile system event representing file modification on the file system.N)rr-r.r/EVENT_TYPE_MODIFIEDrr2rrrDrDsNN$JJJrrDceZdZdZeZdS)FileCreatedEventz@File system event representing file creation on the file system.N)rr-r.r/EVENT_TYPE_CREATEDrr2rrrGrGrBrrGceZdZdZdS)FileMovedEventz@File system event representing file movement on the file system.N)rr-r.r/r2rrrJrJsJJJJrrJceZdZdZeZdS)FileClosedEventz=File system event representing file close on the file system.N)rr-r.r/EVENT_TYPE_CLOSEDrr2rrrLrLsGG"JJJrrLceZdZdZeZdZdS)DirDeletedEventzEFile system event representing directory deletion on the file system.TN)rr-r.r/rArrr2rrrOrOOO#JLLLrrOceZdZdZeZdZdS)DirModifiedEventzS File system event representing directory modification on the file system. TN)rr-r.r/rErrr2rrrRrRs$%JLLLrrRceZdZdZeZdZdS)DirCreatedEventzEFile system event representing directory creation on the file system.TN)rr-r.r/rHrrr2rrrTrTrPrrTceZdZdZdZdS) DirMovedEventzEFile system event representing directory movement on the file system.TN)rr-r.r/rr2rrrVrVsOOLLLrrVc<eZdZdZdZdZdZdZdZdZ dZ d S) FileSystemEventHandlerzL Base file system event handler that you can override methods from. c || t|jt|jt |jt|jt|j i|j |dS)Dispatches events to the appropriate methods. :param event: The event object representing the file system event. :type event: :class:`FileSystemEvent` N) on_any_eventrH on_createdrA on_deletedrE on_modifiedr<on_movedrM on_closedrr$s rdispatchzFileSystemEventHandler.dispatchsq %       !1 dm t~      "  # # # # #rcdS)zCatch-all event handler. :param event: The event object representing the file system event. :type event: :class:`FileSystemEvent` Nr2r$s rr[z#FileSystemEventHandler.on_any_eventrcdS)zCalled when a file or a directory is moved or renamed. :param event: Event representing file/directory movement. :type event: :class:`DirMovedEvent` or :class:`FileMovedEvent` Nr2r$s rr_zFileSystemEventHandler.on_moved!rcrcdS)zCalled when a file or directory is created. :param event: Event representing file/directory creation. :type event: :class:`DirCreatedEvent` or :class:`FileCreatedEvent` Nr2r$s rr\z!FileSystemEventHandler.on_created*rcrcdS)zCalled when a file or directory is deleted. :param event: Event representing file/directory deletion. :type event: :class:`DirDeletedEvent` or :class:`FileDeletedEvent` Nr2r$s rr]z!FileSystemEventHandler.on_deleted3rcrcdS)zCalled when a file or directory is modified. :param event: Event representing file/directory modification. :type event: :class:`DirModifiedEvent` or :class:`FileModifiedEvent` Nr2r$s rr^z"FileSystemEventHandler.on_modified<rcrcdS)zCalled when a file opened for writing is closed. :param event: Event representing file closing. :type event: :class:`FileClosedEvent` Nr2r$s rr`z FileSystemEventHandler.on_closedErcrN) rr-r.r/rar[r_r\r]r^r`r2rrrXrXs###"                    rrXceZdZdZ d fd ZedZedZedZedZ fd Z xZ S) PatternMatchingEventHandlerzR Matches given patterns with file paths associated with occurring events. NFct||_||_||_||_dSr )r6r _patterns_ignore_patterns_ignore_directories_case_sensitive)rpatternsignore_patternsignore_directoriescase_sensitivers rrz$PatternMatchingEventHandler.__init__Ts> ! /#5 -rc|jS)zM (Read-only) Patterns to allow matching event paths. )rlrs rrpz$PatternMatchingEventHandler.patterns]s ~rc|jS)zN (Read-only) Patterns to ignore matching event paths. )rmrs rrqz+PatternMatchingEventHandler.ignore_patternses $$rc|jSze (Read-only) ``True`` if directories should be ignored; ``False`` otherwise. rnrs rrrz.PatternMatchingEventHandler.ignore_directoriesm ''rc|jSz~ (Read-only) ``True`` if path names should be matched sensitive to case; ``False`` otherwise. rors rrsz*PatternMatchingEventHandler.case_sensitiveu ##rc|jr |jrdSg}t|dr,|t j|j|jr,|t j|jt||j |j |j r#t |dSdS)rZNr8)included_patternsexcluded_patternsrs)rrrhasattrappendosfsdecoder8rrrprqrsr6rarr%pathsrs rraz$PatternMatchingEventHandler.dispatch~s  " u'9  F 5+ & & 7 LLU_55 6 6 6 > 6 LLU^44 5 5 5 5-1]-1-A*.*= ? ? ? $ GG  U # # # # #  $ $rNNFF) rr-r.r/rr1rprqrrrsrar=r>s@rrjrjOs7;:?......X%%X%((X($$X$$$$$$$$$$rrjceZdZdZ d fd ZedZedZedZedZ fd Z xZ S) RegexMatchingEventHandlerzQ Matches given regexes with file paths associated with occurring events. NFc6t|dg}nt|tr|g}|g}|r#d|D|_d|D|_n"d|D|_d|D|_||_||_dS)Nz.*c6g|]}tj|Sr2recompile.0rs r z6RegexMatchingEventHandler.__init__..s <<.s #J#J#JaBJqMM#J#J#JrcLg|]!}tj|tj"Sr2rrIrs rrz6RegexMatchingEventHandler.__init__..s&BBBQRZ2400BBBrcLg|]!}tj|tj"Sr2rrs rrz6RegexMatchingEventHandler.__init__..s&#P#P#PABJq"$$7$7#P#P#Pr)r6r isinstancestr_regexes_ignore_regexesrnro)rregexesignore_regexesrrrsrs rrz"RegexMatchingEventHandler.__init__s   gGG  % % iG  N  Q<#J#J#JD BB'BBBDM#P#P#P#P#PD #5 -rc|jS)zL (Read-only) Regexes to allow matching event paths. )rrs rrz!RegexMatchingEventHandler.regexess }rc|jS)zM (Read-only) Regexes to ignore matching event paths. )rrs rrz(RegexMatchingEventHandler.ignore_regexess ##rc|jSrwrxrs rrrz,RegexMatchingEventHandler.ignore_directoriesryrc|jSr{r|rs rrsz(RegexMatchingEventHandler.case_sensitiver}rc|jr |jrdSgt|dr,t j|j|jr,t j|jtfd|j DrdStfd|j Dr#t |dSdS)rZNr8c3LK|]}D]}||VdSr matchrrprs r z5RegexMatchingEventHandler.dispatch..s:FFaFF1qwwqzzFFFFFFFrc3LK|]}D]}||VdSr rrs rrz5RegexMatchingEventHandler.dispatch..s:??a??Aqwwqzz???????r) rrrrrrrr8ranyrrr6rars @rraz"RegexMatchingEventHandler.dispatchs  " u'9  F 5+ & & 7 LLU_55 6 6 6 > 6 LLU^44 5 5 5 FFFF4#6FFF F F  F ????4<??? ? ? $ GG  U # # # # # $ $rr) rr-r.r/rr1rrrrrsrar=r>s@rrrs59:?......&X$$X$((X($$X$$$$$$$$$$rrcLeZdZdZdfd ZfdZfdZfdZfdZxZ S) LoggingEventHandlerzLogs all the events captured.Ncnt|p tj|_dSr )r6rloggingrootlogger)rrrs rrzLoggingEventHandler.__init__s+ ,  rct||jrdnd}|jd||j|jdS)N directoryfilezMoved %s: from %s to %s)r6r_rrinforr8rr%whatrs rr_zLoggingEventHandler.on_moveds^ #0<{{f 2D%. * * * * *rct||jrdnd}|jd||jdS)NrrzCreated %s: %s)r6r\rrrrrs rr\zLoggingEventHandler.on_createdO 5!!!#0<{{f )4@@@@@rct||jrdnd}|jd||jdS)NrrzDeleted %s: %s)r6r]rrrrrs rr]zLoggingEventHandler.on_deletedrrct||jrdnd}|jd||jdS)NrrzModified %s: %s)r6r^rrrrrs rr^zLoggingEventHandler.on_modifiedsO E"""#0<{{f *D%.AAAAArr ) rr-r.r/rr_r\r]r^r=r>s@rrrs''------ *****AAAAA AAAAA BBBBBBBBBrrc#Ktj|D]\}}}|D]W}tj||}|r|||nd}t ||}d|_|VX|D]W} tj|| }|r|||nd}t||}d|_|VXdS)aGenerates an event list of :class:`DirMovedEvent` and :class:`FileMovedEvent` objects for all the files and directories within the given moved directory that were moved along with the directory. :param src_dir_path: The source path of the moved directory. :param dest_dir_path: The destination path of the moved directory. :returns: An iterable of file system events of type :class:`DirMovedEvent` and :class:`FileMovedEvent`. NT)rwalkpathjoinreplacerVr0rJ) src_dir_path dest_dir_pathr directories filenamesr full_path renamed_pathr%filenames rgenerate_sub_moved_eventsr s)+ (>(>  $k9$  I T955IMYc9,,]LIII_cL!, ::E!%E KKKK!  H T844IMYc9,,]LIII_cL"<;;E!%E KKKK    rc#4Ktj|D]\}}}|D]:}ttj||}d|_|V;|D]:}t tj||}d|_|V;dS)aGenerates an event list of :class:`DirCreatedEvent` and :class:`FileCreatedEvent` objects for all the files and directories within the given moved directory that were moved along with the directory. :param src_dir_path: The source path of the created directory. :returns: An iterable of file system events of type :class:`DirCreatedEvent` and :class:`FileCreatedEvent`. TN)rrrTrrr0rG)rrrrrr%rs rgenerate_sub_created_eventsr%s)+ (=(=$k9$  I#BGLLy$A$ABBE!%E KKKK!  H$RW\\$%A%ABBE!%E KKKK  r)r/os.pathrrrwatchdog.utils.patternsrr<rArHrErMr r4r@rDrGrJrLrOrRrTrVrXrjrrrrr2rrrs.$HHT 333333 88888888v;;;;;?;;;D$$$$$$$$ %%%%%%%% $$$$$$$$ KKKKK)KKK#####o###oo( J J J J J J J J ZD$D$D$D$D$"8D$D$D$NN$N$N$N$N$ 6N$N$N$bBBBBB0BBBD8r