Class: Puppet::Provider::Package

Inherits:
Puppet::Provider show all
Defined in:
lib/puppet/provider/package.rb

Defined Under Namespace

Classes: Windows

Constant Summary

Constants inherited from Puppet::Provider

Confine

Constants included from Util::Logging

Util::Logging::FILE_AND_LINE, Util::Logging::FILE_NO_LINE, Util::Logging::MM, Util::Logging::NO_FILE_LINE, Util::Logging::SUPPRESS_FILE_LINE

Constants included from Util

Util::AbsolutePathPosix, Util::AbsolutePathWindows, Util::DEFAULT_POSIX_MODE, Util::DEFAULT_WINDOWS_MODE

Constants included from Util::POSIX

Util::POSIX::LOCALE_ENV_VARS, Util::POSIX::USER_ENV_VARS

Constants included from Util::SymbolicFileMode

Util::SymbolicFileMode::SetGIDBit, Util::SymbolicFileMode::SetUIDBit, Util::SymbolicFileMode::StickyBit, Util::SymbolicFileMode::SymbolicMode, Util::SymbolicFileMode::SymbolicSpecialToBit

Constants included from Util::Docs

Util::Docs::HEADER_LEVELS

Instance Attribute Summary

Attributes inherited from Puppet::Provider

#resource

Attributes included from Util::Docs

#doc, #nodoc

Class Method Summary collapse

Instance Method Summary collapse

Methods inherited from Puppet::Provider

#<=>, #clear, #command, command, commands, declared_feature?, default?, default_match, defaultfor, execfail, #execfail, execpipe, #execpipe, execute, #execute, fact_match, feature_match, #get, has_command, #initialize, initvars, #inspect, instances, mk_resource_methods, #name, optional_commands, post_resource_eval, #set, specificity, supports_parameter?, #to_s

Methods included from Util::Logging

#clear_deprecation_warnings, #debug, #deprecation_warning, #format_exception, #get_deprecation_offender, #log_and_raise, #log_deprecations_to_file, #log_exception, #puppet_deprecation_warning, #send_log, setup_facter_logging!, #warn_once

Methods included from Util

absolute_path?, benchmark, chuser, clear_environment, default_env, deterministic_rand, deterministic_rand_int, exit_on_fail, get_env, get_environment, logmethods, merge_environment, path_to_uri, pretty_backtrace, replace_file, safe_posix_fork, set_env, symbolizehash, thinmark, uri_encode, uri_query_encode, uri_to_path, which, withenv, withumask

Methods included from Util::POSIX

#get_posix_field, #gid, #idfield, #methodbyid, #methodbyname, #search_posix_field, #uid

Methods included from Util::SymbolicFileMode

#normalize_symbolic_mode, #symbolic_mode_to_int, #valid_symbolic_mode?

Methods included from Util::Docs

#desc, #dochook, #doctable, #markdown_definitionlist, #markdown_header, #nodoc?, #pad, scrub

Methods included from Util::Warnings

clear_warnings, debug_once, notice_once, warnonce

Methods included from Confiner

#confine, #confine_collection, #suitable?

Methods included from Util::Errors

#adderrorcontext, #devfail, #error_context, #exceptwrap, #fail

Constructor Details

This class inherits a constructor from Puppet::Provider

Class Method Details

.prefetch(packages) ⇒ Object

Prefetch our package list, yo.



3
4
5
6
7
8
9
 
# File 'lib/puppet/provider/package.rb', line 3

def self.prefetch(packages)
  instances.each do |prov|
    if pkg = packages[prov.name]
      pkg.provider = prov
    end
  end
end

Instance Method Details

#flush ⇒ Object

Clear out the cached values.



12
13
14
 
# File 'lib/puppet/provider/package.rb', line 12

def flush
  @property_hash.clear
end

#join_options(options) ⇒ Object

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Turns a array of options into flags to be passed to a command. The options can be passed as a string or hash. Note that passing a hash should only be used in case –foo=bar must be passed, which can be accomplished with:

install_options => [ { '--foo' => 'bar' } ]

Regular flags like ‘–foo’ must be passed as a string.

Parameters:

  • options (Array)

Returns:

  • Concatenated list of options



42
43
44
45
46
47
48
49
50
51
52
53
54
55
 
# File 'lib/puppet/provider/package.rb', line 42

def join_options(options)
  return unless options

  options.collect do |val|
    case val
      when Hash
        val.keys.sort.collect do |k|
          "#{k}=#{val[k]}"
        end
      else
        val
    end
  end.flatten
end

#properties ⇒ Object

Look up the current status.



17
18
19
20
21
22
23
24
25
26
27
 
# File 'lib/puppet/provider/package.rb', line 17

def properties
  if @property_hash.empty?
    # For providers that support purging, default to purged; otherwise default to absent
    # Purged is the "most uninstalled" a package can be, so a purged package will be in-sync with
    # either `ensure => absent` or `ensure => purged`; an absent package will be out of sync with `ensure => purged`.
    default_status = self.class.feature?(:purgeable) ? :purged : :absent
    @property_hash = query || { :ensure => ( default_status )}
    @property_hash[:ensure] = default_status if @property_hash.empty?
  end
  @property_hash.dup
end

#validate_source(value) ⇒ Object 



29
30
31
 
# File 'lib/puppet/provider/package.rb', line 29

def validate_source(value)
  true
end