Server : Apache/2.4.41 (Ubuntu) System : Linux absol.cf 5.4.0-198-generic #218-Ubuntu SMP Fri Sep 27 20:18:53 UTC 2024 x86_64 User : www-data ( 33) PHP Version : 7.4.33 Disable Function : pcntl_alarm,pcntl_fork,pcntl_waitpid,pcntl_wait,pcntl_wifexited,pcntl_wifstopped,pcntl_wifsignaled,pcntl_wifcontinued,pcntl_wexitstatus,pcntl_wtermsig,pcntl_wstopsig,pcntl_signal,pcntl_signal_get_handler,pcntl_signal_dispatch,pcntl_get_last_error,pcntl_strerror,pcntl_sigprocmask,pcntl_sigwaitinfo,pcntl_sigtimedwait,pcntl_exec,pcntl_getpriority,pcntl_setpriority,pcntl_async_signals,pcntl_unshare, Directory :  /var/lib/gems/2.5.0/gems/eventmachine-le-1.1.7/lib/em/

Upload File : current_dir [ Writeable ] document_root [ Writeable ]

module EventMachine
  # Utility class that is useful for file monitoring. Supported events are
  #
  # * File is modified
  # * File is deleted
  # * File is moved
  #
  # @note On Mac OS X, file watching only works when kqueue is enabled
  #
  # @see EventMachine.watch_file
  class FileWatch < Connection
    # @private
    Cmodified = 'modified'.freeze
    # @private
    Cdeleted = 'deleted'.freeze
    # @private
    Cmoved = 'moved'.freeze


    # @private
    def receive_data(data)
      case data
      when Cmodified
        file_modified
      when Cdeleted
        file_deleted
      when Cmoved
        file_moved
      end
    end

    # Returns the path that is being monitored.
    #
    # @note Current implementation does not pick up on the new filename after a rename occurs.
    #
    # @return [String]
    # @see EventMachine.watch_file
    def path
      @path
    end

    # Will be called when the file is modified. Supposed to be redefined by subclasses.
    #
    # @abstract
    def file_modified
    end

    # Will be called when the file is deleted. Supposed to be redefined by subclasses.
    # When the file is deleted, stop_watching will be called after this to make sure everything is
    # cleaned up correctly.
    #
    # @note On Linux (with {http://en.wikipedia.org/wiki/Inotify inotify}), this method will not be called until *all* open file descriptors to
    #       the file have been closed.
    #
    # @abstract
    def file_deleted
    end

    # Will be called when the file is moved or renamed. Supposed to be redefined by subclasses.
    #
    # @abstract
    def file_moved
    end

    # Discontinue monitoring of the file.
    #
    # This involves cleaning up the underlying monitoring details with kqueue/inotify, and in turn firing {EventMachine::Connection#unbind}.
    # This will be called automatically when a file is deleted. User code may call it as well.
    def stop_watching
      EventMachine::unwatch_filename(@signature)
    end # stop_watching
  end # FileWatch
end # EventMachine