class INotify::Notifier
notifier.run
# Nothing happens until you run the notifier!
end
puts “#{event.name} is no longer in the directory!”
# The #name field of the event object contains the name of the affected file
notifier.watch(“path/to/directory”, :delete, :moved_from) do |event|
# or moved out of the directory.
# Watch for any file in the directory being deleted
end
puts “Foo.txt was accessed!”
notifier.watch(“path/to/foo.txt”, :access) do
# Run this callback whenever the file path/to/foo.txt is read
notifier = INotify::Notifier.new
# Create the notifier
@example
but usually unnecessary.
It’s possible to have more than one instance,
Notifier wraps a single instance of inotify.
def close
-
(SystemCallError)
- if closing the underlying file descriptor fails.
def close stop @handle.close @watchers.clear end
def fd
-
(Fixnum)
-
def fd @handle.fileno end
def initialize
-
(SystemCallError)
- if inotify failed to initialize for some reason
Returns:
-
(Notifier)
-
def initialize @running = Mutex.new @pipe = IO.pipe # JRuby shutdown sometimes runs IO finalizers before all threads finish. if RUBY_ENGINE == 'jruby' @pipe[0].autoclose = false @pipe[1].autoclose = false end @watchers = {} fd = Native.inotify_init unless fd < 0 @handle = IO.new(fd) @handle.autoclose = false if RUBY_ENGINE == 'jruby' return end raise SystemCallError.new( "Failed to initialize inotify" + case FFI.errno when Errno::EMFILE::Errno; ": the user limit on the total number of inotify instances has been reached." when Errno::ENFILE::Errno; ": the system limit on the total number of file descriptors has been reached." when Errno::ENOMEM::Errno; ": insufficient kernel memory is available." else; "" end, FFI.errno) end
def process
- See: #run -
def process read_events.each do |event| event.callback! event.flags.include?(:ignored) && event.notifier.watchers.delete(event.watcher_id) end end
def read_events
This can return an empty list if the watcher was closed elsewhere.
objects.
has watchers registered for. Once there are events, returns their {Event}
Blocks until there are one or more filesystem events that this notifier
def read_events size = Native::Event.size + Native.fpathconf(fd, Native::Flags::PC_NAME_MAX) + 1 tries = 1 begin data = readpartial(size) rescue SystemCallError => er # EINVAL means that there's more data to be read # than will fit in the buffer size raise er unless er.errno == Errno::EINVAL::Errno && tries < 5 size *= 2 tries += 1 retry end return [] if data.nil? events = [] cookies = {} while event = Event.consume(data, self) events << event next if event.cookie == 0 cookies[event.cookie] ||= [] cookies[event.cookie] << event end cookies.each {|c, evs| evs.each {|ev| ev.related.replace(evs - [ev]).freeze}} events end
def readpartial(size)
def readpartial(size) readable, = select([@handle, @pipe.first]) return nil if readable.include?(@pipe.first) @handle.readpartial(size) rescue Errno::EBADF # If the IO has already been closed, reading from it will cause # Errno::EBADF. nil end
def run
- See: #process -
def run @running.synchronize do Thread.current[:INOTIFY_RUN_THREAD] = true @stop = false process until @stop end ensure Thread.current[:INOTIFY_RUN_THREAD] = false end
def stop
That is, if we're in a \{#run} loop,
Stop watching for filesystem events.
def stop @stop = true @pipe.last.write "." unless Thread.current[:INOTIFY_RUN_THREAD] @running.synchronize do # no-op: we just needed to wait until the lock was available end end end
def to_io
-
(NotImplementedError)
- if this is being called in JRuby
Returns:
-
(IO)
- An IO object wrapping the file descriptor
def to_io @handle end
def watch(path, *flags, &callback)
-
(SystemCallError)
- if the file or directory can't be watched,
Returns:
-
(Watcher)
- A Watcher set up to watch this path for these events
Other tags:
- Yieldparam: event - The Event object containing information
Other tags:
- Yield: - A block that will be called
Parameters:
-
flags
(Array
) -- Which events to watch for -
path
(String
) -- The path to the file or directory
def watch(path, *flags, &callback) return Watcher.new(self, path, *flags, &callback) unless flags.include?(:recursive) dir = Dir.new(path) dir.each do |base| d = File.join(path, base) binary_d = d.respond_to?(:force_encoding) ? d.dup.force_encoding('BINARY') : d next if binary_d =~ /\/\.\.?$/ # Current or parent directory next if RECURSIVE_BLACKLIST.include?(d) next if flags.include?(:dont_follow) && File.symlink?(d) next if !File.directory?(d) watch(d, *flags, &callback) end dir.close rec_flags = [:create, :moved_to] return watch(path, *((flags - [:recursive]) | rec_flags)) do |event| callback.call(event) if flags.include?(:all_events) || !(flags & event.flags).empty? next if (rec_flags & event.flags).empty? || !event.flags.include?(:isdir) begin watch(event.absolute_name, *flags, &callback) rescue Errno::ENOENT # If the file has been deleted since the glob was run, we don't want to error out. end end end