1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
|
# frozen_string_literal: true
module HTTP
module FormData
# Represents file form param.
#
# @example Usage with StringIO
#
# io = StringIO.new "foo bar baz"
# FormData::File.new io, :filename => "foobar.txt"
#
# @example Usage with IO
#
# File.open "/home/ixti/avatar.png" do |io|
# FormData::File.new io
# end
#
# @example Usage with pathname
#
# FormData::File.new "/home/ixti/avatar.png"
class File < Part
# Default MIME type
DEFAULT_MIME = "application/octet-stream"
# @deprecated Use #content_type instead
alias mime_type content_type
# @see DEFAULT_MIME
# @param [String, Pathname, IO] path_or_io Filename or IO instance.
# @param [#to_h] opts
# @option opts [#to_s] :content_type (DEFAULT_MIME)
# Value of Content-Type header
# @option opts [#to_s] :filename
# When `path_or_io` is a String, Pathname or File, defaults to basename.
# When `path_or_io` is a IO, defaults to `"stream-{object_id}"`.
def initialize(path_or_io, opts = {})
opts = FormData.ensure_hash(opts)
if opts.key? :mime_type
warn "[DEPRECATED] :mime_type option deprecated, use :content_type"
opts[:content_type] = opts[:mime_type]
end
@io = make_io(path_or_io)
@content_type = opts.fetch(:content_type, DEFAULT_MIME).to_s
@filename = opts.fetch(:filename, filename_for(@io))
end
private
def make_io(path_or_io)
if path_or_io.is_a?(String)
::File.open(path_or_io, :binmode => true)
elsif defined?(Pathname) && path_or_io.is_a?(Pathname)
path_or_io.open(:binmode => true)
else
path_or_io
end
end
def filename_for(io)
if io.respond_to?(:path)
::File.basename io.path
else
"stream-#{io.object_id}"
end
end
end
end
end
|
