chefspec 7.0.0 → 9.3.8

data/lib/chefspec/api/remote_file.rb

@@ -1,166 +0,0 @@
-module ChefSpec::API
-  # @since 1.0.0
-  module RemoteFileMatchers
-    ChefSpec.define_matcher :remote_file
-
-    #
-    # Assert that a +remote_file+ resource exists in the Chef run with the
-    # action +:create+. Given a Chef Recipe that creates "/tmp/config" as a
-    # +remote_file+:
-    #
-    #     remote_file '/tmp/config' do
-    #       action :create
-    #     end
-    #
-    # To test the content rendered by a +remote_file+, see
-    # {ChefSpec::API::RenderFileMatchers}.
-    #
-    # The Examples section demonstrates the different ways to test a
-    # +remote_file+ resource with ChefSpec.
-    #
-    # @example Assert that a +remote_file+ was created
-    #   expect(chef_run).to create_remote_file('/tmp/config')
-    #
-    # @example Assert that a +remote_file+ was created with predicate matchers
-    #   expect(chef_run).to create_remote_file('/tmp/config').with_backup(false)
-    #
-    # @example Assert that a +remote_file+ was created with attributes
-    #   expect(chef_run).to create_remote_file('/tmp/config').with(backup: false)
-    #
-    # @example Assert that a +remote_file+ was created using a regex
-    #   expect(chef_run).to create_remote_file('/tmp/config').with(user: /apa(.+)/)
-    #
-    # @example Assert that a +remote_file+ was _not_ created
-    #   expect(chef_run).to_not create_remote_file('/tmp/config')
-    #
-    #
-    # @param [String, Regex] resource_name
-    #   the name of the resource to match
-    #
-    # @return [ChefSpec::Matchers::ResourceMatcher]
-    #
-    def create_remote_file(resource_name)
-      ChefSpec::Matchers::ResourceMatcher.new(:remote_file, :create, resource_name)
-    end
-
-    #
-    # Assert that a +remote_file+ resource exists in the Chef run with the
-    # action +:create_if_missing+. Given a Chef Recipe that creates "/tmp/config"
-    # if missing as a +remote_file+:
-    #
-    #     remote_file '/tmp/config' do
-    #       action :create_if_missing
-    #     end
-    #
-    # To test the content rendered by a +remote_file+, see
-    # {ChefSpec::API::RenderFileMatchers}.
-    #
-    # The Examples section demonstrates the different ways to test a
-    # +remote_file+ resource with ChefSpec.
-    #
-    # @example Assert that a +remote_file+ was created if missing
-    #   expect(chef_run).to create_remote_file_if_missing('/tmp/config')
-    #
-    # @example Assert that a +remote_file+ was created if missing with predicate matchers
-    #   expect(chef_run).to create_remote_file_if_missing('/tmp/config').with_backup(false)
-    #
-    # @example Assert that a +remote_file+ was created if missing with attributes
-    #   expect(chef_run).to create_remote_file_if_missing('/tmp/config').with(backup: false)
-    #
-    # @example Assert that a +remote_file+ was created if missing using a regex
-    #   expect(chef_run).to create_remote_file_if_missing('/tmp/config').with(user: /apa(.+)/)
-    #
-    # @example Assert that a +remote_file+ was _not_ created if missing
-    #   expect(chef_run).to_not create_remote_file('/tmp/config')
-    #
-    #
-    # @param [String, Regex] resource_name
-    #   the name of the resource to match
-    #
-    # @return [ChefSpec::Matchers::ResourceMatcher]
-    #
-    def create_remote_file_if_missing(resource_name)
-      ChefSpec::Matchers::ResourceMatcher.new(:remote_file, :create_if_missing, resource_name)
-    end
-
-    #
-    # Assert that a +remote_file+ resource exists in the Chef run with the
-    # action +:delete+. Given a Chef Recipe that deletes "/tmp/config" as a
-    # +remote_file+:
-    #
-    #     remote_file '/tmp/config' do
-    #       action :delete
-    #     end
-    #
-    # To test the content rendered by a +remote_file+, see
-    # {ChefSpec::API::RenderFileMatchers}.
-    #
-    # The Examples section demonstrates the different ways to test a
-    # +remote_file+ resource with ChefSpec.
-    #
-    # @example Assert that a +remote_file+ was deleted
-    #   expect(chef_run).to delete_remote_file('/tmp/config')
-    #
-    # @example Assert that a +remote_file+ was deleted with predicate matchers
-    #   expect(chef_run).to delete_remote_file('/tmp/config').with_backup(false)
-    #
-    # @example Assert that a +remote_file+ was deleted with attributes
-    #   expect(chef_run).to delete_remote_file('/tmp/config').with(backup: false)
-    #
-    # @example Assert that a +remote_file+ was deleted using a regex
-    #   expect(chef_run).to delete_remote_file('/tmp/config').with(user: /apa(.+)/)
-    #
-    # @example Assert that a +remote_file+ was _not_ deleted
-    #   expect(chef_run).to_not delete_remote_file('/tmp/config')
-    #
-    #
-    # @param [String, Regex] resource_name
-    #   the name of the resource to match
-    #
-    # @return [ChefSpec::Matchers::ResourceMatcher]
-    #
-    def delete_remote_file(resource_name)
-      ChefSpec::Matchers::ResourceMatcher.new(:remote_file, :delete, resource_name)
-    end
-
-    #
-    # Assert that a +remote_file+ resource exists in the Chef run with the
-    # action +:touch+. Given a Chef Recipe that touches "/tmp/config" as a
-    # +remote_file+:
-    #
-    #     remote_file '/tmp/config' do
-    #       action :touch
-    #     end
-    #
-    # To test the content rendered by a +remote_file+, see
-    # {ChefSpec::API::RenderFileMatchers}.
-    #
-    # The Examples section demonstrates the different ways to test a
-    # +remote_file+ resource with ChefSpec.
-    #
-    # @example Assert that a +remote_file+ was touched
-    #   expect(chef_run).to touch_remote_file('/tmp/config')
-    #
-    # @example Assert that a +remote_file+ was touched with predicate matchers
-    #   expect(chef_run).to touch_remote_file('/tmp/config').with_backup(false)
-    #
-    # @example Assert that a +remote_file+ was touched with attributes
-    #   expect(chef_run).to touch_remote_file('/tmp/config').with(backup: false)
-    #
-    # @example Assert that a +remote_file+ was touched using a regex
-    #   expect(chef_run).to touch_remote_file('/tmp/config').with(user: /apa(.+)/)
-    #
-    # @example Assert that a +remote_file+ was _not_ touched
-    #   expect(chef_run).to_not touch_remote_file('/tmp/config')
-    #
-    #
-    # @param [String, Regex] resource_name
-    #   the name of the resource to match
-    #
-    # @return [ChefSpec::Matchers::ResourceMatcher]
-    #
-    def touch_remote_file(resource_name)
-      ChefSpec::Matchers::ResourceMatcher.new(:remote_file, :touch, resource_name)
-    end
-  end
-end

