puppet-retrospec 1.5.0 → 1.6.0

data/vendor/gems/puppet-4.5.2/lib/puppet/type/file/checksum.rb

@@ -1,43 +0,0 @@
-require 'puppet/util/checksums'
-
-# Specify which checksum algorithm to use when checksumming
-# files.
-Puppet::Type.type(:file).newparam(:checksum) do
-  include Puppet::Util::Checksums
-
-  desc "The checksum type to use when determining whether to replace a file's contents.
-
-    The default checksum type is md5."
-
-  newvalues "md5", "md5lite", "sha256", "sha256lite", "mtime", "ctime", "none"
-
-  defaultto do
-    Puppet[:digest_algorithm].to_sym
-  end
-
-  def sum(content)
-    type = digest_algorithm()
-    "{#{type}}" + send(type, content)
-  end
-
-  def sum_file(path)
-    type = digest_algorithm()
-    method = type.to_s + "_file"
-    "{#{type}}" + send(method, path).to_s
-  end
-
-  def sum_stream(&block)
-    type = digest_algorithm()
-    method = type.to_s + "_stream"
-    checksum = send(method, &block)
-    "{#{type}}#{checksum}"
-  end
-
-  private
-
-  # Return the appropriate digest algorithm with fallbacks in case puppet defaults have not
-  # been initialized.
-  def digest_algorithm
-    value || Puppet[:digest_algorithm].to_sym
-  end
-end

data/vendor/gems/puppet-4.5.2/lib/puppet/type/file/content.rb

