Module: ChefSpec::API::EasyInstallPackageMatchers

Defined in:
lib/chefspec/api/easy_install_package.rb

Overview

Since:

  • 3.0.0

Instance Method Summary collapse

Instance Method Details

#install_easy_install_package(resource_name) ⇒ ChefSpec::Matchers::ResourceMatcher

Assert that an easy_install_package resource exists in the Chef run with the action :install. Given a Chef Recipe that installs “pygments” as a easy_install_package:

easy_install_package 'pygments' do
  action :install
end

The Examples section demonstrates the different ways to test a easy_install_package resource with ChefSpec.

Examples:

Assert that an easy_install_package was installed

expect(chef_run).to install_easy_install_package('pygments')

Assert that an easy_install_package was installed with predicate matchers

expect(chef_run).to install_easy_install_package('pygments').with_version('1.2.3')

Assert that an easy_install_package was installed with attributes

expect(chef_run).to install_easy_install_package('pygments').with(version: '1.2.3')

Assert that an easy_install_package was installed using a regex

expect(chef_run).to install_easy_install_package('pygments').with(version: /(\d+\.){2}\.\d+/)

Assert that an easy_install_package was not installed

expect(chef_run).to_not install_easy_install_package('pygments')

Parameters:

  • resource_name (String, Regex)

    the name of the resource to match

Returns:

Since:

  • 3.0.0


39
40
41
# File 'lib/chefspec/api/easy_install_package.rb', line 39

def install_easy_install_package(resource_name)
  ChefSpec::Matchers::ResourceMatcher.new(:easy_install_package, :install, resource_name)
end

#purge_easy_install_package(resource_name) ⇒ ChefSpec::Matchers::ResourceMatcher

Assert that an easy_install_package resource exists in the Chef run with the action :purge. Given a Chef Recipe that purges “pygments” as a easy_install_package:

easy_install_package 'pygments' do
  action :purge
end

The Examples section demonstrates the different ways to test a easy_install_package resource with ChefSpec.

Examples:

Assert that an easy_install_package was purged

expect(chef_run).to purge_easy_install_package('pygments')

Assert that an easy_install_package was purged with predicate matchers

expect(chef_run).to purge_easy_install_package('pygments').with_version('1.2.3')

Assert that an easy_install_package was purged with attributes

expect(chef_run).to purge_easy_install_package('pygments').with(version: '1.2.3')

Assert that an easy_install_package was purged using a regex

expect(chef_run).to purge_easy_install_package('pygments').with(version: /(\d+\.){2}\.\d+/)

Assert that an easy_install_package was not purged

expect(chef_run).to_not purge_easy_install_package('pygments')

Parameters:

  • resource_name (String, Regex)

    the name of the resource to match

Returns:

Since:

  • 3.0.0


76
77
78
# File 'lib/chefspec/api/easy_install_package.rb', line 76

def purge_easy_install_package(resource_name)
  ChefSpec::Matchers::ResourceMatcher.new(:easy_install_package, :purge, resource_name)
end

#remove_easy_install_package(resource_name) ⇒ ChefSpec::Matchers::ResourceMatcher

Assert that an easy_install_package resource exists in the Chef run with the action :remove. Given a Chef Recipe that removes “pygments” as a easy_install_package:

easy_install_package 'pygments' do
  action :remove
end

The Examples section demonstrates the different ways to test a easy_install_package resource with ChefSpec.

Examples:

Assert that an easy_install_package was removed

expect(chef_run).to remove_easy_install_package('pygments')

Assert that an easy_install_package was removed with predicate matchers

expect(chef_run).to remove_easy_install_package('pygments').with_version('1.2.3')

Assert that an easy_install_package was removed with attributes

expect(chef_run).to remove_easy_install_package('pygments').with(version: '1.2.3')

Assert that an easy_install_package was removed using a regex

expect(chef_run).to remove_easy_install_package('pygments').with(version: /(\d+\.){2}\.\d+/)

Assert that an easy_install_package was not removed

expect(chef_run).to_not remove_easy_install_package('pygments')

Parameters:

  • resource_name (String, Regex)

    the name of the resource to match

Returns:

Since:

  • 3.0.0


113
114
115
# File 'lib/chefspec/api/easy_install_package.rb', line 113

def remove_easy_install_package(resource_name)
  ChefSpec::Matchers::ResourceMatcher.new(:easy_install_package, :remove, resource_name)
end

#upgrade_easy_install_package(resource_name) ⇒ ChefSpec::Matchers::ResourceMatcher

Assert that an easy_install_package resource exists in the Chef run with the action :upgrade. Given a Chef Recipe that upgrades “pygments” as a easy_install_package:

easy_install_package 'pygments' do
  action :upgrade
end

The Examples section demonstrates the different ways to test a easy_install_package resource with ChefSpec.

Examples:

Assert that an easy_install_package was upgraded

expect(chef_run).to upgrade_easy_install_package('pygments')

Assert that an easy_install_package was upgraded with predicate matchers

expect(chef_run).to upgrade_easy_install_package('pygments').with_version('1.2.3')

Assert that an easy_install_package was upgraded with attributes

expect(chef_run).to upgrade_easy_install_package('pygments').with(version: '1.2.3')

Assert that an easy_install_package was upgraded using a regex

expect(chef_run).to upgrade_easy_install_package('pygments').with(version: /(\d+\.){2}\.\d+/)

Assert that an easy_install_package was not upgraded

expect(chef_run).to_not upgrade_easy_install_package('pygments')

Parameters:

  • resource_name (String, Regex)

    the name of the resource to match

Returns:

Since:

  • 3.0.0


150
151
152
# File 'lib/chefspec/api/easy_install_package.rb', line 150

def upgrade_easy_install_package(resource_name)
  ChefSpec::Matchers::ResourceMatcher.new(:easy_install_package, :upgrade, resource_name)
end