chefspec 7.0.0 → 9.3.8

data/lib/chefspec/api/deploy.rb

@@ -1,117 +0,0 @@
-module ChefSpec::API
-  # @since 3.0.0
-  module DeployMatchers
-    ChefSpec.define_matcher :deploy
-
-    #
-    # Assert that a +deploy+ resource exists in the Chef run with the
-    # action +:deploy+. Given a Chef Recipe that deploys "/tmp/path" as a
-    # +deploy+:
-    #
-    #     deploy '/tmp/path' do
-    #       action :deploy
-    #     end
-    #
-    # The Examples section demonstrates the different ways to test a
-    # +deploy+ resource with ChefSpec.
-    #
-    # @example Assert that a +deploy+ was deployed
-    #   expect(chef_run).to deploy_deploy('/tmp/path')
-    #
-    # @example Assert that a +deploy+ was deployed with predicate matchers
-    #   expect(chef_run).to deploy_deploy('/tmp/path').with_repo('ssh://...')
-    #
-    # @example Assert that a +deploy+ was deployed with attributes
-    #   expect(chef_run).to deploy_deploy('/tmp/path').with(repo: 'ssh://...')
-    #
-    # @example Assert that a +deploy+ was deployed using a regex
-    #   expect(chef_run).to deploy_deploy('/tmp/path').with(repo: /ssh:(.+)/)
-    #
-    # @example Assert that a +deploy+ was _not_ deployed
-    #   expect(chef_run).to_not deploy_deploy('/tmp/path')
-    #
-    #
-    # @param [String, Regex] resource_name
-    #   the name of the resource to match
-    #
-    # @return [ChefSpec::Matchers::ResourceMatcher]
-    #
-    def deploy_deploy(resource_name)
-      ChefSpec::Matchers::ResourceMatcher.new(:deploy, :deploy, resource_name)
-    end
-
-    #
-    # Assert that a +deploy+ resource exists in the Chef run with the
-    # action +:force_deploy+. Given a Chef Recipe that force_deploys "/tmp/path" as a
-    # +deploy+:
-    #
-    #     deploy '/tmp/path' do
-    #       action :force_deploy
-    #     end
-    #
-    # The Examples section demonstrates the different ways to test a
-    # +deploy+ resource with ChefSpec.
-    #
-    # @example Assert that a +deploy+ was force_deployed
-    #   expect(chef_run).to force_deploy_deploy('/tmp/path')
-    #
-    # @example Assert that a +deploy+ was force_deployed with predicate matchers
-    #   expect(chef_run).to force_deploy_deploy('/tmp/path').with_repo('ssh://...')
-    #
-    # @example Assert that a +deploy+ was force_deployed with attributes
-    #   expect(chef_run).to force_deploy_deploy('/tmp/path').with(repo: 'ssh://...')
-    #
-    # @example Assert that a +deploy+ was force_deployed using a regex
-    #   expect(chef_run).to force_deploy_deploy('/tmp/path').with(repo: /ssh:(.+)/)
-    #
-    # @example Assert that a +deploy+ was _not_ force_deployed
-    #   expect(chef_run).to_not force_deploy_deploy('/tmp/path')
-    #
-    #
-    # @param [String, Regex] resource_name
-    #   the name of the resource to match
-    #
-    # @return [ChefSpec::Matchers::ResourceMatcher]
-    #
-    def force_deploy_deploy(resource_name)
-      ChefSpec::Matchers::ResourceMatcher.new(:deploy, :force_deploy, resource_name)
-    end
-
-    #
-    # Assert that a +deploy+ resource exists in the Chef run with the
-    # action +:rollback+. Given a Chef Recipe that rolls back "/tmp/path" as a
-    # +deploy+:
-    #
-    #     deploy '/tmp/path' do
-    #       action :rollback
-    #     end
-    #
-    # The Examples section demonstrates the different ways to test a
-    # +deploy+ resource with ChefSpec.
-    #
-    # @example Assert that a +deploy+ was rolled back
-    #   expect(chef_run).to rollback_deploy('/tmp/path')
-    #
-    # @example Assert that a +deploy+ was rolled back with predicate matchers
-    #   expect(chef_run).to rollback_deploy('/tmp/path').with_repo('ssh://...')
-    #
-    # @example Assert that a +deploy+ was rolled back with attributes
-    #   expect(chef_run).to rollback_deploy('/tmp/path').with(repo: 'ssh://...')
-    #
-    # @example Assert that a +deploy+ was rolled back using a regex
-    #   expect(chef_run).to rollback_deploy('/tmp/path').with(repo: /ssh:(.+)/)
-    #
-    # @example Assert that a +deploy+ was _not_ rolled back
-    #   expect(chef_run).to_not rollback_deploy('/tmp/path')
-    #
-    #
-    # @param [String, Regex] resource_name
-    #   the name of the resource to match
-    #
-    # @return [ChefSpec::Matchers::ResourceMatcher]
-    #
-    def rollback_deploy(resource_name)
-      ChefSpec::Matchers::ResourceMatcher.new(:deploy, :rollback, resource_name)
-    end
-  end
-end

