instance method fixture_file_upload

Ruby on Rails 6.1.7.10

Since v5.2.8.1

Available in: v5.2.8.1 v6.0.6 v6.1.7.10 v7.0.10 v7.1.6 v7.2.3 v8.0.4 v8.1.2

Signature

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) }

Parameters

path req
mime_type opt = nil
binary opt = false
Source
# 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

Defined in actionpack/lib/action_dispatch/testing/test_process.rb line 19 · View on GitHub · Improve this page · Find usages on GitHub

Defined in ActionDispatch::TestProcess::FixtureFile

Type at least 2 characters to search.

↑↓ navigate · open · esc close