#-- # Author:: Adam Jacob () # Author:: Christopher Walters () # Copyright:: Copyright 2008-2016, Chef Software Inc. # License:: Apache License, Version 2.0 # # Licensed under the Apache License, Version 2.0 (the "License"); # you may not use this file except in compliance with the License. # You may obtain a copy of the License at # # http://www.apache.org/licenses/LICENSE-2.0 # # Unless required by applicable law or agreed to in writing, software # distributed under the License is distributed on an "AS IS" BASIS, # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. # See the License for the specific language governing permissions and # limitations under the License. # require "chef/dsl/recipe" require "chef/dsl/data_query" require "chef/dsl/platform_introspection" require "chef/dsl/include_recipe" require "chef/dsl/registry_helper" require "chef/dsl/reboot_pending" require "chef/dsl/audit" require "chef/dsl/powershell" require "chef/mixin/from_file" require "chef/mixin/deprecation" class Chef # == Chef::Recipe # A Recipe object is the context in which Chef recipes are evaluated. class Recipe include Chef::DSL::Recipe::FullDSL include Chef::Mixin::FromFile include Chef::Mixin::Deprecation attr_accessor :cookbook_name, :recipe_name, :recipe, :params, :run_context # Parses a potentially fully-qualified recipe name into its # cookbook name and recipe short name. # # For example: # "aws::elastic_ip" returns [:aws, "elastic_ip"] # "aws" returns [:aws, "default"] # "::elastic_ip" returns [ current_cookbook, "elastic_ip" ] #-- # TODO: Duplicates functionality of RunListItem def self.parse_recipe_name(recipe_name, current_cookbook: nil) case recipe_name when /(.+?)::(.+)/ [ $1.to_sym, $2 ] when /^::(.+)/ raise "current_cookbook is nil, cannot resolve #{recipe_name}" if current_cookbook.nil? [ current_cookbook.to_sym, $1 ] else [ recipe_name.to_sym, "default" ] end end def initialize(cookbook_name, recipe_name, run_context) @cookbook_name = cookbook_name @recipe_name = recipe_name @run_context = run_context # TODO: 5/19/2010 cw/tim: determine whether this can be removed @params = Hash.new end # Used in DSL mixins def node run_context.node end # Used by the DSL to look up resources when executing in the context of a # recipe. def resources(*args) run_context.resource_collection.find(*args) end # This was moved to Chef::Node#tag, redirecting here for compatibility def tag(*tags) run_context.node.tag(*tags) end # Returns true if the node is tagged with *all* of the supplied +tags+. # # === Parameters # tags:: A list of tags # # === Returns # true:: If all the parameters are present # false:: If any of the parameters are missing def tagged?(*tags) tags.each do |tag| return false unless run_context.node.tags.include?(tag) end true end # Removes the list of tags from the node. # # === Parameters # tags:: A list of tags # # === Returns # tags:: The current list of run_context.node.tags def untag(*tags) tags.each do |tag| run_context.node.tags.delete(tag) end end end end