U ꥡc"@sdZddlZddlZddlmZddlmZmZmZm Z ddl m Z m Z m Z mZmZmZmZmZmZmZmZGdddeZGd d d eZGd d d eZdS) a~ :module: watchdog.observers.inotify :synopsis: ``inotify(7)`` based emitter implementation. :author: Sebastien Martini :author: Luke McCarthy :author: yesudeep@google.com (Yesudeep Mangalapilly) :author: Tim Cuthbertson :platforms: Linux 2.6.13+. .. ADMONITION:: About system requirements Recommended minimum kernel version: 2.6.25. Quote from the inotify(7) man page: "Inotify was merged into the 2.6.13 Linux kernel. The required library interfaces were added to glibc in version 2.4. (IN_DONT_FOLLOW, IN_MASK_ADD, and IN_ONLYDIR were only added in version 2.5.)" Therefore, you must ensure the system is running at least these versions appropriate libraries and the kernel. .. ADMONITION:: About recursiveness, event order, and event coalescing Quote from the inotify(7) man page: If successive output inotify events produced on the inotify file descriptor are identical (same wd, mask, cookie, and name) then they are coalesced into a single event if the older event has not yet been read (but see BUGS). The events returned by reading from an inotify file descriptor form an ordered queue. Thus, for example, it is guaranteed that when renaming from one directory to another, events will be produced in the correct order on the inotify file descriptor. ... Inotify monitoring of directories is not recursive: to monitor subdirectories under a directory, additional watches must be created. This emitter implementation therefore automatically adds watches for sub-directories if running in recursive mode. Some extremely useful articles and documentation: .. _inotify FAQ: http://inotify.aiken.cz/?section=inotify&page=faq&lang=en .. _intro to inotify: http://www.linuxjournal.com/article/8478 N) InotifyBuffer) EventEmitter BaseObserverDEFAULT_EMITTER_TIMEOUTDEFAULT_OBSERVER_TIMEOUT) DirDeletedEventDirModifiedEvent DirMovedEventDirCreatedEventFileDeletedEventFileModifiedEventFileMovedEventFileCreatedEventFileClosedEventgenerate_sub_moved_eventsgenerate_sub_created_eventscsFeZdZdZeffdd ZddZddZd d d Zd d Z Z S)InotifyEmitterar inotify(7)-based event emitter. :param event_queue: The event queue to fill with events. :param watch: A watch object representing the directory to monitor. :type watch: :class:`watchdog.observers.api.ObservedWatch` :param timeout: Read events blocking timeout (in seconds). :type timeout: ``float`` cs$t|||t|_d|_dSN)super__init__ threadingLock_lock_inotifyselfZ event_queuewatchtimeout __class__>/tmp/pip-unpacked-wheel-thtqfo2i/watchdog/observers/inotify.pyros zInotifyEmitter.__init__cCs"t|jj}t||jj|_dSr)osfsencoderpathr is_recursiverrr%r!r!r"on_thread_starttszInotifyEmitter.on_thread_startcCs|jr|jd|_dSr)rclose)rr!r!r"on_thread_stopxs zInotifyEmitter.on_thread_stopFc Cs|j|j}|dkr*W5QRdSt|tr|\}}||j}||j}|jr^tnt }| |||| t t j || t t j ||jr|jjrt||D]} | | qW5QRdS||j}|jrr|r|jrtnt }| |d|n|jrtnt}| ||| t t j ||jr |jjr t|D]} | | q\n|jr|jrt nt}| ||np|jr|jrt nt}| ||nF|js|jr|s|jrtnt}| ||| t t j |n|jrX|rX|jr,tnt }| ||d| t t j |n|jr|jrltnt}| ||| t t j |nv|jr|jst}| ||| t t j |n<|j r ||jj kr |jrtnt}| |||!W5QRXdSr)"rrZ read_event isinstancetuple _decode_pathsrc_pathZ is_directoryr rZ queue_eventr r#r%dirnamerr&rZ is_moved_tor rrZ is_attribr Z is_modifyZ is_deleteZ is_moved_fromrr Z is_createZis_close_writerZis_delete_selfstop) rr full_eventseventZ move_fromZmove_tor. dest_pathclsZ sub_eventr!r!r" queue_events}sj        zInotifyEmitter.queue_eventscCst|jjtr|St|S)z?Decode path only if unicode string was passed to this emitter. )r+rr%bytesr#fsdecoder'r!r!r"r-szInotifyEmitter._decode_path)F) __name__ __module__ __qualname____doc__rrr(r*r5r- __classcell__r!r!rr"r_s  >rcs.eZdZdZeffdd ZdddZZS)InotifyFullEmittera inotify(7)-based event emitter. By default this class produces move events even if they are not matched Such move events will have a ``None`` value for the unmatched part. :param event_queue: The event queue to fill with events. :param watch: A watch object representing the directory to monitor. :type watch: :class:`watchdog.observers.api.ObservedWatch` :param timeout: Read events blocking timeout (in seconds). :type timeout: ``float`` cst|||dSr)rrrrr!r"rszInotifyFullEmitter.__init__TcCstj|||ddS)N)r1)rr5)rreventsr!r!r"r5szInotifyFullEmitter.queue_events)T)r8r9r:r;rrr5r<r!r!rr"r=sr=cs&eZdZdZedffdd ZZS)InotifyObserverzi Observer thread that schedules watching directories and dispatches calls to event handlers. Fcs |rtnt}tj||ddS)N)Z emitter_classr)r=rrr)rrZgenerate_full_eventsr4rr!r"rs zInotifyObserver.__init__)r8r9r:r;rrr<r!r!rr"r?sr?)r;r#rZinotify_bufferrZwatchdog.observers.apirrrrZwatchdog.eventsrr r r r r rrrrrrr=r?r!r!r!r"s3 4c