[g=dZddlmZddlZddlZddlZddlmZm Z ddl m Z ddl m Z dZdZd Zd Zd Zd Zed GddZGddeZGddeZGddeZGddeZGddeZGddeZGddeZGdd eZGd!d"eZGd#d$eZGd%d&eZGd'd(Z Gd)d*e Z!Gd+d,e Z"Gd-d.e Z#d/Z$d0Z%y)1um: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:: 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)Optional)match_any_pathsmoveddeletedcreatedmodifiedclosedopenedT) unsafe_hashceZdZUdZded<dZded<eddZded<eddZd ed < ed Z d ed <y )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. strsrc_path dest_pathF)defaultinit event_typebool is_directory)r is_syntheticN) __name__ __module__ __qualname____doc____annotations__rrrrr/lib/python3.12/site-packages/watchdog/events.pyrrosPMIsBU3J3u59L$9 u-L$-r!rceZdZdZeZy)FileSystemMovedEventz@File system event representing any kind of file system movement.N)rrrrEVENT_TYPE_MOVEDrr r!r"r$r$s J!Jr!r$ceZdZdZeZy)FileDeletedEventz@File system event representing file deletion on the file system.N)rrrrEVENT_TYPE_DELETEDrr r!r"r'r' J#Jr!r'ceZdZdZeZy)FileModifiedEventzDFile system event representing file modification on the file system.N)rrrrEVENT_TYPE_MODIFIEDrr r!r"r+r+s N$Jr!r+ceZdZdZeZy)FileCreatedEventz@File system event representing file creation on the file system.N)rrrrEVENT_TYPE_CREATEDrr r!r"r.r.r)r!r.ceZdZdZy)FileMovedEventz@File system event representing file movement on the file system.N)rrrrr r!r"r1r1sJr!r1ceZdZdZeZy)FileClosedEvent=File system event representing file close on the file system.N)rrrrEVENT_TYPE_CLOSEDrr r!r"r3r3 G"Jr!r3ceZdZdZeZy)FileOpenedEventr4N)rrrrEVENT_TYPE_OPENEDrr r!r"r8r8r6r!r8ceZdZdZeZdZy)DirDeletedEventzEFile system event representing directory deletion on the file system.TN)rrrrr(rrr r!r"r;r;O#JLr!r;ceZdZdZeZdZy)DirModifiedEventzIFile system event representing directory modification on the file system.TN)rrrrr,rrr r!r"r>r>sS$JLr!r>ceZdZdZeZdZy)DirCreatedEventzEFile system event representing directory creation on the file system.TN)rrrrr/rrr r!r"r@r@r<r!r@ceZdZdZdZy) DirMovedEventzEFile system event representing directory movement on the file system.TN)rrrrrr r!r"rBrBs OLr!rBcPeZdZdZd dZd dZd dZd dZd dZd dZ d dZ d d Z y ) FileSystemEventHandlerzBBase file system event handler that you can override methods from.c |j| t|jt|jt |j t|jt|jt|ji|j|y)Dispatches events to the appropriate methods. :param event: The event object representing the file system event. :type event: :class:`FileSystemEvent` N) on_any_eventr/ on_createdr( on_deletedr, on_modifiedr%on_movedr5 on_closedr9 on_openedrselfevents r"dispatchzFileSystemEventHandler.dispatchsn %     !1!1 dmm t~~ t~~      " #r!cy)zCatch-all event handler. :param event: The event object representing the file system event. :type event: :class:`FileSystemEvent` Nr rNs r"rGz#FileSystemEventHandler.on_any_eventr!cy)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 rNs r"rKzFileSystemEventHandler.on_movedrSr!cy)zCalled when a file or directory is created. :param event: Event representing file/directory creation. :type event: :class:`DirCreatedEvent` or :class:`FileCreatedEvent` Nr rNs r"rHz!FileSystemEventHandler.on_createdrSr!cy)zCalled when a file or directory is deleted. :param event: Event representing file/directory deletion. :type event: :class:`DirDeletedEvent` or :class:`FileDeletedEvent` Nr rNs r"rIz!FileSystemEventHandler.on_deletedrSr!cy)zCalled when a file or directory is modified. :param event: Event representing file/directory modification. :type event: :class:`DirModifiedEvent` or :class:`FileModifiedEvent` Nr rNs r"rJz"FileSystemEventHandler.on_modifiedrSr!cy)zCalled when a file opened for writing is closed. :param event: Event representing file closing. :type event: :class:`FileClosedEvent` Nr rNs r"rLz FileSystemEventHandler.on_closedrSr!cy)zCalled when a file is opened. :param event: Event representing file opening. :type event: :class:`FileOpenedEvent` Nr rNs r"rMz FileSystemEventHandler.on_openedrSr!NrPrreturnNone) rrrrrQrGrKrHrIrJrLrMr r!r"rDrDs-L#$       r!rDcxeZdZdZ dfd ZedZedZedZedZ d fd Z xZ S) PatternMatchingEventHandlerz Matches 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. cZt|||_||_||_||_yN)super__init__ _patterns_ignore_patterns_ignore_directories_case_sensitive)rOpatternsignore_patternsignore_directoriescase_sensitive __class__s r"rbz$PatternMatchingEventHandler.__init__*s/ ! /#5 -r!c|jS)zD(Read-only) Patterns to allow matching event paths. )rcrOs r"rgz$PatternMatchingEventHandler.patterns8s ~~r!c|jS)zE(Read-only) Patterns to ignore matching event paths. )rdrms r"rhz+PatternMatchingEventHandler.ignore_patterns?s $$$r!c|jSz\(Read-only) ``True`` if directories should be ignored; ``False`` otherwise. rerms r"riz.PatternMatchingEventHandler.ignore_directoriesF '''r!c|jSzu(Read-only) ``True`` if path names should be matched sensitive to case; ``False`` otherwise. rfrms r"rjz*PatternMatchingEventHandler.case_sensitiveM ###r!c|jr |jryg}t|dr.|jt j |j |jr.|jt j |jt||j|j|jrt|5|yy)rFNr)included_patternsexcluded_patternsrj)rirhasattrappendosfsdecoderrrrgrhrjrarQrOrPpathsrks r"rQz$PatternMatchingEventHandler.dispatchUs  " "u'9'9  5+ & LLU__5 6 >> LLU^^4 5  "mm"22..  G U #  r!NNFFrZ) rrrrrbpropertyrgrhrirjrQ __classcell__rks@r"r^r^#su  . %% (( $$$$r!r^cxeZdZdZ dfd ZedZedZedZedZ d fd Z xZ S) RegexMatchingEventHandlerzk Matches given regexes with file paths associated with occurring events. Uses the `re` module. c"t||dg}nt|tr|g}|g}|rQ|Dcgc]}t j |c}|_|Dcgc]}t j |c}|_nn|Dcgc]&}t j |tj(c}|_|Dcgc]&}t j |tj(c}|_||_ ||_ ycc}wcc}wcc}wcc}w)Nz.*) rarb isinstancerrecompile_regexes_ignore_regexes IGNORECASErerf)rOregexesignore_regexesrirjrrks r"rbz"RegexMatchingEventHandler.__init__us  ?gG  %iG  !N 4;aBJJqM>#JD CJK7aRZZ2==97KDMJX#Y.QBJJq"--$@.#YD #5 - =#JK#YsC=D+D;+D c|jS)zC(Read-only) Regexes to allow matching event paths. )rrms r"rz!RegexMatchingEventHandler.regexess }}r!c|jS)zD(Read-only) Regexes to ignore matching event paths. )rrms r"rz(RegexMatchingEventHandler.ignore_regexess ###r!c|jSrprqrms r"riz,RegexMatchingEventHandler.ignore_directoriesrrr!c|jSrtrurms r"rjz(RegexMatchingEventHandler.case_sensitivervr!c|jr |jrygt|dr.jt j |j |jr.jt j |jtfd|jDrytfd|jDrt|1|yy)rFNrc3NK|]}D]}|j|ywr`match.0rprs r" z5RegexMatchingEventHandler.dispatch..s$F#6a1qwwqzz#6"%c3NK|]}D]}|j|ywr`rrs r"rz5RegexMatchingEventHandler.dispatch..s"?> LLU^^4 5 F4#6#6F F  ?4<<? ? G U # @r!rrZ) rrrrrbrrrrirjrQrrs@r"rrosu  .0 $$ (( $$$$r!rcneZdZdZd d fd Zd fd Zd fd Zd fd Zd fd Zd fd Z d fd Z xZ S) LoggingEventHandlerzLogs all the events captured.cTt||xstj|_yr`)rarbloggingrootlogger)rOrrks r"rbzLoggingEventHandler.__init__s ,  r!ct|||jrdnd}|jj d||j |j y)N directoryfilezMoved %s: from %s to %s)rarKrrinforrrOrPwhatrks r"rKzLoggingEventHandler.on_moveds@ #00{f 2D%..%//Zr!ct|||jrdnd}|jj d||j y)NrrzCreated %s: %s)rarHrrrrrs r"rHzLoggingEventHandler.on_created: 5!#00{f )4@r!ct|||jrdnd}|jj d||j y)NrrzDeleted %s: %s)rarIrrrrrs r"rIzLoggingEventHandler.on_deletedrr!ct|||jrdnd}|jj d||j y)NrrzModified %s: %s)rarJrrrrrs r"rJzLoggingEventHandler.on_modifieds: E"#00{f *D%..Ar!cpt|||jjd|jy)NzClosed file: %s)rarLrrrrOrPrks r"rLzLoggingEventHandler.on_closed) %  *ENN;r!cpt|||jjd|jy)NzOpened file: %s)rarMrrrrs r"rMzLoggingEventHandler.on_openedrr!r`)rzOptional[logging.Logger]r[r\rZ) rrrrrbrKrHrIrJrLrMrrs@r"rrs2'-[ A A B < <$k9$I T95IMY9,,]LI_aL idK K%"H T84IMY9,,]LI_aL ytL L" )?sB:B<c#Ktj|D]n\}}}|D]/}ttjj ||d1|D]/}t tjj ||d1pyw)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)r|rr@rrr.)rrrrrrs r"generate_sub_created_eventsrsn)+ (=$k9$I!"'',,tY"?dS S%!H"277<<h#?dS S")>sBB )&r __future__rros.pathr|r dataclassesrrtypingrwatchdog.utils.patternsrr%r(r/r,r5r9rr$r'r+r.r1r3r8r;r>r@rBrDr^rrrrr r!r"rs4 KZ# (3  t...*"?"$$ %% $$ K)K#o# #o#oo( R R jI$"8I$XP$ 6P$f'<0'