data/lib/chefspec/api/route.rb

@@ -1,80 +0,0 @@
-module ChefSpec::API
-  # @since 3.0.0
-  module RouteMatchers
-    ChefSpec.define_matcher :route
-
-    #
-    # Assert that a +route+ resource exists in the Chef run with the
-    # action +:add+. Given a Chef Recipe that adds "10.0.0.10/32" as a
-    # +route+:
-    #
-    #     route '10.0.0.10/32' do
-    #       action :add
-    #     end
-    #
-    # The Examples section demonstrates the different ways to test a
-    # +route+ resource with ChefSpec.
-    #
-    # @example Assert that a +route+ was added
-    #   expect(chef_run).to add_route('10.0.0.10/32')
-    #
-    # @example Assert that a +route+ was added with predicate matchers
-    #   expect(chef_run).to add_route('10.0.0.10/32').with_device('eth0')
-    #
-    # @example Assert that a +route+ was added with attributes
-    #   expect(chef_run).to add_route('10.0.0.10/32').with(device: 'eth0')
-    #
-    # @example Assert that a +route+ was added using a regex
-    #   expect(chef_run).to add_route('10.0.0.10/32').with(device: /eth(\d+)/)
-    #
-    # @example Assert that a +route+ was _not_ added
-    #   expect(chef_run).to_not add_route('10.0.0.10/32')
-    #
-    #
-    # @param [String, Regex] resource_name
-    #   the name of the resource to match
-    #
-    # @return [ChefSpec::Matchers::ResourceMatcher]
-    #
-    def add_route(resource_name)
-      ChefSpec::Matchers::ResourceMatcher.new(:route, :add, resource_name)
-    end
-
-    #
-    # Assert that a +route+ resource exists in the Chef run with the
-    # action +:delete+. Given a Chef Recipe that deletes "10.0.0.10/32" as a
-    # +route+:
-    #
-    #     route '10.0.0.10/32' do
-    #       action :delete
-    #     end
-    #
-    # The Examples section demonstrates the different ways to test a
-    # +route+ resource with ChefSpec.
-    #
-    # @example Assert that a +route+ was deleted
-    #   expect(chef_run).to delete_route('10.0.0.10/32')
-    #
-    # @example Assert that a +route+ was deleted with predicate matchers
-    #   expect(chef_run).to delete_route('10.0.0.10/32').with_device('eth0')
-    #
-    # @example Assert that a +route+ was deleted with attributes
-    #   expect(chef_run).to delete_route('10.0.0.10/32').with(device: 'eth0')
-    #
-    # @example Assert that a +route+ was deleted using a regex
-    #   expect(chef_run).to delete_route('10.0.0.10/32').with(device: /eth(\d+)/)
-    #
-    # @example Assert that a +route+ was _not_ deleted
-    #   expect(chef_run).to_not delete_route('10.0.0.10/32')
-    #
-    #
-    # @param [String, Regex] resource_name
-    #   the name of the resource to match
-    #
-    # @return [ChefSpec::Matchers::ResourceMatcher]
-    #
-    def delete_route(resource_name)
-      ChefSpec::Matchers::ResourceMatcher.new(:route, :delete, resource_name)
-    end
-  end
-end

