o h?@sdZddlmZddlZddlZddlZddlmZm Z ddl m Z ddl m Z e r0ddlmZdZd Zd Zd Zd Zd ZdZeddGdddZGdddeZGdddeZGdddeZGdddeZGdddeZGdddeZGdd d eZGd!d"d"eZGd#d$d$eZ Gd%d&d&eZ!Gd'd(d(eZ"Gd)d*d*eZ#Gd+d,d,Z$Gd-d.d.e$Z%Gd/d0d0e$Z&Gd1d2d2e$Z'd=d8d9Z(d>d;d<Z)dS)?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:: FileClosedNoWriteEvent :members: :show-inheritance: .. autoclass:: FileOpenedEvent :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: ) annotationsN) dataclassfield) TYPE_CHECKING)match_any_paths) Generatormoveddeletedcreatedmodifiedclosedclosed_no_writeopenedT) unsafe_hashc@sbeZdZUdZded<dZded<edddZded <edddZd ed < edd Z d ed <dS)FileSystemEventaImmutable 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. bytes | strsrc_path dest_pathF)defaultinitstr event_typebool is_directory)r is_syntheticN) __name__ __module__ __qualname____doc____annotations__rrrrrr!r!C/var/www/vscode/kcb/lib/python3.10/site-packages/watchdog/events.pyrhs  rc@eZdZdZeZdS)FileSystemMovedEventz@File system event representing any kind of file system movement.N)rrrrEVENT_TYPE_MOVEDrr!r!r!r"r$~r$c@r#)FileDeletedEventz@File system event representing file deletion on the file system.N)rrrrEVENT_TYPE_DELETEDrr!r!r!r"r'r&r'c@r#)FileModifiedEventzDFile system event representing file modification on the file system.N)rrrrEVENT_TYPE_MODIFIEDrr!r!r!r"r)r&r)c@r#)FileCreatedEventz@File system event representing file creation on the file system.N)rrrrEVENT_TYPE_CREATEDrr!r!r!r"r+r&r+c@seZdZdZdS)FileMovedEventz@File system event representing file movement on the file system.N)rrrrr!r!r!r"r-sr-c@r#)FileClosedEvent=File system event representing file close on the file system.N)rrrrEVENT_TYPE_CLOSEDrr!r!r!r"r.r&r.c@r#)FileClosedNoWriteEventzKFile system event representing an unmodified file close on the file system.N)rrrrEVENT_TYPE_CLOSED_NO_WRITErr!r!r!r"r1r&r1c@r#)FileOpenedEventr/N)rrrrEVENT_TYPE_OPENEDrr!r!r!r"r3r&r3c@eZdZdZeZdZdS)DirDeletedEventzEFile system event representing directory deletion on the file system.TN)rrrrr(rrr!r!r!r"r6r6c@r5)DirModifiedEventzIFile system event representing directory modification on the file system.TN)rrrrr*rrr!r!r!r"r8r7r8c@r5)DirCreatedEventzEFile system event representing directory creation on the file system.TN)rrrrr,rrr!r!r!r"r9r7r9c@seZdZdZdZdS) DirMovedEventzEFile system event representing directory movement on the file system.TN)rrrrrr!r!r!r"r:r&r:c@sjeZdZdZd ddZd dd Zd!d d Zd"ddZd#ddZd$ddZ d%ddZ d&ddZ d'ddZ dS)(FileSystemEventHandlerzBBase file system event handler that you can override methods from.eventrreturnNonecCs$||t|d|j|dS)Dispatches events to the appropriate methods. :param event: The event object representing the file system event. :type event: :class:`FileSystemEvent` on_N) on_any_eventgetattrrselfr<r!r!r"dispatchs zFileSystemEventHandler.dispatchcCdS)zCatch-all event handler. :param event: The event object representing the file system event. :type event: :class:`FileSystemEvent` Nr!rCr!r!r"rAz#FileSystemEventHandler.on_any_eventDirMovedEvent | FileMovedEventcCrF)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` Nr!rCr!r!r"on_movedrGzFileSystemEventHandler.on_moved"DirCreatedEvent | FileCreatedEventcCrF)zCalled when a file or directory is created. :param event: Event representing file/directory creation. :type event: :class:`DirCreatedEvent` or :class:`FileCreatedEvent` Nr!rCr!r!r" on_createdrGz!FileSystemEventHandler.on_created"DirDeletedEvent | FileDeletedEventcCrF)zCalled when a file or directory is deleted. :param event: Event representing file/directory deletion. :type event: :class:`DirDeletedEvent` or :class:`FileDeletedEvent` Nr!rCr!r!r" on_deletedrGz!FileSystemEventHandler.on_deleted$DirModifiedEvent | FileModifiedEventcCrF)zCalled when a file or directory is modified. :param event: Event representing file/directory modification. :type event: :class:`DirModifiedEvent` or :class:`FileModifiedEvent` Nr!rCr!r!r" on_modifiedrGz"FileSystemEventHandler.on_modifiedr.cCrF)zCalled when a file opened for writing is closed. :param event: Event representing file closing. :type event: :class:`FileClosedEvent` Nr!rCr!r!r" on_closedrGz FileSystemEventHandler.on_closedr1cCrF)zCalled when a file opened for reading is closed. :param event: Event representing file closing. :type event: :class:`FileClosedNoWriteEvent` Nr!rCr!r!r"on_closed_no_writerGz)FileSystemEventHandler.on_closed_no_writer3cCrF)zCalled when a file is opened. :param event: Event representing file opening. :type event: :class:`FileOpenedEvent` Nr!rCr!r!r" on_openedrGz FileSystemEventHandler.on_openedNr<rr=r>r<rHr=r>r<rJr=r>r<rLr=r>r<rNr=r>r<r.r=r>r<r1r=r>r<r3r=r>) rrrrrErArIrKrMrOrPrQrRr!r!r!r"r;s   r;csteZdZdZddddddfd d ZedddZedddZedddZedddZ dfdd Z Z S)PatternMatchingEventHandlerzMatches given patterns with file paths associated with occurring events. Uses pathlib's `PurePath.match()` method. `patterns` and `ignore_patterns` are expected to be a list of strings. NF)patternsignore_patternsignore_directoriescase_sensitiver\list[str] | Noner]r^rr_cs&t||_||_||_||_dSN)super__init__ _patterns_ignore_patterns_ignore_directories_case_sensitive)rDr\r]r^r_ __class__r!r"rc*s  z$PatternMatchingEventHandler.__init__r=cC|jS)zD(Read-only) Patterns to allow matching event paths. )rdrDr!r!r"r\9z$PatternMatchingEventHandler.patternscCrj)zE(Read-only) Patterns to ignore matching event paths. )rerkr!r!r"r]@rlz+PatternMatchingEventHandler.ignore_patternscCrjz\(Read-only) ``True`` if directories should be ignored; ``False`` otherwise. rfrkr!r!r"r^Grlz.PatternMatchingEventHandler.ignore_directoriescCrjzu(Read-only) ``True`` if path names should be matched sensitive to case; ``False`` otherwise. rgrkr!r!r"r_Nz*PatternMatchingEventHandler.case_sensitiver<rr>csr|jr|jrdSg}t|dr|t|j|jr$|t|jt||j |j |j dr7t |dSdS)r?Nr)included_patternsexcluded_patternsr_)r^rhasattrappendosfsdecoderrrr\r]r_rbrE)rDr<pathsrhr!r"rEVs  z$PatternMatchingEventHandler.dispatch)r\r`r]r`r^rr_r)r=r`r=rrS) rrrrrcpropertyr\r]r^r_rE __classcell__r!r!rhr"r[$s     r[csteZdZdZddddddfd d ZedddZedddZedddZedddZ dfdd Z Z S) RegexMatchingEventHandlerzfMatches given regexes with file paths associated with occurring events. Uses the `re` module. NF)regexesignore_regexesr^r_r}r`r~r^rr_cst|dur dg}nt|tr|g}|durg}|r.dd|D|_dd|D|_ndd|D|_dd|D|_||_||_dS)Nz.*cSg|]}t|qSr!recompile.0rr!r!r" z6RegexMatchingEventHandler.__init__..cSrr!rrr!r!r"rrcSg|] }t|tjqSr!rr IGNORECASErr!r!r"rcSrr!rrr!r!r"rr)rbrc isinstancer_regexes_ignore_regexesrfrg)rDr}r~r^r_rhr!r"rcus   z"RegexMatchingEventHandler.__init__r=list[re.Pattern[str]]cCrj)zC(Read-only) Regexes to allow matching event paths. )rrkr!r!r"r}rlz!RegexMatchingEventHandler.regexescCrj)zD(Read-only) Regexes to ignore matching event paths. )rrkr!r!r"r~rlz(RegexMatchingEventHandler.ignore_regexescCrjrmrnrkr!r!r"r^rlz,RegexMatchingEventHandler.ignore_directoriescCrjrorprkr!r!r"r_rqz(RegexMatchingEventHandler.case_sensitiver<rr>cs|jr|jrdSgt|drt|j|jr$t|jtfdd|j Dr2dStfdd|j DrFt |dSdS)r?Nrc3$|] }D]}||VqqdSramatchrrprxr!r" "z5RegexMatchingEventHandler.dispatch..c3rrarrrr!r"rr) r^rrtrurvrwrranyr~r}rbrErCrhrr"rEs  z"RegexMatchingEventHandler.dispatch)r}r`r~r`r^rr_r)r=rryrS) rrrrrcrzr}r~r^r_rEr{r!r!rhr"r|ps     r|cseZdZdZddd fdd Zd!fd d Zd"fdd Zd#fdd Zd$fdd Zd%fdd Z d&fdd Z d'fdd Z Z S)(LoggingEventHandlerzLogs all the events captured.N)loggerrlogging.Logger | Noner=r>cst|p tj|_dSra)rbrcloggingrootr)rDrrhr!r"rcs zLoggingEventHandler.__init__r<rHcs4t||jr dnd}|jd||j|jdS)N directoryfilezMoved %s: from %s to %s)rbrIrrinforrrDr<whatrhr!r"rIs zLoggingEventHandler.on_movedrJc0t||jr dnd}|jd||jdS)NrrzCreated %s: %s)rbrKrrrrrrhr!r"rK zLoggingEventHandler.on_createdrLcr)NrrzDeleted %s: %s)rbrMrrrrrrhr!r"rMrzLoggingEventHandler.on_deletedrNcr)NrrzModified %s: %s)rbrOrrrrrrhr!r"rOrzLoggingEventHandler.on_modifiedr.c t||jd|jdS)NzClosed modified file: %s)rbrPrrrrCrhr!r"rP zLoggingEventHandler.on_closedr1cr)NzClosed read file: %s)rbrQrrrrCrhr!r"rQrz&LoggingEventHandler.on_closed_no_writer3cr)NzOpened file: %s)rbrRrrrrCrhr!r"rRrzLoggingEventHandler.on_opened)rrr=r>rTrUrVrWrXrYrZ) rrrrrcrIrKrMrOrPrQrRr{r!r!rhr"rsr src_dir_pathr dest_dir_pathr=)Generator[DirMovedEvent | FileMovedEvent]c cst|D]A\}}}|D]}tj||}|r|||nd}t||ddVq |D]}tj||}|r<|||nd}t||ddVq+qdS)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`. rTrN)rvwalkpathjoinreplacer:r-) rrr directories filenamesr full_path renamed_pathfilenamer!r!r"generate_sub_moved_eventssr-Generator[DirCreatedEvent | FileCreatedEvent]ccsht|D]+\}}}|D]}tj||}t|ddVq |D]}tj||}t|ddVq qdS)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`. TrN)rvrrrr9r+)rrrrrrrr!r!r"generate_sub_created_events s r)rrrrr=r)rrr=r)*r __future__rros.pathrvr dataclassesrrtypingrwatchdog.utils.patternsrcollections.abcrr%r(r,r*r0r2r4rr$r'r)r+r-r.r1r3r6r8r9r:r;r[r|rrrr!r!r!r"sJ Q     WLS /