data/lib/chefspec/api/directory.rb

@@ -1,80 +0,0 @@
-module ChefSpec::API
-  # @since 0.0.1
-  module DirectoryMatchers
-    ChefSpec.define_matcher :directory
-
-    #
-    # Assert that a +directory+ resource exists in the Chef run with the
-    # action +:create+. Given a Chef Recipe that creates "/tmp" as a
-    # +directory+:
-    #
-    #     directory '/tmp' do
-    #       action :create
-    #     end
-    #
-    # The Examples section demonstrates the different ways to test a
-    # +directory+ resource with ChefSpec.
-    #
-    # @example Assert that a +directory+ was created
-    #   expect(chef_run).to create_directory('/tmp')
-    #
-    # @example Assert that a +directory+ was created with predicate matchers
-    #   expect(chef_run).to create_directory('/tmp').with_user('svargo')
-    #
-    # @example Assert that a +directory+ was created with attributes
-    #   expect(chef_run).to create_directory('/tmp').with(user: 'svargo')
-    #
-    # @example Assert that a +directory+ was created using a regex
-    #   expect(chef_run).to create_directory('/tmp').with(user: /sva(.+)/)
-    #
-    # @example Assert that a +directory+ was _not_ created
-    #   expect(chef_run).to_not create_directory('/tmp')
-    #
-    #
-    # @param [String, Regex] resource_name
-    #   the name of the resource to match
-    #
-    # @return [ChefSpec::Matchers::ResourceMatcher]
-    #
-    def create_directory(resource_name)
-      ChefSpec::Matchers::ResourceMatcher.new(:directory, :create, resource_name)
-    end
-
-    #
-    # Assert that a +directory+ resource exists in the Chef run with the
-    # action +:delete+. Given a Chef Recipe that deletes "/tmp" as a
-    # +directory+:
-    #
-    #     directory '/tmp' do
-    #       action :delete
-    #     end
-    #
-    # The Examples section demonstrates the different ways to test a
-    # +directory+ resource with ChefSpec.
-    #
-    # @example Assert that a +directory+ was deleted
-    #   expect(chef_run).to delete_directory('/tmp')
-    #
-    # @example Assert that a +directory+ was deleted with predicate matchers
-    #   expect(chef_run).to delete_directory('/tmp').with_user('svargo')
-    #
-    # @example Assert that a +directory+ was deleted with attributes
-    #   expect(chef_run).to delete_directory('/tmp').with(user: 'svargo')
-    #
-    # @example Assert that a +directory+ was deleted using a regex
-    #   expect(chef_run).to delete_directory('/tmp').with(user: /sva(.+)/)
-    #
-    # @example Assert that a +directory+ was _not_ deleted
-    #   expect(chef_run).to_not delete_directory('/tmp')
-    #
-    #
-    # @param [String, Regex] resource_name
-    #   the name of the resource to match
-    #
-    # @return [ChefSpec::Matchers::ResourceMatcher]
-    #
-    def delete_directory(resource_name)
-      ChefSpec::Matchers::ResourceMatcher.new(:directory, :delete, resource_name)
-    end
-  end
-end