data/lib/chefspec/api/rpm_package.rb

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

data/lib/chefspec/api/ruby_block.rb

@@ -1,68 +0,0 @@
-module ChefSpec::API
-  # @since 0.5.0
-  module RubyBlockMatchers
-    ChefSpec.define_matcher :ruby_block
-
-    #
-    # Assert that a +ruby_block+ resource exists in the Chef run with the
-    # action +:run+. Given a Chef Recipe that runs "do_something" as a
-    # +ruby_block+:
-    #
-    #     ruby_block 'do_something' do
-    #       block do
-    #         # ...
-    #       end
-    #       action :run
-    #     end
-    #
-    # The Examples section demonstrates the different ways to test a
-    # +ruby_block+ resource with ChefSpec.
-    #
-    # @example Assert that a +ruby_block+ was run
-    #   expect(chef_run).to run_ruby_block('do_something')
-    #
-    # @example Assert that a +ruby_block+ was _not_ run
-    #   expect(chef_run).to_not run_ruby_block('do_something')
-    #
-    #
-    # @param [String, Regex] resource_name
-    #   the name of the resource to match
-    #
-    # @return [ChefSpec::Matchers::ResourceMatcher]
-    #
-    def run_ruby_block(resource_name)
-      ChefSpec::Matchers::ResourceMatcher.new(:ruby_block, :run, resource_name)
-    end
-
-    #
-    # Assert that a +ruby_block+ resource exists in the Chef run with the
-    # action +:create+. Given a Chef Recipe that runs "do_something" as a
-    # +ruby_block+:
-    #
-    #     ruby_block 'do_something' do
-    #       block do
-    #         # ...
-    #       end
-    #       action :create
-    #     end
-    #
-    # The Examples section demonstrates the different ways to test a
-    # +ruby_block+ resource with ChefSpec.
-    #
-    # @example Assert that a +ruby_block+ was run
-    #   expect(chef_run).to create_ruby_block('do_something')
-    #
-    # @example Assert that a +ruby_block+ was _not_ run
-    #   expect(chef_run).to_not create_ruby_block('do_something')
-    #
-    #
-    # @param [String, Regex] resource_name
-    #   the name of the resource to match
-    #
-    # @return [ChefSpec::Matchers::ResourceMatcher]
-    #
-    def create_ruby_block(resource_name)
-      ChefSpec::Matchers::ResourceMatcher.new(:ruby_block, :create, resource_name)
-    end
-  end
-end