V$g?.SrSSKJr SSKrSSKrSSKrSSKJrJ r SSK J r SSK J r \ (aSSKJr SrS rS rS rS rS rSr\"SS9"SS55r"SS\5r"SS\5r"SS\5r"SS\5r"SS\5r"SS\5r"SS \5r"S!S"\5r"S#S$\5r "S%S&\5r!"S'S(\5r""S)S*\5r#"S+S,5r$"S-S.\$5r%"S/S0\$5r&"S1S2\$5r'S5S3jr(S6S4jr)g)7u: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_hashcz\rSrSr%SrS\S'SrS\S'\"SSS9rS \S '\"SSS9r S \S '\"SS 9r S \S'Sr g)FileSystemEventhzImmutable 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____firstlineno____doc____annotations__rrrrr__static_attributes__r1/usr/lib/python3/dist-packages/watchdog/events.pyrrhsQI{BU3J3u59L$9 u-L$-r'rc\rSrSrSr\rSrg)FileSystemMovedEvent~z@File system event representing any kind of file system movement.rN)r r!r"r#r$EVENT_TYPE_MOVEDrr&rr'r(r*r*~s J!Jr'r*c\rSrSrSr\rSrg)FileDeletedEventz@File system event representing file deletion on the file system.rN)r r!r"r#r$EVENT_TYPE_DELETEDrr&rr'r(r.r. J#Jr'r.c\rSrSrSr\rSrg)FileModifiedEventzDFile system event representing file modification on the file system.rN)r r!r"r#r$EVENT_TYPE_MODIFIEDrr&rr'r(r3r3s N$Jr'r3c\rSrSrSr\rSrg)FileCreatedEventz@File system event representing file creation on the file system.rN)r r!r"r#r$EVENT_TYPE_CREATEDrr&rr'r(r7r7r1r'r7c\rSrSrSrSrg)FileMovedEventz@File system event representing file movement on the file system.rN)r r!r"r#r$r&rr'r(r;r;sJr'r;c\rSrSrSr\rSrg)FileClosedEvent=File system event representing file close on the file system.rN)r r!r"r#r$EVENT_TYPE_CLOSEDrr&rr'r(r>r> G"Jr'r>c\rSrSrSr\rSrg)FileClosedNoWriteEventzKFile system event representing an unmodified file close on the file system.rN)r r!r"r#r$EVENT_TYPE_CLOSED_NO_WRITErr&rr'r(rDrDs U+Jr'rDc\rSrSrSr\rSrg)FileOpenedEventr@rN)r r!r"r#r$EVENT_TYPE_OPENEDrr&rr'r(rHrHrBr'rHc \rSrSrSr\rSrSrg)DirDeletedEventzEFile system event representing directory deletion on the file system.TrN) r r!r"r#r$r0rrr&rr'r(rLrLO#JLr'rLc \rSrSrSr\rSrSrg)DirModifiedEventzIFile system event representing directory modification on the file system.TrN) r r!r"r#r$r5rrr&rr'r(rPrPsS$JLr'rPc \rSrSrSr\rSrSrg)DirCreatedEventzEFile system event representing directory creation on the file system.TrN) r r!r"r#r$r9rrr&rr'r(rSrSrNr'rSc\rSrSrSrSrSrg) DirMovedEventzEFile system event representing directory movement on the file system.TrN)r r!r"r#r$rr&rr'r(rVrVs OLr'rVcr\rSrSrSrSSjrSSjrSSjrSSjrSSjr SSjr SS jr SS jr SS jr S rg )FileSystemEventHandlerzBBase file system event handler that you can override methods from.cdURU5 [USUR35"U5 g)Dispatches events to the appropriate methods. :param event: The event object representing the file system event. :type event: :class:`FileSystemEvent` on_N) on_any_eventgetattrrselfevents r(dispatchFileSystemEventHandler.dispatchs/ % E,,-./6r'cg)zCatch-all event handler. :param event: The event object representing the file system event. :type event: :class:`FileSystemEvent` Nrr`s r(r^#FileSystemEventHandler.on_any_eventr'cg)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` Nrr`s r(on_movedFileSystemEventHandler.on_movedrgr'cg)zCalled when a file or directory is created. :param event: Event representing file/directory creation. :type event: :class:`DirCreatedEvent` or :class:`FileCreatedEvent` Nrr`s r( on_created!FileSystemEventHandler.on_createdrgr'cg)zCalled when a file or directory is deleted. :param event: Event representing file/directory deletion. :type event: :class:`DirDeletedEvent` or :class:`FileDeletedEvent` Nrr`s r( on_deleted!FileSystemEventHandler.on_deletedrgr'cg)zCalled when a file or directory is modified. :param event: Event representing file/directory modification. :type event: :class:`DirModifiedEvent` or :class:`FileModifiedEvent` Nrr`s r( on_modified"FileSystemEventHandler.on_modifiedrgr'cg)zCalled when a file opened for writing is closed. :param event: Event representing file closing. :type event: :class:`FileClosedEvent` Nrr`s r( on_closed FileSystemEventHandler.on_closedrgr'cg)zCalled when a file opened for reading is closed. :param event: Event representing file closing. :type event: :class:`FileClosedNoWriteEvent` Nrr`s r(on_closed_no_write)FileSystemEventHandler.on_closed_no_writergr'cg)z|Called when a file is opened. :param event: Event representing file opening. :type event: :class:`FileOpenedEvent` Nrr`s r( on_opened FileSystemEventHandler.on_openedrgr'rNrbrreturnNonerbzDirMovedEvent | FileMovedEventr~rrbz"DirCreatedEvent | FileCreatedEventr~rrbz"DirDeletedEvent | FileDeletedEventr~rrbz$DirModifiedEvent | FileModifiedEventr~rrbr>r~rrbrDr~rrbrHr~r)r r!r"r#r$rcr^rirlrorrrurxr{r&rr'r(rYrYs2L 7        r'rYc^\rSrSrSrSSSSS.S U4Sjjjr\SSj5r\SSj5r\SS j5r \SS j5r SU4S jjr S r U=r $)PatternMatchingEventHandleri$zMatches 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_sensitivecR>[TU]5 XlX lX0lX@lgN)super__init__ _patterns_ignore_patterns_ignore_directories_case_sensitive)rarrrr __class__s r(r$PatternMatchingEventHandler.__init__*s' ! /#5 -r'cUR$)z4(Read-only) Patterns to allow matching event paths. )rras r(r$PatternMatchingEventHandler.patterns9s ~~r'cUR$)z5(Read-only) Patterns to ignore matching event paths. )rrs r(r+PatternMatchingEventHandler.ignore_patterns@s $$$r'cUR$zL(Read-only) ``True`` if directories should be ignored; ``False`` otherwise. rrs r(r.PatternMatchingEventHandler.ignore_directoriesG '''r'cUR$z](Read-only) ``True`` if path names should be matched sensitive to case; ``False`` otherwise. rrs r(r*PatternMatchingEventHandler.case_sensitiveN ###r'c>UR(aUR(ag/n[US5(a/UR[R "UR 55 UR(a/UR[R "UR55 [UURURURS9(a[TU]5U5 gg)r\Nr)included_patternsexcluded_patternsr)rrhasattrappendosfsdecoderrrrrrrrcrarbpathsrs r(rc$PatternMatchingEventHandler.dispatchVs  " "u'9'9  5+ & & LLU__5 6 >> LLU^^4 5  "mm"22..  G U #  r')rrrr)rlist[str] | Nonerrrrrr)r~rr~rr})r r!r"r#r$rpropertyrrrrrcr& __classcell__rs@r(rr$s&*,0#($ .# .* . ! .  . . %% (( $$$$r'rc^\rSrSrSrSSSSS.S U4Sjjjr\SSj5r\SSj5r\SS j5r \SS j5r SU4S jjr S r U=r $)RegexMatchingEventHandleripz^Matches given regexes with file paths associated with occurring events. Uses the `re` module. NF)regexesignore_regexesrrcV>[TU]5 UcS/nO[U[5(aU/nUc/nU(aYUVs/sHn[R "U5PM snUlUVs/sHn[R "U5PM snUlOvUVs/sH(n[R "U[R5PM* snUlUVs/sH(n[R "U[R5PM* snUlX0l X@l gs snfs snfs snfs snf)Nz.*) rr isinstancerrecompile_regexes_ignore_regexes IGNORECASErr)rarrrrrrs r(r"RegexMatchingEventHandler.__init__us  ?gG  % %iG  !N 4;aBJJqM>#JD CJK7aRZZ2==97KDMJX#Y.QBJJq"--$@.#YD #5 - =#JK#Ys D+ D/D!/D&cUR$)z3(Read-only) Regexes to allow matching event paths. )rrs r(r!RegexMatchingEventHandler.regexess }}r'cUR$)z4(Read-only) Regexes to ignore matching event paths. )rrs r(r(RegexMatchingEventHandler.ignore_regexess ###r'cUR$rrrs r(r,RegexMatchingEventHandler.ignore_directoriesrr'cUR$rrrs r(r(RegexMatchingEventHandler.case_sensitiverr'c>^UR(aUR(ag/m[US5(a/TR[R "UR 55 UR(a/TR[R "UR55 [U4SjUR55(ag[U4SjUR55(a[TU]1U5 gg)r\Nrc3X># UHnTHo!RU5v M M! g7frmatch.0rprs r( 5RegexMatchingEventHandler.dispatch..s#F#6a1wwqzzz#6'*c3X># UHnTHo!RU5v M M! g7frrrs r(rrs!?> LLU^^4 5 F4#6#6F F F  ?4<<? ? ? G U # @r')rrrr)rrrrrrrr)r~zlist[re.Pattern[str]]rr})r r!r"r#r$rrrrrrrcr&rrs@r(rrps%)+/#($ .".) . ! .  ..2 $$ (( $$$$r'rc^\rSrSrSrSS.S U4SjjjrSU4SjjrSU4SjjrSU4SjjrSU4S jjr SU4S jjr SU4S jjr SU4S jjr Sr U=r$)LoggingEventHandlerizLogs all the events captured.N)loggerc^>[TU]5 U=(d [RUlgr)rrloggingrootr)rarrs r(rLoggingEventHandler.__init__s ,  r'c>[TU]U5 UR(aSOSnURR SX!R UR 5 g)N directoryfilezMoved %s: from %s to %s)rrirrinforrrarbwhatrs r(riLoggingEventHandler.on_moveds> #00{f 2D..%//Zr'c>[TU]U5 UR(aSOSnURR SX!R 5 g)NrrzCreated %s: %s)rrlrrrrrs r(rlLoggingEventHandler.on_created8 5!#00{f )4@r'c>[TU]U5 UR(aSOSnURR SX!R 5 g)NrrzDeleted %s: %s)rrorrrrrs r(roLoggingEventHandler.on_deletedrr'c>[TU]U5 UR(aSOSnURR SX!R 5 g)NrrzModified %s: %s)rrrrrrrrs r(rrLoggingEventHandler.on_modifieds8 E"#00{f *D..Ar'cp>[TU]U5 URRSUR5 g)NzClosed modified file: %s)rrurrrrarbrs r(ruLoggingEventHandler.on_closeds) %  3U^^Dr'cp>[TU]U5 URRSUR5 g)NzClosed read file: %s)rrxrrrrs r(rx&LoggingEventHandler.on_closed_no_writes) "5) /@r'cp>[TU]U5 URRSUR5 g)NzOpened file: %s)rr{rrrrs r(r{LoggingEventHandler.on_openeds) %  *ENN;r')rzlogging.Logger | Noner~rrrrrrrr)r r!r"r#r$rrirlrorrrurxr{r&rrs@r(rrsA':>--[ A A B E A <$9$I T5IMY9,,]I_aL dK K%"H T4IMY9,,]I_aL tL L" )?sB>Cc## [R"U5HnupnUH.n[RRX5n[ USS9v M0 UH.n[RRX5n[ USS9v M0 Mp g7f)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)rrrrrSr7)rrrrrrrs r(generate_sub_created_eventsr ss)+ (=$9$I T5I!)$? ?%"H T4I"94@ @" )>sB B )rrrrr~z)Generator[DirMovedEvent | FileMovedEvent])rrr~z-Generator[DirCreatedEvent | FileCreatedEvent])*r$ __future__rros.pathrr dataclassesrrtypingrwatchdog.utils.patternsrcollections.abcrr,r0r9r5rArFrJrr*r.r3r7r;r>rDrHrLrPrSrVrYrrrrrrr'r(r siOb# ( 3) . t...*"?"$$ %% $$ K)K#o# ,_, #o#oo( T T nI$"8I$XP$ 6P$f,<0,<^MMM/M6Ar'