openvox 8.19.0

data/lib/puppet/provider/package/macports.rb

@@ -0,0 +1,112 @@
+# frozen_string_literal: true
+
+require_relative '../../../puppet/provider/package'
+require_relative '../../../puppet/provider/command'
+
+Puppet::Type.type(:package).provide :macports, :parent => Puppet::Provider::Package do
+  desc "Package management using MacPorts on OS X.
+
+    Supports MacPorts versions and revisions, but not variants.
+    Variant preferences may be specified using
+    [the MacPorts variants.conf file](http://guide.macports.org/chunked/internals.configuration-files.html#internals.configuration-files.variants-conf).
+
+    When specifying a version in the Puppet DSL, only specify the version, not the revision.
+    Revisions are only used internally for ensuring the latest version/revision of a port.
+  "
+
+  confine 'os.name' => :darwin
+
+  has_command(:port, "/opt/local/bin/port") do
+    environment :HOME => "/opt/local"
+  end
+
+  has_feature :installable
+  has_feature :uninstallable
+  has_feature :upgradeable
+  has_feature :versionable
+
+  def self.parse_installed_query_line(line)
+    regex = /(\S+)\s+@(\S+)_(\d+).*\(active\)/
+    fields = [:name, :ensure, :revision]
+    hash_from_line(line, regex, fields)
+  end
+
+  def self.parse_info_query_line(line)
+    regex = /(\S+)\s+(\S+)/
+    fields = [:version, :revision]
+    hash_from_line(line, regex, fields)
+  end
+
+  def self.hash_from_line(line, regex, fields)
+    hash = {}
+    match = regex.match(line)
+    if match
+      fields.zip(match.captures) { |field, value|
+        hash[field] = value
+      }
+      hash[:provider] = name
+      return hash
+    end
+    nil
+  end
+
+  def self.instances
+    packages = []
+    port("-q", :installed).each_line do |line|
+      hash = parse_installed_query_line(line)
+      if hash
+        packages << new(hash)
+      end
+    end
+    packages
+  end
+
+  def install
+    should = @resource.should(:ensure)
+    if [:latest, :installed, :present].include?(should)
+      port("-q", :install, @resource[:name])
+    else
+      port("-q", :install, @resource[:name], "@#{should}")
+    end
+    # MacPorts now correctly exits non-zero with appropriate errors in
+    # situations where a port cannot be found or installed.
+  end
+
+  def query
+    result = self.class.parse_installed_query_line(execute([command(:port), "-q", :installed, @resource[:name]], :failonfail => false, :combine => false))
+    return {} if result.nil?
+
+    result
+  end
+
+  def latest
+    # We need both the version and the revision to be confident
+    # we've got the latest revision of a specific version
+    # Note we're still not doing anything with variants here.
+    info_line = execute([command(:port), "-q", :info, "--line", "--version", "--revision", @resource[:name]], :failonfail => false, :combine => false)
+    return nil if info_line == ""
+
+    newest = self.class.parse_info_query_line(info_line)
+    if newest
+      current = query
+      # We're doing some fiddling behind the scenes here to cope with updated revisions.
+      # If we're already at the latest version/revision, then just return the version
+      # so the current and desired values match. Otherwise return version and revision
+      # to trigger an upgrade to the latest revision.
+      if newest[:version] == current[:ensure] and newest[:revision] == current[:revision]
+        return current[:ensure]
+      else
+        return "#{newest[:version]}_#{newest[:revision]}"
+      end
+    end
+    nil
+  end
+
+  def uninstall
+    port("-q", :uninstall, @resource[:name])
+  end
+
+  def update
+    install
+  end
+end

data/lib/puppet/provider/package/nim.rb

@@ -0,0 +1,290 @@
+# frozen_string_literal: true
+
+require_relative '../../../puppet/provider/package'
+require_relative '../../../puppet/util/package'
+
+Puppet::Type.type(:package).provide :nim, :parent => :aix, :source => :aix do
+  desc "Installation from an AIX NIM LPP source.  The `source` parameter is required
+      for this provider, and should specify the name of a NIM `lpp_source` resource
+      that is visible to the puppet agent machine.  This provider supports the
+      management of both BFF/installp and RPM packages.
+
+      Note that package downgrades are *not* supported; if your resource specifies
+      a specific version number and there is already a newer version of the package
+      installed on the machine, the resource will fail with an error message."
+
+  # The commands we are using on an AIX box are installed standard
+  # (except nimclient) nimclient needs the bos.sysmgt.nim.client fileset.
+  commands    :nimclient => "/usr/sbin/nimclient",
+              :lslpp => "/usr/bin/lslpp",
+              :rpm => "rpm"
+
+  # If NIM has not been configured, /etc/niminfo will not be present.
+  # However, we have no way of knowing if the NIM server is not configured
+  # properly.
+  confine :exists => "/etc/niminfo"
+
+  has_feature :versionable
+
+  attr_accessor :latest_info
+
+  def self.srclistcmd(source)
+    [command(:nimclient), "-o", "showres", "-a", "installp_flags=L", "-a", "resource=#{source}"]
+  end
+
+  def uninstall
+    output = lslpp("-qLc", @resource[:name]).split(':')
+    # the 6th index in the colon-delimited output contains a " " for installp/BFF
+    # packages, and an "R" for RPMS.  (duh.)
+    pkg_type = output[6]
+
+    case pkg_type
+    when " "
+      installp "-gu", @resource[:name]
+    when "R"
+      rpm "-e", @resource[:name]
+    else
+      self.fail(_("Unrecognized AIX package type identifier: '%{pkg_type}'") % { pkg_type: pkg_type })
+    end
+
+    # installp will return an exit code of zero even if it didn't uninstall
+    # anything... so let's make sure it worked.
+    unless query().nil?
+      self.fail _("Failed to uninstall package '%{name}'") % { name: @resource[:name] }
+    end
+  end
+
+  def install(useversion = true)
+    source = @resource[:source]
+    unless source
+      self.fail _("An LPP source location is required in 'source'")
+    end
+
+    pkg = @resource[:name]
+
+    version_specified = (useversion and (!@resource.should(:ensure).is_a? Symbol))
+
+    # This is unfortunate for a couple of reasons.  First, because of a subtle
+    # difference in the command-line syntax for installing an RPM vs an
+    # installp/BFF package, we need to know ahead of time which type of
+    # package we're trying to install.  This means we have to execute an
+    # extra command.
+    #
+    # Second, the command is easiest to deal with and runs fastest if we
+    # pipe it through grep on the shell.  Unfortunately, the way that
+    # the provider `make_command_methods` metaprogramming works, we can't
+    # use that code path to execute the command (because it treats the arguments
+    # as an array of args that all apply to `nimclient`, which fails when you
+    # hit the `|grep`.)  So here we just call straight through to P::U.execute
+    # with a single string argument for the full command, rather than going
+    # through the metaprogrammed layer.  We could get rid of the grep and
+    # switch back to the metaprogrammed stuff, and just parse all of the output
+    # in Ruby... but we'd be doing an awful lot of unnecessary work.
+    showres_command = "/usr/sbin/nimclient -o showres -a resource=#{source} |/usr/bin/grep -p -E "
+    if version_specified
+      version = @resource.should(:ensure)
+      showres_command << "'#{Regexp.escape(pkg)}( |-)#{Regexp.escape(version)}'"
+    else
+      version = nil
+      showres_command << "'#{Regexp.escape(pkg)}'"
+    end
+    output = Puppet::Util::Execution.execute(showres_command)
+
+    if version_specified
+      package_type = determine_package_type(output, pkg, version)
+    else
+      package_type, version = determine_latest_version(output, pkg)
+    end
+
+    if package_type.nil?
+
+      errmsg = if version_specified
+                 _("Unable to find package '%{package}' with version '%{version}' on lpp_source '%{source}'") %
+                   { package: pkg, version: version, source: source }
+               else
+                 _("Unable to find package '%{package}' on lpp_source '%{source}'") % { package: pkg, source: source }
+               end
+      self.fail errmsg
+    end
+
+    # This part is a bit tricky.  If there are multiple versions of the
+    # package available, then `version` will be set to a value, and we'll need
+    # to add that value to our installation command.  However, if there is only
+    # one version of the package available, `version` will be set to `nil`, and
+    # we don't need to add the version string to the command.
+    if version
+      # Now we know if the package type is RPM or not, and we can adjust our
+      # `pkg` string for passing to the install command accordingly.
+      if package_type == :rpm
+        # RPMs expect a hyphen between the package name and the version number
+        version_separator = "-"
+      else
+        # installp/BFF packages expect a space between the package name and the
+        # version number.
+        version_separator = " "
+      end
+
+      pkg += version_separator + version
+    end
+
+    # NOTE: the installp flags here are ignored (but harmless) for RPMs
+    output = nimclient "-o", "cust", "-a", "installp_flags=acgwXY", "-a", "lpp_source=#{source}", "-a", "filesets=#{pkg}"
+
+    # If the package is superseded, it means we're trying to downgrade and we
+    # can't do that.
+    case package_type
+    when :installp
+      if output =~ /^#{Regexp.escape(@resource[:name])}\s+.*\s+Already superseded by.*$/
+        self.fail _("NIM package provider is unable to downgrade packages")
+      end
+    when :rpm
+      if output =~ /^#{Regexp.escape(@resource[:name])}.* is superseded by.*$/
+        self.fail _("NIM package provider is unable to downgrade packages")
+      end
+    end
+  end
+
+  private
+
+  ## UTILITY METHODS FOR PARSING `nimclient -o showres` output
+
+  # This makes me very sad.  These regexes seem pretty fragile, but
+  # I spent a lot of time trying to figure out a solution that didn't
+  # require parsing the `nimclient -o showres` output and was unable to
+  # do so.
+  self::HEADER_LINE_REGEX      = /^([^\s]+)\s+[^@]+@@(I|R|S):(\1)\s+[^\s]+$/
+  self::PACKAGE_LINE_REGEX     = /^.*@@(I|R|S):(.*)$/
+  self::RPM_PACKAGE_REGEX      = /^(.*)-(.*-\d+\w*) \2$/
+  self::INSTALLP_PACKAGE_REGEX = /^(.*) (.*)$/
+
+  # Here is some sample output that shows what the above regexes will be up
+  # against:
+  # FOR AN INSTALLP(bff) PACKAGE:
+  #
+  #    mypackage.foo                                                           ALL  @@I:mypackage.foo _all_filesets
+  #    + 1.2.3.4  MyPackage Runtime Environment                       @@I:mypackage.foo 1.2.3.4
+  #    + 1.2.3.8  MyPackage Runtime Environment                       @@I:mypackage.foo 1.2.3.8
+  #
+  # FOR AN INSTALLP(bff) PACKAGE with security update:
+  #
+  #    bos.net                                                                 ALL  @@S:bos.net _all_filesets
+  #    + 7.2.0.1  TCP/IP ntp Applications                             @@S:bos.net.tcp.ntp 7.2.0.1
+  #    + 7.2.0.2  TCP/IP ntp Applications                             @@S:bos.net.tcp.ntp 7.2.0.2
+  #
+  # FOR AN RPM PACKAGE:
+  #
+  # mypackage.foo                                                                ALL  @@R:mypackage.foo _all_filesets
+  #   @@R:mypackage.foo-1.2.3-1 1.2.3-1
+  #   @@R:mypackage.foo-1.2.3-4 1.2.3-4
+  #   @@R:mypackage.foo-1.2.3-8 1.2.3-8
+
+  # Parse the output of a `nimclient -o showres` command.  Returns a two-dimensional
+  # hash, where the first-level keys are package names, the second-level keys are
+  # version number strings for all of the available version numbers for a package,
+  # and the values indicate the package type (:rpm / :installp)
+  def parse_showres_output(showres_output)
+    paragraphs = split_into_paragraphs(showres_output)
+    packages = {}
+    paragraphs.each do |para|
+      lines = para.split(/$/)
+      parse_showres_header_line(lines.shift)
+      lines.each do |l|
+        package, version, type = parse_showres_package_line(l)
+        packages[package] ||= {}
+        packages[package][version] = type
+      end
+    end
+    packages
+  end
+
+  # This method basically just splits the multi-line input string into chunks
+  # based on lines that contain nothing but whitespace.  It also strips any
+  # leading or trailing whitespace (including newlines) from the resulting
+  # strings and then returns them as an array.
+  def split_into_paragraphs(showres_output)
+    showres_output.split(/^\s*$/).map(&:strip!)
+  end
+
+  def parse_showres_header_line(line)
+    # This method doesn't produce any meaningful output; it's basically just
+    # meant to validate that the header line for the package listing output
+    # looks sane, so we know we're dealing with the kind of output that we
+    # are capable of handling.
+    unless line.match(self.class::HEADER_LINE_REGEX)
+      self.fail _("Unable to parse output from nimclient showres: line does not match expected package header format:\n'%{line}'") % { line: line }
+    end
+  end
+
+  def parse_installp_package_string(package_string)
+    match = package_string.match(self.class::INSTALLP_PACKAGE_REGEX)
+    unless match
+      self.fail _("Unable to parse output from nimclient showres: package string does not match expected installp package string format:\n'%{package_string}'") % { package_string: package_string }
+    end
+    package_name = match.captures[0]
+    version = match.captures[1]
+    [package_name, version, :installp]
+  end
+
+  def parse_rpm_package_string(package_string)
+    match = package_string.match(self.class::RPM_PACKAGE_REGEX)
+    unless match
+      self.fail _("Unable to parse output from nimclient showres: package string does not match expected rpm package string format:\n'%{package_string}'") % { package_string: package_string }
+    end
+    package_name = match.captures[0]
+    version = match.captures[1]
+    [package_name, version, :rpm]
+  end
+
+  def parse_showres_package_line(line)
+    match = line.match(self.class::PACKAGE_LINE_REGEX)
+    unless match
+      self.fail _("Unable to parse output from nimclient showres: line does not match expected package line format:\n'%{line}'") % { line: line }
+    end
+
+    package_type_flag = match.captures[0]
+    package_string = match.captures[1]
+
+    case package_type_flag
+    when "I", "S"
+      parse_installp_package_string(package_string)
+    when "R"
+      parse_rpm_package_string(package_string)
+    else
+      self.fail _("Unrecognized package type specifier: '%{package_type_flag}' in package line:\n'%{line}'") % { package_type_flag: package_type_flag, line: line }
+    end
+  end
+
+  # Given a blob of output from `nimclient -o showres` and a package name,
+  # this method checks to see if there are multiple versions of the package
+  # available on the lpp_source.  If there are, the method returns
+  # [package_type, latest_version] (where package_type is one of :installp or :rpm).
+  # If there is only one version of the package available, it returns
+  # [package_type, nil], because the caller doesn't need to pass the version
+  # string to the command-line command if there is only one version available.
+  # If the package is not available at all, the method simply returns nil (instead
+  # of a tuple).
+  def determine_latest_version(showres_output, package_name)
+    packages = parse_showres_output(showres_output)
+    unless packages.has_key?(package_name)
+      return nil
+    end
+
+    if packages[package_name].count == 1
+      version = packages[package_name].keys[0]
+      [packages[package_name][version], nil]
+    else
+      versions = packages[package_name].keys
+      latest_version = (versions.sort { |a, b| Puppet::Util::Package.versioncmp(b, a) })[0]
+      [packages[package_name][latest_version], latest_version]
+    end
+  end
+
+  def determine_package_type(showres_output, package_name, version)
+    packages = parse_showres_output(showres_output)
+    unless packages.has_key?(package_name) and packages[package_name].has_key?(version)
+      return nil
+    end
+
+    packages[package_name][version]
+  end
+end

data/lib/puppet/provider/package/openbsd.rb

@@ -0,0 +1,263 @@
+# frozen_string_literal: true
+
+require_relative '../../../puppet/provider/package'
+
+# Packaging on OpenBSD.  Doesn't work anywhere else that I know of.
+Puppet::Type.type(:package).provide :openbsd, :parent => Puppet::Provider::Package do
+  desc "OpenBSD's form of `pkg_add` support.
+
+    This provider supports the `install_options` and `uninstall_options`
+    attributes, which allow command-line flags to be passed to pkg_add and pkg_delete.
+    These options should be specified as an array where each element is either a
+     string or a hash."
+
+  commands :pkginfo => "pkg_info",
+           :pkgadd => "pkg_add",
+           :pkgdelete => "pkg_delete"
+
+  defaultfor 'os.name' => :openbsd
+  confine 'os.name' => :openbsd
+
+  has_feature :versionable
+  has_feature :install_options
+  has_feature :uninstall_options
+  has_feature :upgradeable
+  has_feature :supports_flavors
+
+  def self.instances
+    packages = []
+
+    begin
+      execpipe(listcmd) do |process|
+        # our regex for matching pkg_info output
+        regex = /^(.*)-(\d[^-]*)-?([\w-]*)(.*)$/
+        fields = [:name, :ensure, :flavor]
+        hash = {}
+
+        # now turn each returned line into a package object
+        process.each_line { |line|
+          match = regex.match(line.split[0])
+          if match
+            fields.zip(match.captures) { |field, value|
+              hash[field] = value
+            }
+
+            hash[:provider] = name
+
+            packages << new(hash)
+            hash = {}
+          else
+            unless line =~ /Updating the pkgdb/
+              # Print a warning on lines we can't match, but move
+              # on, since it should be non-fatal
+              warning(_("Failed to match line %{line}") % { line: line })
+            end
+          end
+        }
+      end
+
+      packages
+    rescue Puppet::ExecutionFailure
+      nil
+    end
+  end
+
+  def self.listcmd
+    [command(:pkginfo), "-a"]
+  end
+
+  def latest
+    parse_pkgconf
+
+    if @resource[:source][-1, 1] == ::File::SEPARATOR
+      e_vars = { 'PKG_PATH' => @resource[:source] }
+    else
+      e_vars = {}
+    end
+
+    if @resource[:flavor]
+      query = "#{@resource[:name]}--#{@resource[:flavor]}"
+    else
+      query = @resource[:name]
+    end
+
+    output = Puppet::Util.withenv(e_vars) { pkginfo "-Q", query }
+    version = properties[:ensure]
+
+    if output.nil? or output.size == 0 or output =~ /Error from /
+      debug "Failed to query for #{resource[:name]}"
+      return version
+    else
+      # Remove all fuzzy matches first.
+      output = output.split.select { |p| p =~ /^#{resource[:name]}-(\d[^-]*)-?(\w*)/ }.join
+      debug "pkg_info -Q for #{resource[:name]}: #{output}"
+    end
+
+    if output =~ /^#{resource[:name]}-(\d[^-]*)-?(\w*) \(installed\)$/
+      debug "Package is already the latest available"
+      version
+    else
+      match = /^(.*)-(\d[^-]*)-?(\w*)$/.match(output)
+      debug "Latest available for #{resource[:name]}: #{match[2]}"
+
+      if version.to_sym == :absent || version.to_sym == :purged
+        return match[2]
+      end
+
+      vcmp = version.split('.').map(&:to_i) <=> match[2].split('.').map(&:to_i)
+      if vcmp > 0
+        # The locally installed package may actually be newer than what a mirror
+        # has. Log it at debug, but ignore it otherwise.
+        debug "Package #{resource[:name]} #{version} newer then available #{match[2]}"
+        version
+      else
+        match[2]
+      end
+    end
+  end
+
+  def update
+    install(true)
+  end
+
+  def parse_pkgconf
+    unless @resource[:source]
+      if Puppet::FileSystem.exist?("/etc/pkg.conf")
+        File.open("/etc/pkg.conf", "rb").readlines.each do |line|
+          matchdata = line.match(/^installpath\s*=\s*(.+)\s*$/i)
+          if matchdata
+            @resource[:source] = matchdata[1]
+          else
+            matchdata = line.match(/^installpath\s*\+=\s*(.+)\s*$/i)
+            if matchdata
+              if @resource[:source].nil?
+                @resource[:source] = matchdata[1]
+              else
+                @resource[:source] += ":" + matchdata[1]
+              end
+            end
+          end
+        end
+
+        unless @resource[:source]
+          raise Puppet::Error,
+                _("No valid installpath found in /etc/pkg.conf and no source was set")
+        end
+      else
+        raise Puppet::Error,
+              _("You must specify a package source or configure an installpath in /etc/pkg.conf")
+      end
+    end
+  end
+
+  def install(latest = false)
+    cmd = []
+
+    parse_pkgconf
+
+    if @resource[:source][-1, 1] == ::File::SEPARATOR
+      e_vars = { 'PKG_PATH' => @resource[:source] }
+      full_name = get_full_name(latest)
+    else
+      e_vars = {}
+      full_name = @resource[:source]
+    end
+
+    cmd << install_options
+    cmd << full_name
+
+    if latest
+      cmd.unshift('-rz')
+    end
+
+    Puppet::Util.withenv(e_vars) { pkgadd cmd.flatten.compact }
+  end
+
+  def get_full_name(latest = false)
+    # In case of a real update (i.e., the package already exists) then
+    # pkg_add(8) can handle the flavors. However, if we're actually
+    # installing with 'latest', we do need to handle the flavors. This is
+    # done so we can feed pkg_add(8) the full package name to install to
+    # prevent ambiguity.
+    if latest && resource[:flavor]
+      "#{resource[:name]}--#{resource[:flavor]}"
+    elsif latest
+      # Don't depend on get_version for updates.
+      @resource[:name]
+    else
+      # If :ensure contains a version, use that instead of looking it up.
+      # This allows for installing packages with the same stem, but multiple
+      # version such as openldap-server.
+      if @resource[:ensure].to_s =~ /(\d[^-]*)$/
+        use_version = @resource[:ensure]
+      else
+        use_version = get_version
+      end
+
+      [@resource[:name], use_version, @resource[:flavor]].join('-').gsub(/-+$/, '')
+    end
+  end
+
+  def get_version
+    execpipe([command(:pkginfo), "-I", @resource[:name]]) do |process|
+      # our regex for matching pkg_info output
+      regex = /^(.*)-(\d[^-]*)-?(\w*)(.*)$/
+      master_version = 0
+      version = -1
+
+      process.each_line do |line|
+        match = regex.match(line.split[0])
+        next unless match
+
+        # now we return the first version, unless ensure is latest
+        version = match.captures[1]
+        return version unless @resource[:ensure] == "latest"
+
+        master_version = version unless master_version > version
+      end
+
+      return master_version unless master_version == 0
+      return '' if version == -1
+
+      raise Puppet::Error, _("%{version} is not available for this package") % { version: version }
+    end
+  rescue Puppet::ExecutionFailure
+    nil
+  end
+
+  def query
+    # Search for the version info
+    if pkginfo(@resource[:name]) =~ /Information for (inst:)?#{@resource[:name]}-(\S+)/
+      { :ensure => Regexp.last_match(2) }
+    else
+      nil
+    end
+  end
+
+  def install_options
+    join_options(resource[:install_options])
+  end
+
+  def uninstall_options
+    join_options(resource[:uninstall_options])
+  end
+
+  def uninstall
+    pkgdelete uninstall_options.flatten.compact, @resource[:name]
+  end
+
+  def purge
+    pkgdelete "-c", "-q", @resource[:name]
+  end
+
+  def flavor
+    @property_hash[:flavor]
+  end
+
+  def flavor=(value)
+    if flavor != @resource.should(:flavor)
+      uninstall
+      install
+    end
+  end
+end