# File lib/chef/provider.rb, line 181 def build_from_file(cookbook_name, filename, run_context) pname = filename_to_qualified_string(cookbook_name, filename) # Add log entry if we override an existing light-weight provider. class_name = convert_to_class_name(pname) overriding = Chef::Provider.const_defined?(class_name) Chef::Log.info("#{class_name} light-weight provider already initialized -- overriding!") if overriding new_provider_class = Class.new self do |cls| include Chef::Mixin::RecipeDefinitionDSLCore def load_current_resource # silence Chef::Exceptions::Override exception end class << cls include Chef::Mixin::FromFile # setup DSL's shortcut methods def action(name, &block) define_method("action_#{name.to_s}") do instance_eval(&block) end end end # load provider definition from file cls.class_from_file(filename) end # register new class as a Chef::Provider pname = filename_to_qualified_string(cookbook_name, filename) class_name = convert_to_class_name(pname) Chef::Provider.const_set(class_name, new_provider_class) Chef::Log.debug("Loaded contents of #{filename} into a provider named #{pname} defined in Chef::Provider::#{class_name}") new_provider_class end
# File lib/chef/provider.rb, line 81 def action_nothing Chef::Log.debug("Doing nothing for #{@new_resource.to_s}") true end
# File lib/chef/provider.rb, line 78 def cleanup_after_converge end
# File lib/chef/provider.rb, line 67 def cookbook_name new_resource.cookbook_name end
# File lib/chef/provider.rb, line 75 def define_resource_requirements end
# File lib/chef/provider.rb, line 86 def events run_context.events end
# File lib/chef/provider.rb, line 71 def load_current_resource raise Chef::Exceptions::Override, "You must override load_current_resource in #{self.to_s}" end
# File lib/chef/provider.rb, line 58 def node run_context && run_context.node end
# File lib/chef/provider.rb, line 127 def process_resource_requirements requirements.run(:all_actions) unless @action == :nothing requirements.run(@action) end
# File lib/chef/provider.rb, line 141 def requirements @requirements ||= ResourceRequirements.new(@new_resource, run_context) end
Used by providers supporting embedded recipes
# File lib/chef/provider.rb, line 63 def resource_collection run_context && run_context.resource_collection end
# File lib/chef/provider.rb, line 90 def run_action(action=nil) @action = action unless action.nil? # TODO: it would be preferable to get the action to be executed in the # constructor... # user-defined LWRPs may include unsafe load_current_resource methods that cannot be run in whyrun mode if !whyrun_mode? || whyrun_supported? load_current_resource events.resource_current_state_loaded(@new_resource, @action, @current_resource) elsif whyrun_mode? && !whyrun_supported? events.resource_current_state_load_bypassed(@new_resource, @action, @current_resource) end define_resource_requirements process_resource_requirements # user-defined providers including LWRPs may # not include whyrun support - if they don't support it # we can't execute any actions while we're running in # whyrun mode. Instead we 'fake' whyrun by documenting that # we can't execute the action. # in non-whyrun mode, this will still cause the action to be # executed normally. if whyrun_supported? && !requirements.action_blocked?(@action) send("action_#{@action}") elsif whyrun_mode? events.resource_bypassed(@new_resource, @action, self) else send("action_#{@action}") end set_updated_status cleanup_after_converge end
# File lib/chef/provider.rb, line 132 def set_updated_status if converge_actions.empty? && !@new_resource.updated_by_last_action? events.resource_up_to_date(@new_resource, @action) else events.resource_updated(@new_resource, @action) new_resource.updated_by_last_action(true) end end
# File lib/chef/provider.rb, line 147 def converge_actions @converge_actions ||= ConvergeActions.new(@new_resource, run_context, @action) end
# File lib/chef/provider.rb, line 151 def converge_by(descriptions, &block) converge_actions.add_action(descriptions, &block) end
# File lib/chef/provider.rb, line 156 def recipe_eval(&block) # This block has new resource definitions within it, which # essentially makes it an in-line Chef run. Save our current # run_context and create one anew, so the new Chef run only # executes the embedded resources. # # TODO: timh,cw: 2010-5-14: This means that the resources within # this block cannot interact with resources outside, e.g., # manipulating notifies. converge_by ("would evaluate block and run any associated actions") do saved_run_context = @run_context @run_context = @run_context.dup @run_context.resource_collection = Chef::ResourceCollection.new instance_eval(&block) Chef::Runner.new(@run_context).converge @run_context = saved_run_context end end
Generated with the Darkfish Rdoc Generator 2.