class Chef::CookbookCollection

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.

Public Class Methods

new(cookbook_versions = {}) click to toggle source

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

Calls superclass method Mash.new
# File lib/chef/cookbook/cookbook_collection.rb, line 37
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

Public Instance Methods

install_gems(events) click to toggle source
# File lib/chef/cookbook/cookbook_collection.rb, line 59
def install_gems(events)
  Cookbook::GemInstaller.new(self, events).install
end
validate!() click to toggle source

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.

@raise [Chef::Exceptions::CookbookChefVersionMismatch] if the Chef::VERSION fails validation @raise [Chef::Exceptions::CookbookOhaiVersionMismatch] if the Ohai::VERSION fails validation

# File lib/chef/cookbook/cookbook_collection.rb, line 52
def validate!
  each_value do |cookbook_version|
    cookbook_version.metadata.validate_chef_version!
    cookbook_version.metadata.validate_ohai_version!
  end
end