123456789_123456789_123456789_123456789_123456789_

Module: ActionDispatch::TestProcess::FixtureFile

Instance Method Summary

Instance Method Details

#fixture_file_upload(path, mime_type = nil, binary = false)

Shortcut for Rack::Test::UploadedFile.new(File.join(ActionDispatch::IntegrationTest.file_fixture_path, path), type):

post :change_avatar, params: { avatar: fixture_file_upload('spongebob.png', 'image/png') }

Default fixture files location is test/fixtures/files.

To upload binary files on Windows, pass :binary as the last parameter. This will not affect other platforms:

post :change_avatar, params: { avatar: fixture_file_upload('spongebob.png', 'image/png', :binary) }
[ GitHub ]

  
# File 'actionpack/lib/action_dispatch/testing/test_process.rb', line 19

def fixture_file_upload(path, mime_type = nil, binary = false)
  if self.class.respond_to?(:fixture_path) && self.class.fixture_path &&
      !File.exist?(path)
    original_path = path
    path = Pathname.new(self.class.fixture_path).join(path)

    if !self.class.file_fixture_path
      ActiveSupport::Deprecation.warn(<<~EOM)
        Passing a path to `fixture_file_upload` relative to `fixture_path` is deprecated.
        In Rails 7.0, the path needs to be relative to `file_fixture_path` which you
        haven't set yet. Set `file_fixture_path` to discard this warning.
      EOM
    elsif path.exist?
      non_deprecated_path = Pathname(File.absolute_path(path)).relative_path_from(Pathname(File.absolute_path(self.class.file_fixture_path)))

      if Pathname(original_path) != non_deprecated_path
        ActiveSupport::Deprecation.warn(<<~EOM)
          Passing a path to `fixture_file_upload` relative to `fixture_path` is deprecated.
          In Rails 7.0, the path needs to be relative to `file_fixture_path`.

          Please modify the call from
          `fixture_file_upload("#{original_path}")` to `fixture_file_upload("#{non_deprecated_path}")`.
        EOM
      end
    else
      path = file_fixture(original_path)
    end
  elsif self.class.file_fixture_path && !File.exist?(path)
    path = file_fixture(path)
  end

  Rack::Test::UploadedFile.new(path, mime_type, binary)
end