class EventMachine::FileWatch

This is subclassed from EventMachine::Connection for use with the file monitoring API. Read the documentation on the instance methods of this class, and for a full explanation see EventMachine.watch_file.

Public Instance Methods

file_deleted() click to toggle source

Should be redefined with the user’s custom callback that will be fired when the file is deleted. When the file is deleted, #stop_watching will be called after this to make sure everything is cleaned up correctly.

Note that on linux (with inotify), #file_deleted will not be called until all open file descriptors to the file have been closed.

# File lib/em/file_watch.rb, line 39
def file_deleted
end
file_modified() click to toggle source

Should be redefined with the user’s custom callback that will be fired when the file is modified.

# File lib/em/file_watch.rb, line 30
def file_modified
end
file_moved() click to toggle source

Should be redefined with the user’s custom callback that will be fired when the file is moved or renamed.

# File lib/em/file_watch.rb, line 43
def file_moved
end
path() click to toggle source

Returns the path that EventMachine.watch_file was originally called with. The current implementation does not pick up on the new filename after a rename occurs.

# File lib/em/file_watch.rb, line 25
def path
  @path
end
stop_watching() click to toggle source

Discontinue monitoring of the file. This involves cleaning up the underlying monitoring details with kqueue/inotify, and in turn firing unbind. This will be called automatically when a file is deleted. User code may call it as well.

# File lib/em/file_watch.rb, line 49
def stop_watching
  EventMachine::unwatch_filename(@signature)
end