chefspec 7.0.0 → 7.1.0

data/lib/chefspec/api/group.rb

@@ -1,154 +0,0 @@
-module ChefSpec::API
-  # @since 1.0.0
-  module GroupMatchers
-    ChefSpec.define_matcher :group
-
-    #
-    # Assert that a +group+ resource exists in the Chef run with the
-    # action +:create+. Given a Chef Recipe that creates "apache2" as a
-    # +group+:
-    #
-    #     group 'apache2' do
-    #       action :create
-    #     end
-    #
-    # The Examples section demonstrates the different ways to test a
-    # +group+ resource with ChefSpec.
-    #
-    # @example Assert that a +group+ was created
-    #   expect(chef_run).to create_group('apache2')
-    #
-    # @example Assert that a +group+ was created with predicate matchers
-    #   expect(chef_run).to create_group('apache2').with_gid(1234)
-    #
-    # @example Assert that a +group+ was created with attributes
-    #   expect(chef_run).to create_group('apache2').with(gid: 1234)
-    #
-    # @example Assert that a +group+ was created using a regex
-    #   expect(chef_run).to create_group('apache2').with(gid: /\d+/)
-    #
-    # @example Assert that a +group+ was _not_ created
-    #   expect(chef_run).to_not create_group('apache2')
-    #
-    #
-    # @param [String, Regex] resource_name
-    #   the name of the resource to match
-    #
-    # @return [ChefSpec::Matchers::ResourceMatcher]
-    #
-    def create_group(resource_name)
-      ChefSpec::Matchers::ResourceMatcher.new(:group, :create, resource_name)
-    end
-
-    #
-    # Assert that a +group+ resource exists in the Chef run with the
-    # action +:manage+. Given a Chef Recipe that manages "apache2" as a
-    # +group+:
-    #
-    #     group 'apache2' do
-    #       action :manage
-    #     end
-    #
-    # The Examples section demonstrates the different ways to test a
-    # +group+ resource with ChefSpec.
-    #
-    # @example Assert that a +group+ was managed
-    #   expect(chef_run).to manage_group('apache2')
-    #
-    # @example Assert that a +group+ was managed with predicate matchers
-    #   expect(chef_run).to manage_group('apache2').with_gid(1234)
-    #
-    # @example Assert that a +group+ was managed with attributes
-    #   expect(chef_run).to manage_group('apache2').with(gid: 1234)
-    #
-    # @example Assert that a +group+ was managed using a regex
-    #   expect(chef_run).to manage_group('apache2').with(gid: /\d+/)
-    #
-    # @example Assert that a +group+ was _not_ managed
-    #   expect(chef_run).to_not manage_group('apache2')
-    #
-    #
-    # @param [String, Regex] resource_name
-    #   the name of the resource to match
-    #
-    # @return [ChefSpec::Matchers::ResourceMatcher]
-    #
-    def manage_group(resource_name)
-      ChefSpec::Matchers::ResourceMatcher.new(:group, :manage, resource_name)
-    end
-
-    #
-    # Assert that a +group+ resource exists in the Chef run with the
-    # action +:modify+. Given a Chef Recipe that modifies "apache2" as a
-    # +group+:
-    #
-    #     group 'apache2' do
-    #       action :modify
-    #     end
-    #
-    # The Examples section demonstrates the different ways to test a
-    # +group+ resource with ChefSpec.
-    #
-    # @example Assert that a +group+ was modified
-    #   expect(chef_run).to modify_group('apache2')
-    #
-    # @example Assert that a +group+ was modified with predicate matchers
-    #   expect(chef_run).to modify_group('apache2').with_gid(1234)
-    #
-    # @example Assert that a +group+ was modified with attributes
-    #   expect(chef_run).to modify_group('apache2').with(gid: 1234)
-    #
-    # @example Assert that a +group+ was modified using a regex
-    #   expect(chef_run).to modify_group('apache2').with(gid: /\d+/)
-    #
-    # @example Assert that a +group+ was _not_ modified
-    #   expect(chef_run).to_not modify_group('apache2')
-    #
-    #
-    # @param [String, Regex] resource_name
-    #   the name of the resource to match
-    #
-    # @return [ChefSpec::Matchers::ResourceMatcher]
-    #
-    def modify_group(resource_name)
-      ChefSpec::Matchers::ResourceMatcher.new(:group, :modify, resource_name)
-    end
-
-    #
-    # Assert that a +group+ resource exists in the Chef run with the
-    # action +:remove+. Given a Chef Recipe that removes "apache2" as a
-    # +group+:
-    #
-    #     group 'apache2' do
-    #       action :remove
-    #     end
-    #
-    # The Examples section demonstrates the different ways to test a
-    # +group+ resource with ChefSpec.
-    #
-    # @example Assert that a +group+ was removed
-    #   expect(chef_run).to remove_group('apache2')
-    #
-    # @example Assert that a +group+ was removed with predicate matchers
-    #   expect(chef_run).to remove_group('apache2').with_gid(1234)
-    #
-    # @example Assert that a +group+ was removed with attributes
-    #   expect(chef_run).to remove_group('apache2').with(gid: 1234)
-    #
-    # @example Assert that a +group+ was removed using a regex
-    #   expect(chef_run).to remove_group('apache2').with(gid: /\d+/)
-    #
-    # @example Assert that a +group+ was _not_ removed
-    #   expect(chef_run).to_not remove_group('apache2')
-    #
-    #
-    # @param [String, Regex] resource_name
-    #   the name of the resource to match
-    #
-    # @return [ChefSpec::Matchers::ResourceMatcher]
-    #
-    def remove_group(resource_name)
-      ChefSpec::Matchers::ResourceMatcher.new(:group, :remove, resource_name)
-    end
-  end
-end

