Module: PuppetlabsSpec::Fixtures

Defined in:
lib/puppetlabs_spec_helper/puppetlabs_spec/fixtures.rb

Overview

This module provides some helper methods to assist with fixtures. It’s methods are designed to help when you have a conforming fixture layout so we get project consistency.

Instance Method Summary collapse

Instance Method Details

#fixtures(*rest) ⇒ Object

Returns the joined path of the global FIXTURE_DIR plus any path given to it



9
10
11
 
# File 'lib/puppetlabs_spec_helper/puppetlabs_spec/fixtures.rb', line 9

def fixtures(*rest)
  File.join(PuppetlabsSpec::FIXTURE_DIR, *rest)
end

#my_fixture(name) ⇒ Object

Given a name, returns the full path of a file from your relative fixture dir as returned by my_fixture_dir.



28
29
30
31
32
33
34
35
 
# File 'lib/puppetlabs_spec_helper/puppetlabs_spec/fixtures.rb', line 28

def my_fixture(name)
  file = File.join(my_fixture_dir, name)
  unless File.readable? file
    raise "fixture '#{name}' for #{my_fixture_dir} is not readable"
  end

  file
end

#my_fixture_dir ⇒ Object

Returns the path to your relative fixture dir. So if your spec test is <project>/spec/unit/facter/foo_spec.rb then your relative dir will be <project>/spec/fixture/unit/facter/foo



16
17
18
19
20
21
22
23
24
 
# File 'lib/puppetlabs_spec_helper/puppetlabs_spec/fixtures.rb', line 16

def my_fixture_dir
  callers = caller
  while (line = callers.shift)
    next unless (found = line.match(%r{/spec/(.*)_spec\.rb:}))

    return fixtures(found[1])
  end
  raise "sorry, I couldn't work out your path from the caller stack!"
end

#my_fixture_read(name) ⇒ Object

Return the contents of the file using read when given a name. Uses my_fixture to work out the relative path.



39
40
41
 
# File 'lib/puppetlabs_spec_helper/puppetlabs_spec/fixtures.rb', line 39

def my_fixture_read(name)
  File.read(my_fixture(name))
end

#my_fixtures(glob = '*', flags = 0, &block) ⇒ Object

Provides a block mechanism for iterating across the files in your fixture area.



45
46
47
48
49
50
51
52
53
 
# File 'lib/puppetlabs_spec_helper/puppetlabs_spec/fixtures.rb', line 45

def my_fixtures(glob = '*', flags = 0, &block)
  files = Dir.glob(File.join(my_fixture_dir, glob), flags)
  if files.empty?
    raise "fixture '#{glob}' for #{my_fixture_dir} had no files!"
  end

  block && files.each(&block)
  files
end