Sha256: f2f86166a350be06c43c3ce2d68205c66025489e438d9851dcaf62b56ef5b104

Contents?: true

Size: 1.2 KB

Versions: 8

Compression:

Stored size: 1.2 KB

Contents

require 'puppet/util/watcher'

# Monitor a given file for changes on a periodic interval. Changes are detected
# by looking for a change in the file ctime.
class Puppet::Util::WatchedFile
  # @!attribute [r] filename
  #   @return [String] The fully qualified path to the file.
  attr_reader :filename

  # @param filename [String] The fully qualified path to the file.
  # @param file_timeout [Integer] The polling interval for checking for file
  #   changes. Setting the timeout to a negative value will treat the file as
  #   always changed. Defaults to `Puppet[:filetimeout]`
  def initialize(filename, timer = Puppet::Util::Watcher::Timer.new(Puppet[:filetimeout]))
    @filename = filename
    @timer = timer

    @info = Puppet::Util::Watcher::PeriodicWatcher.new(
      Puppet::Util::Watcher::Common.file_ctime_change_watcher(@filename),
      timer)
  end

  # @return [true, false] If the file has changed since it was last checked.
  def changed?
    @info.changed?
  end

  # Allow this to be used as the name of the file being watched in various
  # other methods (such as File.exist?)
  def to_str
    @filename
  end

  def to_s
    "<WatchedFile: filename = #{@filename}, timeout = #{@timer.timeout}>"
  end
end

Version data entries

8 entries across 8 versions & 1 rubygems

Version Path
puppet-3.3.2 lib/puppet/util/watched_file.rb
puppet-3.3.1 lib/puppet/util/watched_file.rb
puppet-3.3.1.rc3 lib/puppet/util/watched_file.rb
puppet-3.3.1.rc2 lib/puppet/util/watched_file.rb
puppet-3.3.1.rc1 lib/puppet/util/watched_file.rb
puppet-3.3.0 lib/puppet/util/watched_file.rb
puppet-3.3.0.rc3 lib/puppet/util/watched_file.rb
puppet-3.3.0.rc2 lib/puppet/util/watched_file.rb