faraday 0.16.0 → 0.17.0
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/LICENSE.md +1 -1
- data/README.md +347 -18
- data/lib/faraday/adapter/em_http.rb +99 -142
- data/lib/faraday/adapter/em_http_ssl_patch.rb +17 -23
- data/lib/faraday/adapter/em_synchrony/parallel_manager.rb +15 -18
- data/lib/faraday/adapter/em_synchrony.rb +60 -104
- data/lib/faraday/adapter/excon.rb +55 -100
- data/lib/faraday/adapter/httpclient.rb +39 -61
- data/lib/faraday/adapter/net_http.rb +51 -104
- data/lib/faraday/adapter/net_http_persistent.rb +27 -48
- data/lib/faraday/adapter/patron.rb +35 -54
- data/lib/faraday/adapter/rack.rb +12 -28
- data/lib/faraday/adapter/test.rb +53 -86
- data/lib/faraday/adapter/typhoeus.rb +1 -4
- data/lib/faraday/adapter.rb +22 -36
- data/lib/faraday/autoload.rb +36 -47
- data/lib/faraday/connection.rb +179 -321
- data/lib/faraday/error.rb +33 -67
- data/lib/faraday/middleware.rb +28 -4
- data/lib/faraday/options.rb +186 -35
- data/lib/faraday/parameters.rb +197 -4
- data/lib/faraday/rack_builder.rb +56 -67
- data/lib/faraday/request/authorization.rb +30 -42
- data/lib/faraday/request/basic_authentication.rb +7 -14
- data/lib/faraday/request/instrumentation.rb +27 -45
- data/lib/faraday/request/multipart.rb +48 -79
- data/lib/faraday/request/retry.rb +170 -197
- data/lib/faraday/request/token_authentication.rb +10 -15
- data/lib/faraday/request/url_encoded.rb +23 -41
- data/lib/faraday/request.rb +36 -68
- data/lib/faraday/response/logger.rb +69 -22
- data/lib/faraday/response/raise_error.rb +14 -36
- data/lib/faraday/response.rb +16 -23
- data/lib/faraday/upload_io.rb +67 -0
- data/lib/faraday/utils.rb +245 -28
- data/lib/faraday.rb +175 -93
- metadata +5 -22
- data/lib/faraday/adapter_registry.rb +0 -28
- data/lib/faraday/dependency_loader.rb +0 -37
- data/lib/faraday/encoders/flat_params_encoder.rb +0 -94
- data/lib/faraday/encoders/nested_params_encoder.rb +0 -171
- data/lib/faraday/file_part.rb +0 -128
- data/lib/faraday/logging/formatter.rb +0 -92
- data/lib/faraday/middleware_registry.rb +0 -129
- data/lib/faraday/options/connection_options.rb +0 -22
- data/lib/faraday/options/env.rb +0 -181
- data/lib/faraday/options/proxy_options.rb +0 -28
- data/lib/faraday/options/request_options.rb +0 -21
- data/lib/faraday/options/ssl_options.rb +0 -59
- data/lib/faraday/param_part.rb +0 -53
- data/lib/faraday/utils/headers.rb +0 -139
- data/lib/faraday/utils/params_hash.rb +0 -61
- data/spec/external_adapters/faraday_specs_setup.rb +0 -14
metadata
CHANGED
@@ -1,14 +1,14 @@
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
2
2
|
name: faraday
|
3
3
|
version: !ruby/object:Gem::Version
|
4
|
-
version: 0.
|
4
|
+
version: 0.17.0
|
5
5
|
platform: ruby
|
6
6
|
authors:
|
7
7
|
- Rick Olson
|
8
8
|
autorequire:
|
9
9
|
bindir: bin
|
10
10
|
cert_chain: []
|
11
|
-
date: 2019-
|
11
|
+
date: 2019-10-06 00:00:00.000000000 Z
|
12
12
|
dependencies:
|
13
13
|
- !ruby/object:Gem::Dependency
|
14
14
|
name: multipart-post
|
@@ -52,24 +52,11 @@ files:
|
|
52
52
|
- lib/faraday/adapter/rack.rb
|
53
53
|
- lib/faraday/adapter/test.rb
|
54
54
|
- lib/faraday/adapter/typhoeus.rb
|
55
|
-
- lib/faraday/adapter_registry.rb
|
56
55
|
- lib/faraday/autoload.rb
|
57
56
|
- lib/faraday/connection.rb
|
58
|
-
- lib/faraday/dependency_loader.rb
|
59
|
-
- lib/faraday/encoders/flat_params_encoder.rb
|
60
|
-
- lib/faraday/encoders/nested_params_encoder.rb
|
61
57
|
- lib/faraday/error.rb
|
62
|
-
- lib/faraday/file_part.rb
|
63
|
-
- lib/faraday/logging/formatter.rb
|
64
58
|
- lib/faraday/middleware.rb
|
65
|
-
- lib/faraday/middleware_registry.rb
|
66
59
|
- lib/faraday/options.rb
|
67
|
-
- lib/faraday/options/connection_options.rb
|
68
|
-
- lib/faraday/options/env.rb
|
69
|
-
- lib/faraday/options/proxy_options.rb
|
70
|
-
- lib/faraday/options/request_options.rb
|
71
|
-
- lib/faraday/options/ssl_options.rb
|
72
|
-
- lib/faraday/param_part.rb
|
73
60
|
- lib/faraday/parameters.rb
|
74
61
|
- lib/faraday/rack_builder.rb
|
75
62
|
- lib/faraday/request.rb
|
@@ -83,10 +70,8 @@ files:
|
|
83
70
|
- lib/faraday/response.rb
|
84
71
|
- lib/faraday/response/logger.rb
|
85
72
|
- lib/faraday/response/raise_error.rb
|
73
|
+
- lib/faraday/upload_io.rb
|
86
74
|
- lib/faraday/utils.rb
|
87
|
-
- lib/faraday/utils/headers.rb
|
88
|
-
- lib/faraday/utils/params_hash.rb
|
89
|
-
- spec/external_adapters/faraday_specs_setup.rb
|
90
75
|
homepage: https://github.com/lostisland/faraday
|
91
76
|
licenses:
|
92
77
|
- MIT
|
@@ -95,20 +80,18 @@ post_install_message:
|
|
95
80
|
rdoc_options: []
|
96
81
|
require_paths:
|
97
82
|
- lib
|
98
|
-
- spec/external_adapters
|
99
83
|
required_ruby_version: !ruby/object:Gem::Requirement
|
100
84
|
requirements:
|
101
85
|
- - ">="
|
102
86
|
- !ruby/object:Gem::Version
|
103
|
-
version: '
|
87
|
+
version: '1.9'
|
104
88
|
required_rubygems_version: !ruby/object:Gem::Requirement
|
105
89
|
requirements:
|
106
90
|
- - ">="
|
107
91
|
- !ruby/object:Gem::Version
|
108
92
|
version: '0'
|
109
93
|
requirements: []
|
110
|
-
|
111
|
-
rubygems_version: 2.7.6.2
|
94
|
+
rubygems_version: 3.0.3
|
112
95
|
signing_key:
|
113
96
|
specification_version: 4
|
114
97
|
summary: HTTP/REST API client library.
|
@@ -1,28 +0,0 @@
|
|
1
|
-
# frozen_string_literal: true
|
2
|
-
|
3
|
-
require 'monitor'
|
4
|
-
|
5
|
-
module Faraday
|
6
|
-
# AdapterRegistry registers adapter class names so they can be looked up by a
|
7
|
-
# String or Symbol name.
|
8
|
-
class AdapterRegistry
|
9
|
-
def initialize
|
10
|
-
@lock = Monitor.new
|
11
|
-
@constants = {}
|
12
|
-
end
|
13
|
-
|
14
|
-
def get(name)
|
15
|
-
klass = @constants[name]
|
16
|
-
return klass if klass
|
17
|
-
|
18
|
-
Object.const_get(name).tap { |c| set(c, name) }
|
19
|
-
end
|
20
|
-
|
21
|
-
def set(klass, name = nil)
|
22
|
-
name ||= klass.to_s
|
23
|
-
@lock.synchronize do
|
24
|
-
@constants[name] = klass
|
25
|
-
end
|
26
|
-
end
|
27
|
-
end
|
28
|
-
end
|
@@ -1,37 +0,0 @@
|
|
1
|
-
# frozen_string_literal: true
|
2
|
-
|
3
|
-
module Faraday
|
4
|
-
# DependencyLoader helps Faraday adapters and middleware load dependencies.
|
5
|
-
module DependencyLoader
|
6
|
-
attr_reader :load_error
|
7
|
-
|
8
|
-
# Executes a block which should try to require and reference dependent
|
9
|
-
# libraries
|
10
|
-
def dependency(lib = nil)
|
11
|
-
lib ? require(lib) : yield
|
12
|
-
rescue LoadError, NameError => e
|
13
|
-
self.load_error = e
|
14
|
-
end
|
15
|
-
|
16
|
-
def new(*)
|
17
|
-
unless loaded?
|
18
|
-
raise "missing dependency for #{self}: #{load_error.message}"
|
19
|
-
end
|
20
|
-
|
21
|
-
super
|
22
|
-
end
|
23
|
-
|
24
|
-
def loaded?
|
25
|
-
load_error.nil?
|
26
|
-
end
|
27
|
-
|
28
|
-
def inherited(subclass)
|
29
|
-
super
|
30
|
-
subclass.send(:load_error=, load_error)
|
31
|
-
end
|
32
|
-
|
33
|
-
private
|
34
|
-
|
35
|
-
attr_writer :load_error
|
36
|
-
end
|
37
|
-
end
|
@@ -1,94 +0,0 @@
|
|
1
|
-
# frozen_string_literal: true
|
2
|
-
|
3
|
-
module Faraday
|
4
|
-
# FlatParamsEncoder manages URI params as a flat hash. Any Array values repeat
|
5
|
-
# the parameter multiple times.
|
6
|
-
module FlatParamsEncoder
|
7
|
-
class << self
|
8
|
-
extend Forwardable
|
9
|
-
def_delegators :'Faraday::Utils', :escape, :unescape
|
10
|
-
end
|
11
|
-
|
12
|
-
# Encode converts the given param into a URI querystring. Keys and values
|
13
|
-
# will converted to strings and appropriately escaped for the URI.
|
14
|
-
#
|
15
|
-
# @param params [Hash] query arguments to convert.
|
16
|
-
#
|
17
|
-
# @example
|
18
|
-
#
|
19
|
-
# encode({a: %w[one two three], b: true, c: "C"})
|
20
|
-
# # => 'a=one&a=two&a=three&b=true&c=C'
|
21
|
-
#
|
22
|
-
# @return [String] the URI querystring (without the leading '?')
|
23
|
-
def self.encode(params)
|
24
|
-
return nil if params.nil?
|
25
|
-
|
26
|
-
unless params.is_a?(Array)
|
27
|
-
unless params.respond_to?(:to_hash)
|
28
|
-
raise TypeError,
|
29
|
-
"Can't convert #{params.class} into Hash."
|
30
|
-
end
|
31
|
-
params = params.to_hash
|
32
|
-
params = params.map do |key, value|
|
33
|
-
key = key.to_s if key.is_a?(Symbol)
|
34
|
-
[key, value]
|
35
|
-
end
|
36
|
-
# Useful default for OAuth and caching.
|
37
|
-
# Only to be used for non-Array inputs. Arrays should preserve order.
|
38
|
-
params.sort!
|
39
|
-
end
|
40
|
-
|
41
|
-
# The params have form [['key1', 'value1'], ['key2', 'value2']].
|
42
|
-
buffer = +''
|
43
|
-
params.each do |key, value|
|
44
|
-
encoded_key = escape(key)
|
45
|
-
if value.nil?
|
46
|
-
buffer << "#{encoded_key}&"
|
47
|
-
elsif value.is_a?(Array)
|
48
|
-
value.each do |sub_value|
|
49
|
-
encoded_value = escape(sub_value)
|
50
|
-
buffer << "#{encoded_key}=#{encoded_value}&"
|
51
|
-
end
|
52
|
-
else
|
53
|
-
encoded_value = escape(value)
|
54
|
-
buffer << "#{encoded_key}=#{encoded_value}&"
|
55
|
-
end
|
56
|
-
end
|
57
|
-
buffer.chop
|
58
|
-
end
|
59
|
-
|
60
|
-
# Decode converts the given URI querystring into a hash.
|
61
|
-
#
|
62
|
-
# @param query [String] query arguments to parse.
|
63
|
-
#
|
64
|
-
# @example
|
65
|
-
#
|
66
|
-
# decode('a=one&a=two&a=three&b=true&c=C')
|
67
|
-
# # => {"a"=>["one", "two", "three"], "b"=>"true", "c"=>"C"}
|
68
|
-
#
|
69
|
-
# @return [Hash] parsed keys and value strings from the querystring.
|
70
|
-
def self.decode(query)
|
71
|
-
return nil if query.nil?
|
72
|
-
|
73
|
-
empty_accumulator = {}
|
74
|
-
|
75
|
-
split_query = (query.split('&').map do |pair|
|
76
|
-
pair.split('=', 2) if pair && !pair.empty?
|
77
|
-
end).compact
|
78
|
-
split_query.each_with_object(empty_accumulator.dup) do |pair, accu|
|
79
|
-
pair[0] = unescape(pair[0])
|
80
|
-
pair[1] = true if pair[1].nil?
|
81
|
-
if pair[1].respond_to?(:to_str)
|
82
|
-
pair[1] = unescape(pair[1].to_str.tr('+', ' '))
|
83
|
-
end
|
84
|
-
if accu[pair[0]].is_a?(Array)
|
85
|
-
accu[pair[0]] << pair[1]
|
86
|
-
elsif accu[pair[0]]
|
87
|
-
accu[pair[0]] = [accu[pair[0]], pair[1]]
|
88
|
-
else
|
89
|
-
accu[pair[0]] = pair[1]
|
90
|
-
end
|
91
|
-
end
|
92
|
-
end
|
93
|
-
end
|
94
|
-
end
|
@@ -1,171 +0,0 @@
|
|
1
|
-
# frozen_string_literal: true
|
2
|
-
|
3
|
-
module Faraday
|
4
|
-
# Sub-module for encoding parameters into query-string.
|
5
|
-
module EncodeMethods
|
6
|
-
# @param params [nil, Array, #to_hash] parameters to be encoded
|
7
|
-
#
|
8
|
-
# @return [String] the encoded params
|
9
|
-
#
|
10
|
-
# @raise [TypeError] if params can not be converted to a Hash
|
11
|
-
def encode(params)
|
12
|
-
return nil if params.nil?
|
13
|
-
|
14
|
-
unless params.is_a?(Array)
|
15
|
-
unless params.respond_to?(:to_hash)
|
16
|
-
raise TypeError, "Can't convert #{params.class} into Hash."
|
17
|
-
end
|
18
|
-
|
19
|
-
params = params.to_hash
|
20
|
-
params = params.map do |key, value|
|
21
|
-
key = key.to_s if key.is_a?(Symbol)
|
22
|
-
[key, value]
|
23
|
-
end
|
24
|
-
# Useful default for OAuth and caching.
|
25
|
-
# Only to be used for non-Array inputs. Arrays should preserve order.
|
26
|
-
params.sort!
|
27
|
-
end
|
28
|
-
|
29
|
-
# The params have form [['key1', 'value1'], ['key2', 'value2']].
|
30
|
-
buffer = +''
|
31
|
-
params.each do |parent, value|
|
32
|
-
encoded_parent = escape(parent)
|
33
|
-
buffer << "#{encode_pair(encoded_parent, value)}&"
|
34
|
-
end
|
35
|
-
buffer.chop
|
36
|
-
end
|
37
|
-
|
38
|
-
protected
|
39
|
-
|
40
|
-
def encode_pair(parent, value)
|
41
|
-
if value.is_a?(Hash)
|
42
|
-
encode_hash(parent, value)
|
43
|
-
elsif value.is_a?(Array)
|
44
|
-
encode_array(parent, value)
|
45
|
-
elsif value.nil?
|
46
|
-
parent
|
47
|
-
else
|
48
|
-
encoded_value = escape(value)
|
49
|
-
"#{parent}=#{encoded_value}"
|
50
|
-
end
|
51
|
-
end
|
52
|
-
|
53
|
-
def encode_hash(parent, value)
|
54
|
-
value = value.map { |key, val| [escape(key), val] }.sort
|
55
|
-
|
56
|
-
buffer = +''
|
57
|
-
value.each do |key, val|
|
58
|
-
new_parent = "#{parent}%5B#{key}%5D"
|
59
|
-
buffer << "#{encode_pair(new_parent, val)}&"
|
60
|
-
end
|
61
|
-
buffer.chop
|
62
|
-
end
|
63
|
-
|
64
|
-
def encode_array(parent, value)
|
65
|
-
new_parent = "#{parent}%5B%5D"
|
66
|
-
return new_parent if value.empty?
|
67
|
-
|
68
|
-
buffer = +''
|
69
|
-
value.each { |val| buffer << "#{encode_pair(new_parent, val)}&" }
|
70
|
-
buffer.chop
|
71
|
-
end
|
72
|
-
end
|
73
|
-
|
74
|
-
# Sub-module for decoding query-string into parameters.
|
75
|
-
module DecodeMethods
|
76
|
-
# @param query [nil, String]
|
77
|
-
#
|
78
|
-
# @return [Array<Array, String>] the decoded params
|
79
|
-
#
|
80
|
-
# @raise [TypeError] if the nesting is incorrect
|
81
|
-
def decode(query)
|
82
|
-
return nil if query.nil?
|
83
|
-
|
84
|
-
params = {}
|
85
|
-
query.split('&').each do |pair|
|
86
|
-
next if pair.empty?
|
87
|
-
|
88
|
-
key, value = pair.split('=', 2)
|
89
|
-
key = unescape(key)
|
90
|
-
value = unescape(value.tr('+', ' ')) if value
|
91
|
-
decode_pair(key, value, params)
|
92
|
-
end
|
93
|
-
|
94
|
-
dehash(params, 0)
|
95
|
-
end
|
96
|
-
|
97
|
-
protected
|
98
|
-
|
99
|
-
SUBKEYS_REGEX = /[^\[\]]+(?:\]?\[\])?/.freeze
|
100
|
-
|
101
|
-
def decode_pair(key, value, context)
|
102
|
-
subkeys = key.scan(SUBKEYS_REGEX)
|
103
|
-
subkeys.each_with_index do |subkey, i|
|
104
|
-
is_array = subkey =~ /[\[\]]+\Z/
|
105
|
-
subkey = $` if is_array
|
106
|
-
last_subkey = i == subkeys.length - 1
|
107
|
-
|
108
|
-
context = prepare_context(context, subkey, is_array, last_subkey)
|
109
|
-
add_to_context(is_array, context, value, subkey) if last_subkey
|
110
|
-
end
|
111
|
-
end
|
112
|
-
|
113
|
-
def prepare_context(context, subkey, is_array, last_subkey)
|
114
|
-
if !last_subkey || is_array
|
115
|
-
context = new_context(subkey, is_array, context)
|
116
|
-
end
|
117
|
-
if context.is_a?(Array) && !is_array
|
118
|
-
context = match_context(context, subkey)
|
119
|
-
end
|
120
|
-
context
|
121
|
-
end
|
122
|
-
|
123
|
-
def new_context(subkey, is_array, context)
|
124
|
-
value_type = is_array ? Array : Hash
|
125
|
-
if context[subkey] && !context[subkey].is_a?(value_type)
|
126
|
-
raise TypeError, "expected #{value_type.name} " \
|
127
|
-
"(got #{context[subkey].class.name}) for param `#{subkey}'"
|
128
|
-
end
|
129
|
-
|
130
|
-
context[subkey] ||= value_type.new
|
131
|
-
end
|
132
|
-
|
133
|
-
def match_context(context, subkey)
|
134
|
-
context << {} if !context.last.is_a?(Hash) || context.last.key?(subkey)
|
135
|
-
context.last
|
136
|
-
end
|
137
|
-
|
138
|
-
def add_to_context(is_array, context, value, subkey)
|
139
|
-
is_array ? context << value : context[subkey] = value
|
140
|
-
end
|
141
|
-
|
142
|
-
# Internal: convert a nested hash with purely numeric keys into an array.
|
143
|
-
# FIXME: this is not compatible with Rack::Utils.parse_nested_query
|
144
|
-
# @!visibility private
|
145
|
-
def dehash(hash, depth)
|
146
|
-
hash.each do |key, value|
|
147
|
-
hash[key] = dehash(value, depth + 1) if value.is_a?(Hash)
|
148
|
-
end
|
149
|
-
|
150
|
-
if depth.positive? && !hash.empty? && hash.keys.all? { |k| k =~ /^\d+$/ }
|
151
|
-
hash.sort.map(&:last)
|
152
|
-
else
|
153
|
-
hash
|
154
|
-
end
|
155
|
-
end
|
156
|
-
end
|
157
|
-
|
158
|
-
# This is the default encoder for Faraday requests.
|
159
|
-
# Using this encoder, parameters will be encoded respecting their structure,
|
160
|
-
# so you can send objects such as Arrays or Hashes as parameters
|
161
|
-
# for your requests.
|
162
|
-
module NestedParamsEncoder
|
163
|
-
class << self
|
164
|
-
extend Forwardable
|
165
|
-
def_delegators :'Faraday::Utils', :escape, :unescape
|
166
|
-
end
|
167
|
-
|
168
|
-
extend EncodeMethods
|
169
|
-
extend DecodeMethods
|
170
|
-
end
|
171
|
-
end
|
data/lib/faraday/file_part.rb
DELETED
@@ -1,128 +0,0 @@
|
|
1
|
-
# frozen_string_literal: true
|
2
|
-
|
3
|
-
require 'stringio'
|
4
|
-
|
5
|
-
# multipart-post gem
|
6
|
-
require 'composite_io'
|
7
|
-
require 'parts'
|
8
|
-
|
9
|
-
module Faraday
|
10
|
-
# Multipart value used to POST a binary data from a file or
|
11
|
-
#
|
12
|
-
# @example
|
13
|
-
# payload = { file: Faraday::FilePart.new("file_name.ext", "content/type") }
|
14
|
-
# http.post("/upload", payload)
|
15
|
-
#
|
16
|
-
|
17
|
-
# @!method initialize(filename_or_io, content_type, filename = nil, opts = {})
|
18
|
-
#
|
19
|
-
# @param filename_or_io [String, IO] Either a String filename to a local
|
20
|
-
# file or an open IO object.
|
21
|
-
# @param content_type [String] String content type of the file data.
|
22
|
-
# @param filename [String] Optional String filename, usually to add context
|
23
|
-
# to a given IO object.
|
24
|
-
# @param opts [Hash] Optional Hash of String key/value pairs to describethis
|
25
|
-
# this uploaded file. Expected Header keys include:
|
26
|
-
# * Content-Transfer-Encoding - Defaults to "binary"
|
27
|
-
# * Content-Disposition - Defaults to "form-data"
|
28
|
-
# * Content-Type - Defaults to the content_type argument.
|
29
|
-
# * Content-ID - Optional.
|
30
|
-
#
|
31
|
-
# @return [Faraday::FilePart]
|
32
|
-
#
|
33
|
-
# @!attribute [r] content_type
|
34
|
-
# The uploaded binary data's content type.
|
35
|
-
#
|
36
|
-
# @return [String]
|
37
|
-
#
|
38
|
-
# @!attribute [r] original_filename
|
39
|
-
# The base filename, taken either from the filename_or_io or filename
|
40
|
-
# arguments in #initialize.
|
41
|
-
#
|
42
|
-
# @return [String]
|
43
|
-
#
|
44
|
-
# @!attribute [r] opts
|
45
|
-
# Extra String key/value pairs to make up the header for this uploaded file.
|
46
|
-
#
|
47
|
-
# @return [Hash]
|
48
|
-
#
|
49
|
-
# @!attribute [r] io
|
50
|
-
# The open IO object for the uploaded file.
|
51
|
-
#
|
52
|
-
# @return [IO]
|
53
|
-
FilePart = ::UploadIO
|
54
|
-
|
55
|
-
# Multipart value used to POST a file.
|
56
|
-
#
|
57
|
-
# @deprecated Use FilePart instead of this class. It behaves identically, with
|
58
|
-
# a matching name to ParamPart.
|
59
|
-
UploadIO = ::UploadIO
|
60
|
-
|
61
|
-
Parts = ::Parts
|
62
|
-
|
63
|
-
# Similar to, but not compatible with CompositeReadIO provided by the
|
64
|
-
# multipart-post gem.
|
65
|
-
# https://github.com/nicksieger/multipart-post/blob/master/lib/composite_io.rb
|
66
|
-
class CompositeReadIO
|
67
|
-
def initialize(*parts)
|
68
|
-
@parts = parts.flatten
|
69
|
-
@ios = @parts.map(&:to_io)
|
70
|
-
@index = 0
|
71
|
-
end
|
72
|
-
|
73
|
-
# @return [Integer] sum of the lengths of all the parts
|
74
|
-
def length
|
75
|
-
@parts.inject(0) { |sum, part| sum + part.length }
|
76
|
-
end
|
77
|
-
|
78
|
-
# Rewind each of the IOs and reset the index to 0.
|
79
|
-
#
|
80
|
-
# @return [void]
|
81
|
-
def rewind
|
82
|
-
@ios.each(&:rewind)
|
83
|
-
@index = 0
|
84
|
-
end
|
85
|
-
|
86
|
-
# Read from IOs in order until `length` bytes have been received.
|
87
|
-
#
|
88
|
-
# @param length [Integer, nil]
|
89
|
-
# @param outbuf [String, nil]
|
90
|
-
def read(length = nil, outbuf = nil)
|
91
|
-
got_result = false
|
92
|
-
outbuf = outbuf ? (+outbuf).replace('') : +''
|
93
|
-
|
94
|
-
while (io = current_io)
|
95
|
-
if (result = io.read(length))
|
96
|
-
got_result ||= !result.nil?
|
97
|
-
result.force_encoding('BINARY') if result.respond_to?(:force_encoding)
|
98
|
-
outbuf << result
|
99
|
-
length -= result.length if length
|
100
|
-
break if length&.zero?
|
101
|
-
end
|
102
|
-
advance_io
|
103
|
-
end
|
104
|
-
!got_result && length ? nil : outbuf
|
105
|
-
end
|
106
|
-
|
107
|
-
# Close each of the IOs.
|
108
|
-
#
|
109
|
-
# @return [void]
|
110
|
-
def close
|
111
|
-
@ios.each(&:close)
|
112
|
-
end
|
113
|
-
|
114
|
-
def ensure_open_and_readable
|
115
|
-
# Rubinius compatibility
|
116
|
-
end
|
117
|
-
|
118
|
-
private
|
119
|
-
|
120
|
-
def current_io
|
121
|
-
@ios[@index]
|
122
|
-
end
|
123
|
-
|
124
|
-
def advance_io
|
125
|
-
@index += 1
|
126
|
-
end
|
127
|
-
end
|
128
|
-
end
|
@@ -1,92 +0,0 @@
|
|
1
|
-
# frozen_string_literal: true
|
2
|
-
|
3
|
-
require 'pp'
|
4
|
-
module Faraday
|
5
|
-
module Logging
|
6
|
-
# Serves as an integration point to customize logging
|
7
|
-
class Formatter
|
8
|
-
extend Forwardable
|
9
|
-
|
10
|
-
DEFAULT_OPTIONS = { headers: true, bodies: false }.freeze
|
11
|
-
|
12
|
-
def initialize(logger:, options:)
|
13
|
-
@logger = logger
|
14
|
-
@filter = []
|
15
|
-
@options = DEFAULT_OPTIONS.merge(options)
|
16
|
-
end
|
17
|
-
|
18
|
-
def_delegators :@logger, :debug, :info, :warn, :error, :fatal
|
19
|
-
|
20
|
-
def request(env)
|
21
|
-
info('request') do
|
22
|
-
"#{env.method.upcase} #{apply_filters(env.url.to_s)}"
|
23
|
-
end
|
24
|
-
if log_headers?(:request)
|
25
|
-
debug('request') { apply_filters(dump_headers(env.request_headers)) }
|
26
|
-
end
|
27
|
-
return unless env[:body] && log_body?(:request)
|
28
|
-
|
29
|
-
debug('request') { apply_filters(dump_body(env[:body])) }
|
30
|
-
end
|
31
|
-
|
32
|
-
def response(env)
|
33
|
-
info('response') { "Status #{env.status}" }
|
34
|
-
if log_headers?(:response)
|
35
|
-
debug('response') do
|
36
|
-
apply_filters(dump_headers(env.response_headers))
|
37
|
-
end
|
38
|
-
end
|
39
|
-
return unless env[:body] && log_body?(:response)
|
40
|
-
|
41
|
-
debug('response') { apply_filters(dump_body(env[:body])) }
|
42
|
-
end
|
43
|
-
|
44
|
-
def filter(filter_word, filter_replacement)
|
45
|
-
@filter.push([filter_word, filter_replacement])
|
46
|
-
end
|
47
|
-
|
48
|
-
private
|
49
|
-
|
50
|
-
def dump_headers(headers)
|
51
|
-
headers.map { |k, v| "#{k}: #{v.inspect}" }.join("\n")
|
52
|
-
end
|
53
|
-
|
54
|
-
def dump_body(body)
|
55
|
-
if body.respond_to?(:to_str)
|
56
|
-
body.to_str
|
57
|
-
else
|
58
|
-
pretty_inspect(body)
|
59
|
-
end
|
60
|
-
end
|
61
|
-
|
62
|
-
def pretty_inspect(body)
|
63
|
-
body.pretty_inspect
|
64
|
-
end
|
65
|
-
|
66
|
-
def log_headers?(type)
|
67
|
-
case @options[:headers]
|
68
|
-
when Hash
|
69
|
-
@options[:headers][type]
|
70
|
-
else
|
71
|
-
@options[:headers]
|
72
|
-
end
|
73
|
-
end
|
74
|
-
|
75
|
-
def log_body?(type)
|
76
|
-
case @options[:bodies]
|
77
|
-
when Hash
|
78
|
-
@options[:bodies][type]
|
79
|
-
else
|
80
|
-
@options[:bodies]
|
81
|
-
end
|
82
|
-
end
|
83
|
-
|
84
|
-
def apply_filters(output)
|
85
|
-
@filter.each do |pattern, replacement|
|
86
|
-
output = output.to_s.gsub(pattern, replacement)
|
87
|
-
end
|
88
|
-
output
|
89
|
-
end
|
90
|
-
end
|
91
|
-
end
|
92
|
-
end
|