@@ -1,160 +0,0 @@
-require 'net/http'
-require 'uri'
-require 'tempfile'
-
-require 'puppet/util/checksums'
-require 'puppet/type/file/data_sync.rb'
-
-module Puppet
-  Puppet::Type.type(:file).newproperty(:content) do
-    include Puppet::Util::Checksums
-    include Puppet::DataSync
-
-    attr_reader :actual_content
-
-    desc <<-'EOT'
-      The desired contents of a file, as a string. This attribute is mutually
-      exclusive with `source` and `target`.
-
-      Newlines and tabs can be specified in double-quoted strings using
-      standard escaped syntax --- \n for a newline, and \t for a tab.
-
-      With very small files, you can construct content strings directly in
-      the manifest...
-
-          define resolve(nameserver1, nameserver2, domain, search) {
-              $str = "search ${search}
-                  domain ${domain}
-                  nameserver ${nameserver1}
-                  nameserver ${nameserver2}
-                  "
-
-              file { '/etc/resolv.conf':
-                content => $str,
-              }
-          }
-
-      ...but for larger files, this attribute is more useful when combined with the
-      [template](https://docs.puppetlabs.com/puppet/latest/reference/function.html#template)
-      or [file](https://docs.puppetlabs.com/puppet/latest/reference/function.html#file)
-      function.
-    EOT
-
-    # Store a checksum as the value, rather than the actual content.
-    # Simplifies everything.
-    munge do |value|
-      if value == :absent
-        value
-      elsif checksum?(value)
-        # XXX This is potentially dangerous because it means users can't write a file whose
-        # entire contents are a plain checksum
-        value
-      else
-        @actual_content = value
-        resource.parameter(:checksum).sum(value)
-      end
-    end
-
-    # Checksums need to invert how changes are printed.
-    def change_to_s(currentvalue, newvalue)
-      # Our "new" checksum value is provided by the source.
-      if source = resource.parameter(:source) and tmp = source.checksum
-        newvalue = tmp
-      end
-      if currentvalue == :absent
-        return "defined content as '#{newvalue}'"
-      elsif newvalue == :absent
-        return "undefined content from '#{currentvalue}'"
-      else
-        return "content changed '#{currentvalue}' to '#{newvalue}'"
-      end
-    end
-
-    def length
-      (actual_content and actual_content.length) || 0
-    end
-
-    def content
-      self.should
-    end
-
-    # Override this method to provide diffs if asked for.
-    # Also, fix #872: when content is used, and replace is true, the file
-    # should be insync when it exists
-    def insync?(is)
-      if resource[:source] && resource[:checksum_value]
-        # Asserts that nothing has changed since validate ran.
-        devfail "content property should not exist if source and checksum_value are specified"
-      end
-
-      contents_prop = resource.parameter(:source) || self
-      checksum_insync?(contents_prop, is, !resource[:content].nil?) {|_is| super(_is)}
-    end
-
-    def property_matches?(current, desired)
-      # If checksum_value is specified, it overrides comparing the content field.
-      checksum_type = resource.parameter(:checksum).value
-      if checksum_value = resource.parameter(:checksum_value)
-        desired = "{#{checksum_type}}#{checksum_value.value}"
-      end
-
-      # The inherited equality is always accepted, so use it if valid.
-      return true if super(current, desired)
-      return date_matches?(checksum_type, current, desired)
-    end
-
-    def retrieve
-      retrieve_checksum(resource)
-    end
-
-    # Make sure we're also managing the checksum property.
-    def should=(value)
-      # treat the value as a bytestring, in Ruby versions that support it, regardless of the encoding
-      # in which it has been supplied
-      value = value.dup.force_encoding(Encoding::ASCII_8BIT) if value.respond_to?(:force_encoding)
-      @resource.newattr(:checksum) unless @resource.parameter(:checksum)
-      super
-    end
-
-    # Just write our content out to disk.
-    def sync
-      contents_sync(resource.parameter(:source) || self)
-    end
-
-    def write(file)
-      resource.parameter(:checksum).sum_stream { |sum|
-        each_chunk_from { |chunk|
-          sum << chunk
-          file.print chunk
-        }
-      }
-    end
-
-    private
-
-    # the content is munged so if it's a checksum source_or_content is nil
-    # unless the checksum indirectly comes from source
-    def each_chunk_from
-      if actual_content.is_a?(String)
-        yield actual_content
-      elsif content_is_really_a_checksum? && actual_content.nil?
-        yield read_file_from_filebucket
-      elsif actual_content.nil?
-        yield ''
-      end
-    end
-
-    def content_is_really_a_checksum?
-      checksum?(should)
-    end
-
-    def read_file_from_filebucket
-      raise "Could not get filebucket from file" unless dipper = resource.bucket
-      sum = should.sub(/\{\w+\}/, '')
-
-      dipper.getfile(sum)
-    rescue => detail
-      self.fail Puppet::Error, "Could not retrieve content for #{should} from filebucket: #{detail}", detail
-    end
-  end
-end

data/vendor/gems/puppet-4.5.2/lib/puppet/type/file/data_sync.rb

@@ -1,84 +0,0 @@
-require 'puppet/util/checksums'
-require 'puppet/util/diff'
-require 'date'
-require 'tempfile'
-
-module Puppet
-  module DataSync
-    include Puppet::Util::Checksums
-    include Puppet::Util::Diff
-
-    def write_temporarily(param)
-      tempfile = Tempfile.new("puppet-file")
-      tempfile.open
-
-      param.write(tempfile)
-
-      tempfile.close
-
-      yield tempfile.path
-    ensure
-      tempfile.delete if tempfile
-    end
-
-    def checksum_insync?(param, is, has_contents, &block)
-      resource = param.resource
-      if resource.should_be_file?
-        return false if is == :absent
-      else
-        if resource[:ensure] == :present && has_contents && (s = resource.stat)
-          resource.warning "Ensure set to :present but file type is #{s.ftype} so no content will be synced"
-        end
-        return true
-      end
-
-      return true if ! resource.replace?
-
-      result = yield(is)
-
-      if !result && Puppet[:show_diff] && resource.show_diff?
-        write_temporarily(param) do |path|
-          send resource[:loglevel], "\n" + diff(resource[:path], path)
-        end
-      end
-      result
-    end
-
-    def date_matches?(checksum_type, current, desired)
-      time_types = [:mtime, :ctime]
-      return false if !time_types.include?(checksum_type)
-      return false unless current && desired
-
-      begin
-        if checksum?(current) || checksum?(desired)
-          raise if !time_types.include?(sumtype(current).to_sym) || !time_types.include?(sumtype(desired).to_sym)
-          current = sumdata(current)
-          desired = sumdata(desired)
-        end
-        DateTime.parse(current) >= DateTime.parse(desired)
-      rescue => detail
-        self.fail Puppet::Error, "Resource with checksum_type #{checksum_type} didn't contain a date in #{current} or #{desired}", detail.backtrace
-      end
-    end
-
-    def retrieve_checksum(resource)
-      return :absent unless stat = resource.stat
-      ftype = stat.ftype
-      # Don't even try to manage the content on directories or links
-      return nil if ["directory","link"].include?(ftype)
-
-      begin
-        resource.parameter(:checksum).sum_file(resource[:path])
-      rescue => detail
-        raise Puppet::Error, "Could not read #{ftype} #{resource.title}: #{detail}", detail.backtrace
-      end
-    end
-
-    def contents_sync(param)
-      return_event = param.resource.stat ? :file_changed : :file_created
-      resource.write(param)
-      return_event
-    end
-
-  end
-end

data/vendor/gems/puppet-4.5.2/lib/puppet/type/file/mode.rb

@@ -1,173 +0,0 @@
-# Manage file modes.  This state should support different formats
-# for specification (e.g., u+rwx, or -0011), but for now only supports
-# specifying the full mode.
-
-
-module Puppet
-  Puppet::Type.type(:file).newproperty(:mode) do
-    require 'puppet/util/symbolic_file_mode'
-    include Puppet::Util::SymbolicFileMode
-
-    desc <<-'EOT'
-      The desired permissions mode for the file, in symbolic or numeric
-      notation. This value **must** be specified as a string; do not use
-      un-quoted numbers to represent file modes.
-
-      The `file` type uses traditional Unix permission schemes and translates
-      them to equivalent permissions for systems which represent permissions
-      differently, including Windows. For detailed ACL controls on Windows,
-      you can leave `mode` unmanaged and use
-      [the puppetlabs/acl module.](https://forge.puppetlabs.com/puppetlabs/acl)
-
-      Numeric modes should use the standard octal notation of
-      `<SETUID/SETGID/STICKY><OWNER><GROUP><OTHER>` (e.g. '0644').
-
-      * Each of the "owner," "group," and "other" digits should be a sum of the
-        permissions for that class of users, where read = 4, write = 2, and
-        execute/search = 1.
-      * The setuid/setgid/sticky digit is also a sum, where setuid = 4, setgid = 2,
-        and sticky = 1.
-      * The setuid/setgid/sticky digit is optional. If it is absent, Puppet will
-        clear any existing setuid/setgid/sticky permissions. (So to make your intent
-        clear, you should use at least four digits for numeric modes.)
-      * When specifying numeric permissions for directories, Puppet sets the search
-        permission wherever the read permission is set.
-
-      Symbolic modes should be represented as a string of comma-separated
-      permission clauses, in the form `<WHO><OP><PERM>`:
-
-      * "Who" should be u (user), g (group), o (other), and/or a (all)
-      * "Op" should be = (set exact permissions), + (add select permissions),
-        or - (remove select permissions)
-      * "Perm" should be one or more of:
-          * r (read)
-          * w (write)
-          * x (execute/search)
-          * t (sticky)
-          * s (setuid/setgid)
-          * X (execute/search if directory or if any one user can execute)
-          * u (user's current permissions)
-          * g (group's current permissions)
-          * o (other's current permissions)
-
-      Thus, mode `0664` could be represented symbolically as either `a=r,ug+w`
-      or `ug=rw,o=r`.  However, symbolic modes are more expressive than numeric
-      modes: a mode only affects the specified bits, so `mode => 'ug+w'` will
-      set the user and group write bits, without affecting any other bits.
-
-      See the manual page for GNU or BSD `chmod` for more details
-      on numeric and symbolic modes.
-
-      On Windows, permissions are translated as follows:
-
-      * Owner and group names are mapped to Windows SIDs
-      * The "other" class of users maps to the "Everyone" SID
-      * The read/write/execute permissions map to the `FILE_GENERIC_READ`,
-        `FILE_GENERIC_WRITE`, and `FILE_GENERIC_EXECUTE` access rights; a
-        file's owner always has the `FULL_CONTROL` right
-      * "Other" users can't have any permissions a file's group lacks,
-        and its group can't have any permissions its owner lacks; that is, 0644
-        is an acceptable mode, but 0464 is not.
-    EOT
-
-    validate do |value|
-      if !value.is_a?(String)
-        raise Puppet::Error, "The file mode specification must be a string, not '#{value.class.name}'"
-      end
-      unless value.nil? or valid_symbolic_mode?(value)
-        raise Puppet::Error, "The file mode specification is invalid: #{value.inspect}"
-      end
-    end
-
-    munge do |value|
-      return nil if value.nil?
-
-      unless valid_symbolic_mode?(value)
-        raise Puppet::Error, "The file mode specification is invalid: #{value.inspect}"
-      end
-
-      normalize_symbolic_mode(value)
-    end
-
-    def desired_mode_from_current(desired, current)
-      current = current.to_i(8) if current.is_a? String
-      is_a_directory = @resource.stat && @resource.stat.directory?
-      symbolic_mode_to_int(desired, current, is_a_directory)
-    end
-
-    # If we're a directory, we need to be executable for all cases
-    # that are readable.  This should probably be selectable, but eh.
-    def dirmask(value)
-      if FileTest.directory?(resource[:path]) and value =~ /^\d+$/ then
-        value = value.to_i(8)
-        value |= 0100 if value & 0400 != 0
-        value |= 010 if value & 040 != 0
-        value |= 01 if value & 04 != 0
-        value = value.to_s(8)
-      end
-
-      value
-    end
-
-    # If we're not following links and we're a link, then we just turn
-    # off mode management entirely.
-    def insync?(currentvalue)
-      if stat = @resource.stat and stat.ftype == "link" and @resource[:links] != :follow
-        self.debug "Not managing symlink mode"
-        return true
-      else
-        return super(currentvalue)
-      end
-    end
-
-    def property_matches?(current, desired)
-      return false unless current
-      current_bits = normalize_symbolic_mode(current)
-      desired_bits = desired_mode_from_current(desired, current).to_s(8)
-      current_bits == desired_bits
-    end
-
-    # Ideally, dirmask'ing could be done at munge time, but we don't know if 'ensure'
-    # will eventually be a directory or something else. And unfortunately, that logic
-    # depends on the ensure, source, and target properties. So rather than duplicate
-    # that logic, and get it wrong, we do dirmask during retrieve, after 'ensure' has
-    # been synced.
-    def retrieve
-      if @resource.stat
-        @should &&= @should.collect { |s| self.dirmask(s) }
-      end
-
-      super
-    end
-
-    # Finally, when we sync the mode out we need to transform it; since we
-    # don't have access to the calculated "desired" value here, or the
-    # "current" value, only the "should" value we need to retrieve again.
-    def sync
-      current = @resource.stat ? @resource.stat.mode : 0644
-      set(desired_mode_from_current(@should[0], current).to_s(8))
-    end
-
-    def change_to_s(old_value, desired)
-      return super if desired =~ /^\d+$/
-
-      old_bits = normalize_symbolic_mode(old_value)
-      new_bits = normalize_symbolic_mode(desired_mode_from_current(desired, old_bits))
-      super(old_bits, new_bits) + " (#{desired})"
-    end
-
-    def should_to_s(should_value)
-      should_value.rjust(4, "0")
-    end
-
-    def is_to_s(currentvalue)
-      if currentvalue == :absent
-        # This can occur during audits---if a file is transitioning from
-        # present to absent the mode will have a value of `:absent`.
-        super
-      else
-        currentvalue.rjust(4, "0")
-      end
-    end
-  end
-end