chefspec 2.0.1 → 3.0.0.beta.1

data/lib/chefspec/api/http_request.rb

@@ -0,0 +1,228 @@
+module ChefSpec::API
+  # @since 3.0.0
+  module HttpRequestMatchers
+    ChefSpec::Runner.define_runner_method :http_request
+
+    #
+    # Assert that an +http_request+ resource exists in the Chef run with the
+    # action +:delete+. Given a Chef Recipe that deletes "apache2" as an
+    # +http_request+:
+    #
+    #     http_request 'apache2' do
+    #       action :delete
+    #     end
+    #
+    # The Examples section demonstrates the different ways to test an
+    # +http_request+ resource with ChefSpec.
+    #
+    # @example Assert that an +http_request+ was DELETE
+    #   expect(chef_run).to delete_http_request('apache2')
+    #
+    # @example Assert that an +http_request+ was DELETE with predicate matchers
+    #   expect(chef_run).to delete_http_request('apache2').with_message('hello')
+    #
+    # @example Assert that an +http_request+ was DELETE with attributes
+    #   expect(chef_run).to delete_http_request('apache2').with(message: 'hello')
+    #
+    # @example Assert that an +http_request+ was DELETE using a regex
+    #   expect(chef_run).to delete_http_request('apache2').with(message: /he(.+)/)
+    #
+    # @example Assert that an +http_request+ was _not_ DELETE
+    #   expect(chef_run).to_not delete_http_request('apache2')
+    #
+    #
+    # @param [String, Regex] resource_name
+    #   the name of the resource to match
+    #
+    # @return [ChefSpec::Matchers::ResourceMatcher]
+    #
+    def delete_http_request(resource_name)
+      ChefSpec::Matchers::ResourceMatcher.new(:http_request, :delete, resource_name)
+    end
+
+    #
+    # Assert that an +http_request+ resource exists in the Chef run with the
+    # action +:get+. Given a Chef Recipe that gets "apache2" as an
+    # +http_request+:
+    #
+    #     http_request 'apache2' do
+    #       action :get
+    #     end
+    #
+    # The Examples section demonstrates the different ways to test an
+    # +http_request+ resource with ChefSpec.
+    #
+    # @example Assert that an +http_request+ was GET
+    #   expect(chef_run).to get_http_request('apache2')
+    #
+    # @example Assert that an +http_request+ was GET with predicate matchers
+    #   expect(chef_run).to get_http_request('apache2').with_message('hello')
+    #
+    # @example Assert that an +http_request+ was GET with attributes
+    #   expect(chef_run).to get_http_request('apache2').with(message: 'hello')
+    #
+    # @example Assert that an +http_request+ was GET using a regex
+    #   expect(chef_run).to get_http_request('apache2').with(message: /he(.+)/)
+    #
+    # @example Assert that an +http_request+ was _not_ GET
+    #   expect(chef_run).to_not get_http_request('apache2')
+    #
+    #
+    # @param [String, Regex] resource_name
+    #   the name of the resource to match
+    #
+    # @return [ChefSpec::Matchers::ResourceMatcher]
+    #
+    def get_http_request(resource_name)
+      ChefSpec::Matchers::ResourceMatcher.new(:http_request, :get, resource_name)
+    end
+
+    #
+    # Assert that an +http_request+ resource exists in the Chef run with the
+    # action +:head+. Given a Chef Recipe that heads "apache2" as an
+    # +http_request+:
+    #
+    #     http_request 'apache2' do
+    #       action :head
+    #     end
+    #
+    # The Examples section demonstrates the different ways to test an
+    # +http_request+ resource with ChefSpec.
+    #
+    # @example Assert that an +http_request+ was HEAD
+    #   expect(chef_run).to head_http_request('apache2')
+    #
+    # @example Assert that an +http_request+ was HEAD with predicate matchers
+    #   expect(chef_run).to head_http_request('apache2').with_message('hello')
+    #
+    # @example Assert that an +http_request+ was HEAD with attributes
+    #   expect(chef_run).to head_http_request('apache2').with(message: 'hello')
+    #
+    # @example Assert that an +http_request+ was HEAD using a regex
+    #   expect(chef_run).to head_http_request('apache2').with(message: /he(.+)/)
+    #
+    # @example Assert that an +http_request+ was _not_ HEAD
+    #   expect(chef_run).to_not head_http_request('apache2')
+    #
+    #
+    # @param [String, Regex] resource_name
+    #   the name of the resource to match
+    #
+    # @return [ChefSpec::Matchers::ResourceMatcher]
+    #
+    def head_http_request(resource_name)
+      ChefSpec::Matchers::ResourceMatcher.new(:http_request, :head, resource_name)
+    end
+
+    #
+    # Assert that an +http_request+ resource exists in the Chef run with the
+    # action +:options+. Given a Chef Recipe that optionss "apache2" as an
+    # +http_request+:
+    #
+    #     http_request 'apache2' do
+    #       action :options
+    #     end
+    #
+    # The Examples section demonstrates the different ways to test an
+    # +http_request+ resource with ChefSpec.
+    #
+    # @example Assert that an +http_request+ was OPTIONS
+    #   expect(chef_run).to options_http_request('apache2')
+    #
+    # @example Assert that an +http_request+ was OPTIONS with predicate matchers
+    #   expect(chef_run).to options_http_request('apache2').with_message('hello')
+    #
+    # @example Assert that an +http_request+ was OPTIONS with attributes
+    #   expect(chef_run).to options_http_request('apache2').with(message: 'hello')
+    #
+    # @example Assert that an +http_request+ was OPTIONS using a regex
+    #   expect(chef_run).to options_http_request('apache2').with(message: /he(.+)/)
+    #
+    # @example Assert that an +http_request+ was _not_ OPTIONS
+    #   expect(chef_run).to_not options_http_request('apache2')
+    #
+    #
+    # @param [String, Regex] resource_name
+    #   the name of the resource to match
+    #
+    # @return [ChefSpec::Matchers::ResourceMatcher]
+    #
+    def options_http_request(resource_name)
+      ChefSpec::Matchers::ResourceMatcher.new(:http_request, :options, resource_name)
+    end
+
+    #
+    # Assert that an +http_request+ resource exists in the Chef run with the
+    # action +:post+. Given a Chef Recipe that posts "apache2" as an
+    # +http_request+:
+    #
+    #     http_request 'apache2' do
+    #       action :post
+    #     end
+    #
+    # The Examples section demonstrates the different ways to test an
+    # +http_request+ resource with ChefSpec.
+    #
+    # @example Assert that an +http_request+ was POST
+    #   expect(chef_run).to post_http_request('apache2')
+    #
+    # @example Assert that an +http_request+ was POST with predicate matchers
+    #   expect(chef_run).to post_http_request('apache2').with_message('hello')
+    #
+    # @example Assert that an +http_request+ was POST with attributes
+    #   expect(chef_run).to post_http_request('apache2').with(message: 'hello')
+    #
+    # @example Assert that an +http_request+ was POST using a regex
+    #   expect(chef_run).to post_http_request('apache2').with(message: /he(.+)/)
+    #
+    # @example Assert that an +http_request+ was _not_ POST
+    #   expect(chef_run).to_not post_http_request('apache2')
+    #
+    #
+    # @param [String, Regex] resource_name
+    #   the name of the resource to match
+    #
+    # @return [ChefSpec::Matchers::ResourceMatcher]
+    #
+    def post_http_request(resource_name)
+      ChefSpec::Matchers::ResourceMatcher.new(:http_request, :post, resource_name)
+    end
+
+    #
+    # Assert that an +http_request+ resource exists in the Chef run with the
+    # action +:put+. Given a Chef Recipe that puts "apache2" as an
+    # +http_request+:
+    #
+    #     http_request 'apache2' do
+    #       action :put
+    #     end
+    #
+    # The Examples section demonstrates the different ways to test an
+    # +http_request+ resource with ChefSpec.
+    #
+    # @example Assert that an +http_request+ was PUT
+    #   expect(chef_run).to put_http_request('apache2')
+    #
+    # @example Assert that an +http_request+ was PUT with predicate matchers
+    #   expect(chef_run).to put_http_request('apache2').with_message('hello')
+    #
+    # @example Assert that an +http_request+ was PUT with attributes
+    #   expect(chef_run).to put_http_request('apache2').with(message: 'hello')
+    #
+    # @example Assert that an +http_request+ was PUT using a regex
+    #   expect(chef_run).to put_http_request('apache2').with(message: /he(.+)/)
+    #
+    # @example Assert that an +http_request+ was _not_ PUT
+    #   expect(chef_run).to_not put_http_request('apache2')
+    #
+    #
+    # @param [String, Regex] resource_name
+    #   the name of the resource to match
+    #
+    # @return [ChefSpec::Matchers::ResourceMatcher]
+    #
+    def put_http_request(resource_name)
+      ChefSpec::Matchers::ResourceMatcher.new(:http_request, :put, resource_name)
+    end
+  end
+end

