Class: INotify::Watcher

Inherits:
Object
  • Object
show all
Defined in:
lib/rb-inotify/watcher.rb

Overview

Watchers monitor a single path for changes, specified by event flags. A watcher is usually created via Notifier#watch.

One Notifier may have many Watchers. The Notifier actually takes care of the checking for events, via #run or #process. The main purpose of having Watcher objects is to be able to disable them using #close.

Instance Attribute Summary collapse

Instance Method Summary collapse

Instance Attribute Details

#flags ⇒ Array<Symbol> (readonly)

The flags specifying the events that this Watcher is watching for, and potentially some options as well.

Returns:

  • (Array<Symbol>) 


27
28
29
 
# File 'lib/rb-inotify/watcher.rb', line 27

def flags
  @flags
end

#notifier ⇒ Notifier (readonly)

The Notifier that this Watcher belongs to.

Returns:



15
16
17
 
# File 'lib/rb-inotify/watcher.rb', line 15

def notifier
  @notifier
end

#path ⇒ String (readonly)

The path that this Watcher is watching.

Returns:

  • (String) 


20
21
22
 
# File 'lib/rb-inotify/watcher.rb', line 20

def path
  @path
end

Instance Method Details

#close ⇒ Object

Disables this Watcher, so that it doesn't fire any more events.

Raises:

  • (SystemCallError) —

    if the watch fails to be disabled for some reason



47
48
49
50
51
52
53
54
55
 
# File 'lib/rb-inotify/watcher.rb', line 47

def close
  if Native.inotify_rm_watch(@notifier.fd, @id) == 0
    @notifier.watchers.delete(@id)
    return
  end

  raise SystemCallError.new("Failed to stop watching #{path.inspect}",
                            FFI.errno)
end