Class: Chef::Resource::LWRPBase

Inherits:
Chef::Resource show all
Extended by:
Mixin::ConvertToClassName, Mixin::FromFile
Defined in:
lib/chef/resource/lwrp_base.rb

Overview

Chef::Resource::LWRPBase

Base class for LWRP resources. Adds DSL sugar on top of Chef::Resource, so attributes, default action, etc. can be defined with pleasing syntax.

Constant Summary collapse

NULL_ARG =
Object.new

Constants inherited from Chef::Resource

FORBIDDEN_IVARS, HIDDEN_IVARS

Instance Attribute Summary

Attributes inherited from Chef::Resource

#allowed_actions, #cookbook_name, #elapsed_time, #enclosing_provider, #not_if_args, #only_if_args, #params, #provider, #recipe_name, #resource_name, #retries, #retry_delay, #run_context, #source_line, #updated

Class Method Summary collapse

Instance Method Summary collapse

Methods included from Mixin::ConvertToClassName

convert_to_class_name, convert_to_snake_case, filename_to_qualified_string, snake_case_basename

Methods included from Mixin::FromFile

class_from_file, from_file

Methods inherited from Chef::Resource

#action, #after_created, #as_json, #cookbook_version, #customize_exception, #defined_at, #delayed_notifications, dsl_name, #epic_fail, #events, #identity, identity_attr, #ignore_failure, #immediate_notifications, #inspect, #is, json_create, #load_prior_resource, #method_missing, #name, #node, #noop, #not_if, #notifies, #notifies_delayed, #notifies_immediately, #only_if, platform_map, provider_base, #provider_for_action, provides, #resolve_notification_references, resource_for_node, resource_for_platform, #resources, #run_action, #should_skip?, #state, state_attrs, #subscribes, #supports, #to_hash, #to_json, #to_s, #to_text, #updated?, #updated_by_last_action, #updated_by_last_action?, #validate_action

Methods included from Mixin::Deprecation

#deprecated_ivar

Methods included from DSL::RegistryHelper

#registry_data_exists?, #registry_get_subkeys, #registry_get_values, #registry_has_subkeys?, #registry_key_exists?, #registry_value_exists?

Methods included from DSL::PlatformIntrospection

#platform?, #platform_family?, #value_for_platform, #value_for_platform_family

Methods included from Mixin::ParamsValidate

#set_or_return, #validate

Methods included from DSL::DataQuery

#data_bag, #data_bag_item, #search

Constructor Details

#initialize(name, run_context = nil) ⇒ LWRPBase

Default initializer. Sets the default action and allowed actions.



118
119
120
121
122
123
# File 'lib/chef/resource/lwrp_base.rb', line 118

def initialize(name, run_context=nil)
  super(name, run_context)
  @resource_name = self.class.resource_name.to_sym
  @action = self.class.default_action
  allowed_actions.push(self.class.valid_actions).flatten!
end

Dynamic Method Handling

This class handles dynamic methods through the method_missing method in the class Chef::Resource

Class Method Details

.actions(*action_names) ⇒ Object

Adds action_names to the list of valid actions for this resource.



95
96
97
# File 'lib/chef/resource/lwrp_base.rb', line 95

def self.actions(*action_names)
  valid_actions.push(*action_names)
end

.attribute(attr_name, validation_opts = {}) ⇒ Object

Define an attribute on this resource, including optional validation parameters.



70
71
72
73
74
75
76
77
78
79
80
81
82
83
# File 'lib/chef/resource/lwrp_base.rb', line 70

def self.attribute(attr_name, validation_opts={})
  # Ruby 1.8 doesn't support default arguments to blocks, but we have to
  # use define_method with a block to capture +validation_opts+.
  # Workaround this by defining two methods :(
  class_eval(<<-SHIM, __FILE__, __LINE__)
    def #{attr_name}(arg=nil)
      _set_or_return_#{attr_name}(arg)
    end
  SHIM

  define_method("_set_or_return_#{attr_name.to_s}".to_sym) do |arg|
    set_or_return(attr_name.to_sym, arg, validation_opts)
  end
end

.build_from_file(cookbook_name, filename, run_context) ⇒ Object

Evaluates the LWRP resource file and instantiates a new Resource class.



37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
# File 'lib/chef/resource/lwrp_base.rb', line 37

def self.build_from_file(cookbook_name, filename, run_context)
  rname = filename_to_qualified_string(cookbook_name, filename)

  # Add log entry if we override an existing light-weight resource.
  class_name = convert_to_class_name(rname)
  overriding = Chef::Resource.const_defined?(class_name)
  Chef::Log.info("#{class_name} light-weight resource already initialized -- overriding!") if overriding

  resource_class = Class.new(self)

  resource_class.resource_name = rname
  resource_class.run_context = run_context
  resource_class.class_from_file(filename)

  Chef::Resource.const_set(class_name, resource_class)
  Chef::Log.debug("Loaded contents of #{filename} into a resource named #{rname} defined in Chef::Resource::#{class_name}")

  resource_class
end

.default_action(action_name = NULL_ARG) ⇒ Object

Sets the default action



86
87
88
89
90
91
92
# File 'lib/chef/resource/lwrp_base.rb', line 86

def self.default_action(action_name=NULL_ARG)
  unless action_name.equal?(NULL_ARG)
    valid_actions.push(action_name)
    @default_action = action_name
  end
  @default_action
end

.nodeObject



113
114
115
# File 'lib/chef/resource/lwrp_base.rb', line 113

def self.node
  run_context.node
end

.resource_nameObject

Returns the resource snake_case name



64
65
66
# File 'lib/chef/resource/lwrp_base.rb', line 64

def self.resource_name
  @resource_name
end

.resource_name=(resource_name) ⇒ Object

Set the resource snake_case name. Should only be called via build_from_file.



59
60
61
# File 'lib/chef/resource/lwrp_base.rb', line 59

def self.resource_name=(resource_name)
  @resource_name = resource_name
end

.run_contextObject



109
110
111
# File 'lib/chef/resource/lwrp_base.rb', line 109

def self.run_context
  @run_context
end

.run_context=(run_context) ⇒ Object

Set the run context on the class. Used to provide access to the node during class definition.



105
106
107
# File 'lib/chef/resource/lwrp_base.rb', line 105

def self.run_context=(run_context)
  @run_context = run_context
end

.valid_actionsObject



99
100
101
# File 'lib/chef/resource/lwrp_base.rb', line 99

def self.valid_actions
  @valid_actions ||= []
end