data/lib/chefspec/api/homebrew_package.rb

@@ -1,154 +0,0 @@
-module ChefSpec::API
-  # @since 5.1.0
-  module HomebrewPackageMatchers
-    ChefSpec.define_matcher :homebrew_package
-
-    #
-    # Assert that a +homebrew_package+ resource exists in the Chef run with the
-    # action +:install+. Given a Chef Recipe that installs "community-zero" as a
-    # +homebrew_package+:
-    #
-    #     homebrew_package 'community-zero' do
-    #       action :install
-    #     end
-    #
-    # The Examples section demonstrates the different ways to test a
-    # +homebrew_package+ resource with ChefSpec.
-    #
-    # @example Assert that a +homebrew_package+ was installed
-    #   expect(chef_run).to install_homebrew_package('community-zero')
-    #
-    # @example Assert that a +homebrew_package+ was installed with predicate matchers
-    #   expect(chef_run).to install_homebrew_package('community-zero').with_version('1.2.3')
-    #
-    # @example Assert that a +homebrew_package+ was installed with attributes
-    #   expect(chef_run).to install_homebrew_package('community-zero').with(version: '1.2.3')
-    #
-    # @example Assert that a +homebrew_package+ was installed using a regex
-    #   expect(chef_run).to install_homebrew_package('community-zero').with(version: /(\d+\.){2}\.\d+/)
-    #
-    # @example Assert that a +homebrew_package+ was _not_ installed
-    #   expect(chef_run).to_not install_homebrew_package('community-zero')
-    #
-    #
-    # @param [String, Regex] resource_name
-    #   the name of the resource to match
-    #
-    # @return [ChefSpec::Matchers::ResourceMatcher]
-    #
-    def install_homebrew_package(resource_name)
-      ChefSpec::Matchers::ResourceMatcher.new(:homebrew_package, :install, resource_name)
-    end
-
-    #
-    # Assert that a +homebrew_package+ resource exists in the Chef run with the
-    # action +:purge+. Given a Chef Recipe that purges "community-zero" as a
-    # +homebrew_package+:
-    #
-    #     homebrew_package 'community-zero' do
-    #       action :purge
-    #     end
-    #
-    # The Examples section demonstrates the different ways to test a
-    # +homebrew_package+ resource with ChefSpec.
-    #
-    # @example Assert that a +homebrew_package+ was purgeed
-    #   expect(chef_run).to purge_homebrew_package('community-zero')
-    #
-    # @example Assert that a +homebrew_package+ was purgeed with predicate matchers
-    #   expect(chef_run).to purge_homebrew_package('community-zero').with_version('1.2.3')
-    #
-    # @example Assert that a +homebrew_package+ was purgeed with attributes
-    #   expect(chef_run).to purge_homebrew_package('community-zero').with(version: '1.2.3')
-    #
-    # @example Assert that a +homebrew_package+ was purgeed using a regex
-    #   expect(chef_run).to purge_homebrew_package('community-zero').with(version: /(\d+\.){2}\.\d+/)
-    #
-    # @example Assert that a +homebrew_package+ was _not_ purgeed
-    #   expect(chef_run).to_not purge_homebrew_package('community-zero')
-    #
-    #
-    # @param [String, Regex] resource_name
-    #   the name of the resource to match
-    #
-    # @return [ChefSpec::Matchers::ResourceMatcher]
-    #
-    def purge_homebrew_package(resource_name)
-      ChefSpec::Matchers::ResourceMatcher.new(:homebrew_package, :purge, resource_name)
-    end
-
-    #
-    # Assert that a +homebrew_package+ resource exists in the Chef run with the
-    # action +:remove+. Given a Chef Recipe that removes "community-zero" as a
-    # +homebrew_package+:
-    #
-    #     homebrew_package 'community-zero' do
-    #       action :remove
-    #     end
-    #
-    # The Examples section demonstrates the different ways to test a
-    # +homebrew_package+ resource with ChefSpec.
-    #
-    # @example Assert that a +homebrew_package+ was removeed
-    #   expect(chef_run).to remove_homebrew_package('community-zero')
-    #
-    # @example Assert that a +homebrew_package+ was removeed with predicate matchers
-    #   expect(chef_run).to remove_homebrew_package('community-zero').with_version('1.2.3')
-    #
-    # @example Assert that a +homebrew_package+ was removeed with attributes
-    #   expect(chef_run).to remove_homebrew_package('community-zero').with(version: '1.2.3')
-    #
-    # @example Assert that a +homebrew_package+ was removeed using a regex
-    #   expect(chef_run).to remove_homebrew_package('community-zero').with(version: /(\d+\.){2}\.\d+/)
-    #
-    # @example Assert that a +homebrew_package+ was _not_ removeed
-    #   expect(chef_run).to_not remove_homebrew_package('community-zero')
-    #
-    #
-    # @param [String, Regex] resource_name
-    #   the name of the resource to match
-    #
-    # @return [ChefSpec::Matchers::ResourceMatcher]
-    #
-    def remove_homebrew_package(resource_name)
-      ChefSpec::Matchers::ResourceMatcher.new(:homebrew_package, :remove, resource_name)
-    end
-
-    #
-    # Assert that a +homebrew_package+ resource exists in the Chef run with the
-    # action +:upgrade+. Given a Chef Recipe that upgrades "community-zero" as a
-    # +homebrew_package+:
-    #
-    #     homebrew_package 'community-zero' do
-    #       action :upgrade
-    #     end
-    #
-    # The Examples section demonstrates the different ways to test a
-    # +homebrew_package+ resource with ChefSpec.
-    #
-    # @example Assert that a +homebrew_package+ was upgradeed
-    #   expect(chef_run).to upgrade_homebrew_package('community-zero')
-    #
-    # @example Assert that a +homebrew_package+ was upgradeed with predicate matchers
-    #   expect(chef_run).to upgrade_homebrew_package('community-zero').with_version('1.2.3')
-    #
-    # @example Assert that a +homebrew_package+ was upgradeed with attributes
-    #   expect(chef_run).to upgrade_homebrew_package('community-zero').with(version: '1.2.3')
-    #
-    # @example Assert that a +homebrew_package+ was upgradeed using a regex
-    #   expect(chef_run).to upgrade_homebrew_package('community-zero').with(version: /(\d+\.){2}\.\d+/)
-    #
-    # @example Assert that a +homebrew_package+ was _not_ upgradeed
-    #   expect(chef_run).to_not upgrade_homebrew_package('community-zero')
-    #
-    #
-    # @param [String, Regex] resource_name
-    #   the name of the resource to match
-    #
-    # @return [ChefSpec::Matchers::ResourceMatcher]
-    #
-    def upgrade_homebrew_package(resource_name)
-      ChefSpec::Matchers::ResourceMatcher.new(:homebrew_package, :upgrade, resource_name)
-    end
-  end
-end

data/lib/chefspec/api/http_request.rb

@@ -1,228 +0,0 @@
-module ChefSpec::API
-  # @since 3.0.0
-  module HttpRequestMatchers
-    ChefSpec.define_matcher :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