Sha256: d7084eb8a5f4e3a951881eeea16fdc7147e7495d8723c6d81e9d9da7097c276a

Contents?: true

Size: 1.28 KB

Versions: 28

Compression:

Stored size: 1.28 KB

Contents

# frozen_string_literal: true

require_relative '../../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 timer [Puppet::Util::Watcher::Timer] 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 Puppet::FileSystem.exist?)
  def to_str
    @filename
  end

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

Version data entries

28 entries across 28 versions & 1 rubygems

Version Path
puppet-8.10.0 lib/puppet/util/watched_file.rb
puppet-8.10.0-x86-mingw32 lib/puppet/util/watched_file.rb
puppet-8.10.0-x64-mingw32 lib/puppet/util/watched_file.rb
puppet-8.10.0-universal-darwin lib/puppet/util/watched_file.rb
puppet-8.9.0 lib/puppet/util/watched_file.rb
puppet-8.9.0-x86-mingw32 lib/puppet/util/watched_file.rb
puppet-8.9.0-x64-mingw32 lib/puppet/util/watched_file.rb
puppet-8.9.0-universal-darwin lib/puppet/util/watched_file.rb
puppet-8.8.1 lib/puppet/util/watched_file.rb
puppet-8.8.1-x86-mingw32 lib/puppet/util/watched_file.rb
puppet-8.8.1-x64-mingw32 lib/puppet/util/watched_file.rb
puppet-8.8.1-universal-darwin lib/puppet/util/watched_file.rb
puppet-8.7.0 lib/puppet/util/watched_file.rb
puppet-8.7.0-x86-mingw32 lib/puppet/util/watched_file.rb
puppet-8.7.0-x64-mingw32 lib/puppet/util/watched_file.rb
puppet-8.7.0-universal-darwin lib/puppet/util/watched_file.rb
puppet-8.6.0 lib/puppet/util/watched_file.rb
puppet-8.6.0-x86-mingw32 lib/puppet/util/watched_file.rb
puppet-8.6.0-x64-mingw32 lib/puppet/util/watched_file.rb
puppet-8.6.0-universal-darwin lib/puppet/util/watched_file.rb