Method: Rails::Generators::Testing::Assertions#assert_file

Defined in:
railties/lib/rails/generators/testing/assertions.rb

#assert_file(relative, *contents) {|read| ... } ⇒ Object Also known as: assert_directory

Asserts a given file exists. You need to supply an absolute path or a path relative to the configured destination:

assert_file "config/environment.rb"

You can also give extra arguments. If the argument is a regexp, it will check if the regular expression matches the given file content. If it’s a string, it compares the file with the given string:

assert_file "config/environment.rb", /initialize/

Finally, when a block is given, it yields the file content:

assert_file "app/controllers/products_controller.rb" do |controller|
  assert_instance_method :index, controller do |index|
    assert_match(/Product\.all/, index)
  end
end

Yields:

  • (read)
[View source]

23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
 
# File 'railties/lib/rails/generators/testing/assertions.rb', line 23

def assert_file(relative, *contents)
  absolute = File.expand_path(relative, destination_root)
  assert File.exists?(absolute), "Expected file #{relative.inspect} to exist, but does not"

  read = File.read(absolute) if block_given? || !contents.empty?
  yield read if block_given?

  contents.each do |content|
    case content
      when String
        assert_equal content, read
      when Regexp
        assert_match content, read
    end
  end
end