data/lib/chefspec/api/ifconfig.rb

@@ -0,0 +1,154 @@
+module ChefSpec::API
+  # @since 3.0.0
+  module IfconfigMatchers
+    ChefSpec::Runner.define_runner_method :ifconfig
+
+    #
+    # Assert that an +ifconfig+ resource exists in the Chef run with the
+    # action +:add+. Given a Chef Recipe that adds "10.0.0.1" as an
+    # +ifconfig+:
+    #
+    #     ifconfig '10.0.0.1' do
+    #       action :add
+    #     end
+    #
+    # The Examples section demonstrates the different ways to test an
+    # +ifconfig+ resource with ChefSpec.
+    #
+    # @example Assert that an +ifconfig+ was added
+    #   expect(chef_run).to add_ifconfig('10.0.0.1')
+    #
+    # @example Assert that an +ifconfig+ was added with predicate matchers
+    #   expect(chef_run).to add_ifconfig('10.0.0.1').with_device('eth0')
+    #
+    # @example Assert that an +ifconfig+ was added with attributes
+    #   expect(chef_run).to add_ifconfig('10.0.0.1').with(device: 'eth0')
+    #
+    # @example Assert that an +ifconfig+ was added using a regex
+    #   expect(chef_run).to add_ifconfig('10.0.0.1').with(device: /eth(\d+)/)
+    #
+    # @example Assert that an +ifconfig+ was _not_ added
+    #   expect(chef_run).to_not add_ifconfig('10.0.0.1')
+    #
+    #
+    # @param [String, Regex] resource_name
+    #   the name of the resource to match
+    #
+    # @return [ChefSpec::Matchers::ResourceMatcher]
+    #
+    def add_ifconfig(resource_name)
+      ChefSpec::Matchers::ResourceMatcher.new(:ifconfig, :add, resource_name)
+    end
+
+    #
+    # Assert that an +ifconfig+ resource exists in the Chef run with the
+    # action +:delete+. Given a Chef Recipe that deletes "10.0.0.1" as an
+    # +ifconfig+:
+    #
+    #     ifconfig '10.0.0.1' do
+    #       action :delete
+    #     end
+    #
+    # The Examples section demonstrates the different ways to test an
+    # +ifconfig+ resource with ChefSpec.
+    #
+    # @example Assert that an +ifconfig+ was deleted
+    #   expect(chef_run).to delete_ifconfig('10.0.0.1')
+    #
+    # @example Assert that an +ifconfig+ was deleted with predicate matchers
+    #   expect(chef_run).to delete_ifconfig('10.0.0.1').with_device('eth0')
+    #
+    # @example Assert that an +ifconfig+ was deleted with attributes
+    #   expect(chef_run).to delete_ifconfig('10.0.0.1').with(device: 'eth0')
+    #
+    # @example Assert that an +ifconfig+ was deleted using a regex
+    #   expect(chef_run).to delete_ifconfig('10.0.0.1').with(device: /eth(\d+)/)
+    #
+    # @example Assert that an +ifconfig+ was _not_ deleted
+    #   expect(chef_run).to_not delete_ifconfig('10.0.0.1')
+    #
+    #
+    # @param [String, Regex] resource_name
+    #   the name of the resource to match
+    #
+    # @return [ChefSpec::Matchers::ResourceMatcher]
+    #
+    def delete_ifconfig(resource_name)
+      ChefSpec::Matchers::ResourceMatcher.new(:ifconfig, :delete, resource_name)
+    end
+
+    #
+    # Assert that an +ifconfig+ resource exists in the Chef run with the
+    # action +:disable+. Given a Chef Recipe that disables "10.0.0.1" as an
+    # +ifconfig+:
+    #
+    #     ifconfig '10.0.0.1' do
+    #       action :disable
+    #     end
+    #
+    # The Examples section demonstrates the different ways to test an
+    # +ifconfig+ resource with ChefSpec.
+    #
+    # @example Assert that an +ifconfig+ was disabled
+    #   expect(chef_run).to disable_ifconfig('10.0.0.1')
+    #
+    # @example Assert that an +ifconfig+ was disabled with predicate matchers
+    #   expect(chef_run).to disable_ifconfig('10.0.0.1').with_device('eth0')
+    #
+    # @example Assert that an +ifconfig+ was disabled with attributes
+    #   expect(chef_run).to disable_ifconfig('10.0.0.1').with(device: 'eth0')
+    #
+    # @example Assert that an +ifconfig+ was disabled using a regex
+    #   expect(chef_run).to disable_ifconfig('10.0.0.1').with(device: /eth(\d+)/)
+    #
+    # @example Assert that an +ifconfig+ was _not_ disabled
+    #   expect(chef_run).to_not disable_ifconfig('10.0.0.1')
+    #
+    #
+    # @param [String, Regex] resource_name
+    #   the name of the resource to match
+    #
+    # @return [ChefSpec::Matchers::ResourceMatcher]
+    #
+    def disable_ifconfig(resource_name)
+      ChefSpec::Matchers::ResourceMatcher.new(:ifconfig, :disable, resource_name)
+    end
+
+    #
+    # Assert that an +ifconfig+ resource exists in the Chef run with the
+    # action +:enable+. Given a Chef Recipe that enables "10.0.0.1" as an
+    # +ifconfig+:
+    #
+    #     ifconfig '10.0.0.1' do
+    #       action :enable
+    #     end
+    #
+    # The Examples section demonstrates the different ways to test an
+    # +ifconfig+ resource with ChefSpec.
+    #
+    # @example Assert that an +ifconfig+ was enabled
+    #   expect(chef_run).to enable_ifconfig('10.0.0.1')
+    #
+    # @example Assert that an +ifconfig+ was enabled with predicate matchers
+    #   expect(chef_run).to enable_ifconfig('10.0.0.1').with_device('eth0')
+    #
+    # @example Assert that an +ifconfig+ was enabled with attributes
+    #   expect(chef_run).to enable_ifconfig('10.0.0.1').with(device: 'eth0')
+    #
+    # @example Assert that an +ifconfig+ was enabled using a regex
+    #   expect(chef_run).to enable_ifconfig('10.0.0.1').with(device: /eth(\d+)/)
+    #
+    # @example Assert that an +ifconfig+ was _not_ enabled
+    #   expect(chef_run).to_not enable_ifconfig('10.0.0.1')
+    #
+    #
+    # @param [String, Regex] resource_name
+    #   the name of the resource to match
+    #
+    # @return [ChefSpec::Matchers::ResourceMatcher]
+    #
+    def enable_ifconfig(resource_name)
+      ChefSpec::Matchers::ResourceMatcher.new(:ifconfig, :enable, resource_name)
+    end
+  end
+end

