"d@dZddlmZddlZddlZddlZddlmZdZ dZ dZ dZ d Z d ZGd d ZGd deZGddeZGddeZGddeZGddeZGddeZGddeZGddeZGddeZGdd eZGd!d"eZGd#d$ZGd%d&eZGd'd(eZGd)d*eZd+Zd,Z y)-un :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)match_any_pathsmoveddeletedcreatedmodifiedclosedopenedcfeZdZdZdZ dZ dZ dZedZ dZ dZ edZ d Z d Zd Zy ) 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. Fc||_yN _src_path)selfsrc_paths 1/usr/lib/python3/dist-packages/watchdog/events.py__init__zFileSystemEvent.__init__s !c|jS)z@Source path of the file system object that triggered this event.rrs rrzFileSystemEvent.src_paths~~rc"|jSr)__repr__rs r__str__zFileSystemEvent.__str__s}}rc dt|jd|jd|jd|jd S)N)type__name__ event_typer is_directoryrs rrzFileSystemEvent.__repr__sIT ##$M$//1BC (8I8I7J! M rcH|j|j|jfSr)r"rr#rs rkeyzFileSystemEvent.keys0A0ABBrc4|j|jk(Srr%revents r__eq__zFileSystemEvent.__eq__xx599$$rc4|j|jk7Srr'r(s r__ne__zFileSystemEvent.__ne__r+rc,t|jSr)hashr%rs r__hash__zFileSystemEvent.__hash__sDHH~rN)r! __module__ __qualname____doc__r"r# is_syntheticrpropertyrrrr%r*r-r0rrr r nskJ,LEL" CC%%rr cLeZdZdZeZfdZedZedZ dZ xZ S)FileSystemMovedEventzJ File system event representing any kind of file system movement. c2t||||_yr)superr _dest_path)rr dest_path __class__s rrzFileSystemMovedEvent.__init__s "#rc|jS)z'The destination path of the move event.)r;rs rr<zFileSystemMovedEvent.dest_pathsrc^|j|j|j|jfSr)r"rr<r#rs rr%zFileSystemMovedEvent.keys#@Q@QRRrc dt|jd|jd|jd|jd S)Nrz : src_path=z , dest_path=rr)r r!rr<r#rs rrzFileSystemMovedEvent.__repr__sIT ##$K /@A*/$:K:K9LA O r) r!r1r2r3EVENT_TYPE_MOVEDr"rr5r<r%r __classcell__r=s@rr8r8sC"J$ SS rr8ceZdZdZeZy)FileDeletedEventz@File system event representing file deletion on the file system.N)r!r1r2r3EVENT_TYPE_DELETEDr"r6rrrErE J#JrrEceZdZdZeZy)FileModifiedEventzDFile system event representing file modification on the file system.N)r!r1r2r3EVENT_TYPE_MODIFIEDr"r6rrrIrIs N$JrrIceZdZdZeZy)FileCreatedEventz@File system event representing file creation on the file system.N)r!r1r2r3EVENT_TYPE_CREATEDr"r6rrrLrLrGrrLceZdZdZy)FileMovedEventz@File system event representing file movement on the file system.N)r!r1r2r3r6rrrOrOsJrrOceZdZdZeZy)FileClosedEvent=File system event representing file close on the file system.N)r!r1r2r3EVENT_TYPE_CLOSEDr"r6rrrQrQ G"JrrQceZdZdZeZy)FileOpenedEventrRN)r!r1r2r3EVENT_TYPE_OPENEDr"r6rrrVrVrTrrVceZdZdZeZdZy)DirDeletedEventzEFile system event representing directory deletion on the file system.TN)r!r1r2r3rFr"r#r6rrrYrYO#JLrrYceZdZdZeZdZy)DirModifiedEventzS File system event representing directory modification on the file system. TN)r!r1r2r3rJr"r#r6rrr\r\s%JLrr\ceZdZdZeZdZy)DirCreatedEventzEFile system event representing directory creation on the file system.TN)r!r1r2r3rMr"r#r6rrr^r^rZrr^ceZdZdZdZy) DirMovedEventzEFile system event representing directory movement on the file system.TN)r!r1r2r3r#r6rrr`r`s OLrr`c@eZdZdZdZdZdZdZdZdZ dZ d Z y ) FileSystemEventHandlerzL Base 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_eventrM on_createdrF on_deletedrJ on_modifiedrAon_movedrS on_closedrW on_openedr"r(s rdispatchzFileSystemEventHandler.dispatch sn %     !1!1 dmm t~~ t~~      " #rcy)zCatch-all event handler. :param event: The event object representing the file system event. :type event: :class:`FileSystemEvent` Nr6r(s rrez#FileSystemEventHandler.on_any_eventrcy)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` Nr6r(s rrizFileSystemEventHandler.on_moved&rnrcy)zCalled when a file or directory is created. :param event: Event representing file/directory creation. :type event: :class:`DirCreatedEvent` or :class:`FileCreatedEvent` Nr6r(s rrfz!FileSystemEventHandler.on_created/rnrcy)zCalled when a file or directory is deleted. :param event: Event representing file/directory deletion. :type event: :class:`DirDeletedEvent` or :class:`FileDeletedEvent` Nr6r(s rrgz!FileSystemEventHandler.on_deleted8rnrcy)zCalled when a file or directory is modified. :param event: Event representing file/directory modification. :type event: :class:`DirModifiedEvent` or :class:`FileModifiedEvent` Nr6r(s rrhz"FileSystemEventHandler.on_modifiedArnrcy)zCalled when a file opened for writing is closed. :param event: Event representing file closing. :type event: :class:`FileClosedEvent` Nr6r(s rrjz FileSystemEventHandler.on_closedJrnrcy)zCalled when a file is opened. :param event: Event representing file opening. :type event: :class:`FileOpenedEvent` Nr6r(s rrkz FileSystemEventHandler.on_openedSrnrN) r!r1r2r3rlrerirfrgrhrjrkr6rrrbrbs/#$       rrbcveZdZdZ dfd ZedZedZedZedZ fdZ xZ S) PatternMatchingEventHandlerzR Matches given patterns with file paths associated with occurring events. cZt|||_||_||_||_yr)r:r _patterns_ignore_patterns_ignore_directories_case_sensitive)rpatternsignore_patternsignore_directoriescase_sensitiver=s rrz$PatternMatchingEventHandler.__init__bs/ ! /#5 -rc|jS)zM (Read-only) Patterns to allow matching event paths. )rxrs rr|z$PatternMatchingEventHandler.patternsps ~~rc|jS)zN (Read-only) Patterns to ignore matching event paths. )ryrs rr}z+PatternMatchingEventHandler.ignore_patternsxs $$$rc|jSze (Read-only) ``True`` if directories should be ignored; ``False`` otherwise. rzrs rr~z.PatternMatchingEventHandler.ignore_directories '''rc|jSz~ (Read-only) ``True`` if path names should be matched sensitive to case; ``False`` otherwise. r{rs rrz*PatternMatchingEventHandler.case_sensitive###rc|jr |jryg}t|dr.|jt j |j |jr.|jt j |jt||j|j|jrt|5|yy)rdNr<)included_patternsexcluded_patternsr)r~r#hasattrappendosfsdecoder<rrr|r}rr:rlrr)pathsr=s rrlz$PatternMatchingEventHandler.dispatchs  " "u'9'9  5+ & LLU__5 6 >> LLU^^4 5  "mm"22..  G U #  rNNFF) r!r1r2r3rr5r|r}r~rrlrBrCs@rrvrv]su   .%%(($$$$rrvcveZdZdZ dfd ZedZedZedZedZ fdZ xZ S) RegexMatchingEventHandlerzQ Matches given regexes with file paths associated with occurring events. 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.*) r:r isinstancestrrecompile_regexes_ignore_regexesIrzr{)rregexesignore_regexesr~rrr=s rrz"RegexMatchingEventHandler.__init__s  ?gG  %iG  !N 4;z5RegexMatchingEventHandler.dispatch..s%FaF1qwwqzFzF"%c3NK|]}D]}|j|ywrrrs rrz5RegexMatchingEventHandler.dispatch..s%?a?Aqwwqz?z?r) r~r#rrrrr<ranyrrr:rlrs @rrlz"RegexMatchingEventHandler.dispatchs  " "u'9'9  5+ & LLU__5 6 >> LLU^^4 5 F4#6#6F F  ?4<<? ? G U # @rr) r!r1r2r3rr5rrr~rrlrBrCs@rrrsu   .0$$(($$$$rrcLeZdZdZdfd ZfdZfdZfdZfdZxZ S)LoggingEventHandlerzLogs all the events captured.cTt||xstj|_yr)r:rloggingrootlogger)rrr=s rrzLoggingEventHandler.__init__s ,  rct|||jrdnd}|jj d||j |j y)N directoryfilezMoved %s: from %s to %s)r:rir#rinforr<rr)whatr=s rrizLoggingEventHandler.on_moved sB #00{f  %tU^^U__ rct|||jrdnd}|jj d||j y)NrrzCreated %s: %s)r:rfr#rrrrs rrfzLoggingEventHandler.on_created: 5!#00{f )4@rct|||jrdnd}|jj d||j y)NrrzDeleted %s: %s)r:rgr#rrrrs rrgzLoggingEventHandler.on_deletedrrct|||jrdnd}|jj d||j y)NrrzModified %s: %s)r:rhr#rrrrs rrhzLoggingEventHandler.on_modifieds: E"#00{f *D%..Arr) r!r1r2r3rrirfrgrhrBrCs@rrrs('-  A A BBrrc#Ktj|D]\}}}|D]O}tjj||}|r|j ||nd}t ||}d|_|Q|D]O} tjj|| }|r|j ||nd}t||} d| _| Qyw)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)rwalkpathjoinreplacer`r4rO) src_dir_path dest_dir_pathr directories filenamesr full_path renamed_pathdir_moved_eventfilenamefile_moved_events rgenerate_sub_moved_eventsr$s)+ (>#$k9$ "I T95IBN !!->TX ,L)DO+/O (! ! "" #H T84IBN !!->TX  .lIF ,0  )" " ##sCC c#4Ktj|D]|\}}}|D]6}ttjj ||}d|_|8|D]6}t tjj ||}d|_|8~yw)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)rrr^rrr4rL)rrrrrdir_created_eventrfile_created_events rgenerate_sub_created_eventsrDs)+ (=%$k9$ $I / T90M N -1  *# # $" %H!1"'',,tX2N!O .2  +$ $ % %sBB)!r3 __future__rros.pathrrwatchdog.utils.patternsrrArFrMrJrSrWr r8rErIrLrOrQrVrYr\r^r`rbrvrrrrr6rrrs L\# 3 44n ? >$$ %% $$ K)K#o# #o#oo( T T nK$"8K$\S$ 6S$l B0 BF#@%r