Class: Puppet::Provider::NetworkDevice

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

Overview

This is the base class of all prefetched network device provider

Constant Summary

Constants inherited from Puppet::Provider

Confine

Constants included from Util

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

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 collapse

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, initvars, #inspect, mk_resource_methods, #name, notdefaultfor, optional_commands, post_resource_eval, #set, some_default_match, 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, groups_of, #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, maybe_log, notice_once, warnonce

Methods included from Confiner

#confine, #confine_collection, #suitable?

Methods included from Util::Errors

#adderrorcontext, #devfail, #error_context, error_location, error_location_with_space, error_location_with_unknowns, #exceptwrap, #fail

Constructor Details

#initialize(device, *args) ⇒ NetworkDevice

Returns a new instance of NetworkDevice.



35
36
37
38
39
40
41
42
43
 
# File 'lib/puppet/provider/network_device.rb', line 35

def initialize(device, *args)
  super(*args)

  @device = device

  # Make a duplicate, so that we have a copy for comparison
  # at the end.
  @properties = @property_hash.dup
end

Instance Attribute Details

#device ⇒ Object 



33
34
35
 
# File 'lib/puppet/provider/network_device.rb', line 33

def device
  @device
end

Class Method Details

.device(url) ⇒ Object 



5
6
7
 
# File 'lib/puppet/provider/network_device.rb', line 5

def self.device(url)
  raise "This provider doesn't implement the necessary device method"
end

.instances ⇒ Object 



62
63
 
# File 'lib/puppet/provider/network_device.rb', line 62

def self.instances
end

.lookup(device, name) ⇒ Object 



9
10
11
 
# File 'lib/puppet/provider/network_device.rb', line 9

def self.lookup(device, name)
  raise "This provider doesn't implement the necessary lookup method"
end

.prefetch(resources) ⇒ Object 



13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
 
# File 'lib/puppet/provider/network_device.rb', line 13

def self.prefetch(resources)
  resources.each do |name, resource|
    device = Puppet::Util::NetworkDevice.current || device(resource[:device_url])
    if result = lookup(device, name)
      result[:ensure] = :present
      resource.provider = new(device, result)
    else
      resource.provider = new(device, :ensure => :absent)
    end
  end
rescue => detail
  # Preserving behavior introduced in #6907
  #TRANSLATORS "prefetch" is a program name and should not be translated
  Puppet.log_exception(detail, _("Could not perform network device prefetch: %{detail}") % { detail: detail })
end

Instance Method Details

#create ⇒ Object 



45
46
47
48
49
50
51
52
 
# File 'lib/puppet/provider/network_device.rb', line 45

def create
  @property_hash[:ensure] = :present
  self.class.resource_type.validproperties.each do |property|
    if val = resource.should(property)
      @property_hash[property] = val
    end
  end
end

#destroy ⇒ Object 



54
55
56
 
# File 'lib/puppet/provider/network_device.rb', line 54

def destroy
  @property_hash[:ensure] = :absent
end

#exists? ⇒ Boolean

Returns:

  • (Boolean) 


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

def exists?
  @property_hash[:ensure] != :absent
end

#flush ⇒ Object 



58
59
60
 
# File 'lib/puppet/provider/network_device.rb', line 58

def flush
  @property_hash.clear
end

#former_properties ⇒ Object 



65
66
67
 
# File 'lib/puppet/provider/network_device.rb', line 65

def former_properties
  @properties.dup
end

#properties ⇒ Object 



69
70
71
 
# File 'lib/puppet/provider/network_device.rb', line 69

def properties
  @property_hash.dup
end