data/lib/chefspec/api/include_recipe.rb

@@ -0,0 +1,26 @@
+module ChefSpec::API
+  # @since 0.2.1
+  module IncludeRecipeMatchers
+    #
+    # Assert that a Chef run includes a certain recipe. Given a Chef Recipe
+    # that calls +include_recipe+:
+    #
+    #     include_recipe 'apache2::default'
+    #
+    # The Examples section demonstrates the different ways to test an
+    # +include_recipe+ directive with ChefSpec.
+    #
+    # @example Assert the +apache2::default+ recipe is included in the Chef run
+    #   expect(chef_run).to include_recipe('apache2::default')
+    #
+    #
+    # @param [String] recipe_name
+    #   the name of the recipe to be included
+    #
+    # @return [ChefSpec::Matchers::IncludeRecipeMatcher]
+    #
+    def include_recipe(recipe_name)
+      ChefSpec::Matchers::IncludeRecipeMatcher.new(recipe_name)
+    end
+  end
+end

data/lib/chefspec/api/ips_package.rb

@@ -0,0 +1,117 @@
+module ChefSpec::API
+  # @since 3.0.0
+  module IpsPackageMatchers
+    ChefSpec::Runner.define_runner_method :ips_package
+
+    #
+    # Assert that an +ips_package+ resource exists in the Chef run with the
+    # action +:install+. Given a Chef Recipe that installs "apache2" as an
+    # +ips_package+:
+    #
+    #     ips_package 'apache2' do
+    #       action :install
+    #     end
+    #
+    # The Examples section demonstrates the different ways to test an
+    # +ips_package+ resource with ChefSpec.
+    #
+    # @example Assert that an +ips_package+ was installed
+    #   expect(chef_run).to install_ips_package('apache2')
+    #
+    # @example Assert that an +ips_package+ was installed with predicate matchers
+    #   expect(chef_run).to install_ips_package('apache2').with_version('1.2.3')
+    #
+    # @example Assert that an +ips_package+ was installed with attributes
+    #   expect(chef_run).to install_ips_package('apache2').with(version: '1.2.3')
+    #
+    # @example Assert that an +ips_package+ was installed using a regex
+    #   expect(chef_run).to install_ips_package('apache2').with(version: /(\d+\.){2}\.\d+/)
+    #
+    # @example Assert that an +ips_package+ was _not_ installed
+    #   expect(chef_run).to_not install_ips_package('apache2')
+    #
+    #
+    # @param [String, Regex] resource_name
+    #   the name of the resource to match
+    #
+    # @return [ChefSpec::Matchers::ResourceMatcher]
+    #
+    def install_ips_package(resource_name)
+      ChefSpec::Matchers::ResourceMatcher.new(:ips_package, :install, resource_name)
+    end
+
+    #
+    # Assert that an +ips_package+ resource exists in the Chef run with the
+    # action +:remove+. Given a Chef Recipe that removes "apache2" as an
+    # +ips_package+:
+    #
+    #     ips_package 'apache2' do
+    #       action :remove
+    #     end
+    #
+    # The Examples section demonstrates the different ways to test an
+    # +ips_package+ resource with ChefSpec.
+    #
+    # @example Assert that an +ips_package+ was removed
+    #   expect(chef_run).to remove_ips_package('apache2')
+    #
+    # @example Assert that an +ips_package+ was removed with predicate matchers
+    #   expect(chef_run).to remove_ips_package('apache2').with_version('1.2.3')
+    #
+    # @example Assert that an +ips_package+ was removed with attributes
+    #   expect(chef_run).to remove_ips_package('apache2').with(version: '1.2.3')
+    #
+    # @example Assert that an +ips_package+ was removed using a regex
+    #   expect(chef_run).to remove_ips_package('apache2').with(version: /(\d+\.){2}\.\d+/)
+    #
+    # @example Assert that an +ips_package+ was _not_ removed
+    #   expect(chef_run).to_not remove_ips_package('apache2')
+    #
+    #
+    # @param [String, Regex] resource_name
+    #   the name of the resource to match
+    #
+    # @return [ChefSpec::Matchers::ResourceMatcher]
+    #
+    def remove_ips_package(resource_name)
+      ChefSpec::Matchers::ResourceMatcher.new(:ips_package, :remove, resource_name)
+    end
+
+    #
+    # Assert that an +ips_package+ resource exists in the Chef run with the
+    # action +:upgrade+. Given a Chef Recipe that upgrades "apache2" as an
+    # +ips_package+:
+    #
+    #     ips_package 'apache2' do
+    #       action :upgrade
+    #     end
+    #
+    # The Examples section demonstrates the different ways to test an
+    # +ips_package+ resource with ChefSpec.
+    #
+    # @example Assert that an +ips_package+ was upgradeed
+    #   expect(chef_run).to upgrade_ips_package('apache2')
+    #
+    # @example Assert that an +ips_package+ was upgradeed with predicate matchers
+    #   expect(chef_run).to upgrade_ips_package('apache2').with_version('1.2.3')
+    #
+    # @example Assert that an +ips_package+ was upgradeed with attributes
+    #   expect(chef_run).to upgrade_ips_package('apache2').with(version: '1.2.3')
+    #
+    # @example Assert that an +ips_package+ was upgradeed using a regex
+    #   expect(chef_run).to upgrade_ips_package('apache2').with(version: /(\d+\.){2}\.\d+/)
+    #
+    # @example Assert that an +ips_package+ was _not_ upgradeed
+    #   expect(chef_run).to_not upgrade_ips_package('apache2')
+    #
+    #
+    # @param [String, Regex] resource_name
+    #   the name of the resource to match
+    #
+    # @return [ChefSpec::Matchers::ResourceMatcher]
+    #
+    def upgrade_ips_package(resource_name)
+      ChefSpec::Matchers::ResourceMatcher.new(:ips_package, :upgrade, resource_name)
+    end
+  end
+end