Module: ChefSpec::API::UserMatchers

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

Overview

Since:

  • 0.3.0

Instance Method Summary collapse

Instance Method Details

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

Assert that a user resource exists in the Chef run with the action :create. Given a Chef Recipe that creates “apache2” as a user:

user 'apache2' do
  action :create
end

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

Examples:

Assert that a user was createed

expect(chef_run).to create_user('apache2')

Assert that a user was createed with predicate matchers

expect(chef_run).to create_user('apache2').with_uid(1234)

Assert that a user was createed with attributes

expect(chef_run).to create_user('apache2').with(uid: 1234)

Assert that a user was createed using a regex

expect(chef_run).to create_user('apache2').with(uid: /\d+/)

Assert that a user was not createed

expect(chef_run).to_not create_user('apache2')

Parameters:

  • resource_name (String, Regex)

    the name of the resource to match

Returns:

Since:

  • 0.3.0


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

def create_user(resource_name)
  ChefSpec::Matchers::ResourceMatcher.new(:user, :create, resource_name)
end

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

Assert that a user resource exists in the Chef run with the action :lock. Given a Chef Recipe that locks “apache2” as a user:

user 'apache2' do
  action :lock
end

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

Examples:

Assert that a user was locked

expect(chef_run).to lock_user('apache2')

Assert that a user was locked with predicate matchers

expect(chef_run).to lock_user('apache2').with_uid(1234)

Assert that a user was locked with attributes

expect(chef_run).to lock_user('apache2').with(uid: 1234)

Assert that a user was locked using a regex

expect(chef_run).to lock_user('apache2').with(uid: /\d+/)

Assert that a user was not locked

expect(chef_run).to_not lock_user('apache2')

Parameters:

  • resource_name (String, Regex)

    the name of the resource to match

Returns:

Since:

  • 0.3.0


187
188
189
# File 'lib/chefspec/api/user.rb', line 187

def lock_user(resource_name)
  ChefSpec::Matchers::ResourceMatcher.new(:user, :lock, resource_name)
end

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

Assert that a user resource exists in the Chef run with the action :manage. Given a Chef Recipe that manages “apache2” as a user:

user 'apache2' do
  action :manage
end

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

Examples:

Assert that a user was managed

expect(chef_run).to manage_user('apache2')

Assert that a user was managed with predicate matchers

expect(chef_run).to manage_user('apache2').with_uid(1234)

Assert that a user was managed with attributes

expect(chef_run).to manage_user('apache2').with(uid: 1234)

Assert that a user was managed using a regex

expect(chef_run).to manage_user('apache2').with(uid: /\d+/)

Assert that a user was not managed

expect(chef_run).to_not manage_user('apache2')

Parameters:

  • resource_name (String, Regex)

    the name of the resource to match

Returns:

Since:

  • 0.3.0


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

def manage_user(resource_name)
  ChefSpec::Matchers::ResourceMatcher.new(:user, :manage, resource_name)
end

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

Assert that a user resource exists in the Chef run with the action :modify. Given a Chef Recipe that modifies “apache2” as a user:

user 'apache2' do
  action :modify
end

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

Examples:

Assert that a user was modified

expect(chef_run).to modify_user('apache2')

Assert that a user was modified with predicate matchers

expect(chef_run).to modify_user('apache2').with_uid(1234)

Assert that a user was modified with attributes

expect(chef_run).to modify_user('apache2').with(uid: 1234)

Assert that a user was modified using a regex

expect(chef_run).to modify_user('apache2').with(uid: /\d+/)

Assert that a user was not modified

expect(chef_run).to_not modify_user('apache2')

Parameters:

  • resource_name (String, Regex)

    the name of the resource to match

Returns:

Since:

  • 0.3.0


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

def modify_user(resource_name)
  ChefSpec::Matchers::ResourceMatcher.new(:user, :modify, resource_name)
end

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

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

user 'apache2' do
  action :remove
end

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

Examples:

Assert that a user was remove

expect(chef_run).to remove_user('apache2')

Assert that a user was remove with predicate matchers

expect(chef_run).to remove_user('apache2').with_uid(1234)

Assert that a user was remove with attributes

expect(chef_run).to remove_user('apache2').with(uid: 1234)

Assert that a user was remove using a regex

expect(chef_run).to remove_user('apache2').with(uid: /\d+/)

Assert that a user was not remove

expect(chef_run).to_not remove_user('apache2')

Parameters:

  • resource_name (String, Regex)

    the name of the resource to match

Returns:

Since:

  • 0.3.0


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

def remove_user(resource_name)
  ChefSpec::Matchers::ResourceMatcher.new(:user, :remove, resource_name)
end

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

Assert that a user resource exists in the Chef run with the action :unlock. Given a Chef Recipe that unlocks “apache2” as a user:

user 'apache2' do
  action :unlock
end

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

Examples:

Assert that a user was unlocked

expect(chef_run).to unlock_user('apache2')

Assert that a user was unlocked with predicate matchers

expect(chef_run).to unlock_user('apache2').with_uid(1234)

Assert that a user was unlocked with attributes

expect(chef_run).to unlock_user('apache2').with(uid: 1234)

Assert that a user was unlocked using a regex

expect(chef_run).to unlock_user('apache2').with(uid: /\d+/)

Assert that a user was not unlocked

expect(chef_run).to_not unlock_user('apache2')

Parameters:

  • resource_name (String, Regex)

    the name of the resource to match

Returns:

Since:

  • 0.3.0


224
225
226
# File 'lib/chefspec/api/user.rb', line 224

def unlock_user(resource_name)
  ChefSpec::Matchers::ResourceMatcher.new(:user, :unlock, resource_name)
end