data/lib/chefspec/api/dnf_package.rb

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

data/lib/chefspec/api/dpkg_package.rb

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

data/lib/chefspec/api/dsc_resource.rb

@@ -1,49 +0,0 @@
-module ChefSpec::API
-  # @since 4.3.0
-  module DscResourceMatchers
-    ChefSpec.define_matcher :dsc_resource
-
-    #
-    # Assert that a +dsc_resource+ resource exists in the Chef run with the
-    # action +:run+. Given a Chef Recipe that installs "zip" as a
-    # +dsc_resource+:
-    #
-    #     dsc_resource 'zip' do
-    #       resource :archive
-    #       property :ensure, 'Present'
-    #       property :path, "C:\Users\Public\Documents\example.zip"
-    #       property :destination, "C:\Users\Public\Documents\ExtractionPath"
-    #     end
-    #
-    # To test the content rendered by a +dsc_resource+, see
-    # {ChefSpec::API::RenderFileMatchers}.
-    #
-    # The Examples section demonstrates the different ways to test a
-    # +dsc_resource+ resource with ChefSpec.
-    #
-    # @example Assert that a +dsc_resource+ was installed
-    #   expect(chef_run).to run_dsc_resource('zip')
-    #
-    # @example Assert that a +dsc_resource+ was installed with predicate matchers
-    #   expect(chef_run).to run_dsc_resource('zip').with_resource(:archive)
-    #
-    # @example Assert that a +dsc_resource+ was installed with attributes
-    #   expect(chef_run).to run_dsc_resource('zip').with(resource: :archive)
-    #
-    # @example Assert that a +dsc_resource+ was installed using a regex
-    #   expect(chef_run).to run_dsc_resource('zip').with(resource: /:arch(.+)/)
-    #
-    # @example Assert that a +dsc_resource+ was _not_ installed
-    #   expect(chef_run).to_not run_dsc_resource('zip')
-    #
-    #
-    # @param [String, Regex] resource_name
-    #   the name of the resource to match
-    #
-    # @return [ChefSpec::Matchers::ResourceMatcher]
-    #
-    def run_dsc_resource(resource_name)
-      ChefSpec::Matchers::ResourceMatcher.new(:dsc_resource, :run, resource_name)
-    end
-  end
-end

data/lib/chefspec/api/dsc_script.rb

@@ -1,37 +0,0 @@
-module ChefSpec::API
-  # @since 5.1.0
-  module DscScriptMatchers
-    ChefSpec.define_matcher :dsc_script
-
-    #
-    # Assert that a +dsc_script+ resource exists in the Chef run with
-    # the action +:run+. Given a Chef Recipe that runs "something" using
-    # +dsc_script+:
-    #
-    #     dsc_script 'something' do
-    #       code <<-EOH
-    #         something
-    #       EOH
-    #       action :run
-    #     end
-    #
-    # The Examples section demonstrates the different ways to test a
-    # +dsc_script+ resource with ChefSpec.
-    #
-    # @example Assert that a +dsc_script+ was run
-    #   expect(chef_run).to dsc_script('something')
-    #
-    # @example Assert that a +dsc_script+ was _not_ run
-    #   expect(chef_run).to_not dsc_script('something')
-    #
-    #
-    # @param [String, Regex] resource_name
-    #   the name of the resource to match
-    #
-    # @return [ChefSpec::Matchers::ResourceMatcher]
-    #
-    def run_dsc_script(resource_name)
-      ChefSpec::Matchers::ResourceMatcher.new(:dsc_script, :run, resource_name)
-    end
-  end
-end