Class: Chef::CookbookCollection

Inherits:
Mash
  • Object
show all
Defined in:
lib/chef/cookbook/cookbook_collection.rb

Overview

Chef::CookbookCollection

This class is the consistent interface for a node to obtain its cookbooks by name.

This class is basically a glorified Hash, but since there are several ways this cookbook information is collected, (e.g. CookbookLoader for solo, hash of auto-vivified Cookbook objects for lazily-loaded remote cookbooks), it gets transformed into this.

Instance Method Summary collapse

Methods inherited from Mash

#[]=, #default, #delete, #except, #fetch, from_hash, #initialize_copy, #internal_set, #key?, #merge, #regular_update, #regular_writer, #stringify_keys!, #symbolize_keys, #to_hash, #update, #values_at

Constructor Details

#initialize(cookbook_versions = {}) ⇒ CookbookCollection

The input is a mapping of cookbook name to CookbookVersion objects. We simply extract them


36
37
38
39
40
41
42
# File 'lib/chef/cookbook/cookbook_collection.rb', line 36

def initialize(cookbook_versions = {})
  super() do |hash, key|
    raise Chef::Exceptions::CookbookNotFound, "Cookbook #{key} not found. " <<
      "If you're loading #{key} from another cookbook, make sure you configure the dependency in your metadata"
  end
  cookbook_versions.each { |cookbook_name, cookbook_version| self[cookbook_name] = cookbook_version }
end

Instance Method Details

#install_gems(events) ⇒ Object


58
59
60
# File 'lib/chef/cookbook/cookbook_collection.rb', line 58

def install_gems(events)
  Cookbook::GemInstaller.new(self, events).install
end

#validate!Object

Validates that the cookbook metadata allows it to run on this instance.

Currently checks chef_version and ohai_version in the cookbook metadata against the running Chef::VERSION and Ohai::VERSION.

Raises:


51
52
53
54
55
56
# File 'lib/chef/cookbook/cookbook_collection.rb', line 51

def validate!
  each_value do |cookbook_version|
    cookbook_version..validate_chef_version!
    cookbook_version..validate_ohai_version!
  end
end