faraday 0.9.1 → 1.0.0
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +5 -5
- data/CHANGELOG.md +256 -0
- data/LICENSE.md +1 -1
- data/README.md +30 -195
- data/Rakefile +4 -68
- data/UPGRADING.md +55 -0
- data/examples/client_spec.rb +65 -0
- data/examples/client_test.rb +79 -0
- data/lib/faraday/adapter/em_http.rb +149 -101
- data/lib/faraday/adapter/em_http_ssl_patch.rb +25 -19
- data/lib/faraday/adapter/em_synchrony/parallel_manager.rb +18 -15
- data/lib/faraday/adapter/em_synchrony.rb +107 -49
- data/lib/faraday/adapter/excon.rb +98 -54
- data/lib/faraday/adapter/httpclient.rb +96 -51
- data/lib/faraday/adapter/net_http.rb +132 -53
- data/lib/faraday/adapter/net_http_persistent.rb +70 -27
- data/lib/faraday/adapter/patron.rb +98 -38
- data/lib/faraday/adapter/rack.rb +30 -13
- data/lib/faraday/adapter/test.rb +136 -52
- data/lib/faraday/adapter/typhoeus.rb +7 -115
- data/lib/faraday/adapter.rb +89 -20
- data/lib/faraday/adapter_registry.rb +28 -0
- data/lib/faraday/autoload.rb +47 -36
- data/lib/faraday/connection.rb +347 -165
- data/lib/faraday/dependency_loader.rb +37 -0
- data/lib/faraday/encoders/flat_params_encoder.rb +98 -0
- data/lib/faraday/encoders/nested_params_encoder.rb +171 -0
- data/lib/faraday/error.rb +108 -29
- data/lib/faraday/file_part.rb +128 -0
- data/lib/faraday/logging/formatter.rb +105 -0
- data/lib/faraday/middleware.rb +12 -28
- data/lib/faraday/middleware_registry.rb +129 -0
- data/lib/faraday/options/connection_options.rb +22 -0
- data/lib/faraday/options/env.rb +181 -0
- data/lib/faraday/options/proxy_options.rb +28 -0
- data/lib/faraday/options/request_options.rb +22 -0
- data/lib/faraday/options/ssl_options.rb +59 -0
- data/lib/faraday/options.rb +57 -185
- data/lib/faraday/param_part.rb +53 -0
- data/lib/faraday/parameters.rb +4 -180
- data/lib/faraday/rack_builder.rb +74 -38
- data/lib/faraday/request/authorization.rb +42 -31
- data/lib/faraday/request/basic_authentication.rb +14 -7
- data/lib/faraday/request/instrumentation.rb +45 -27
- data/lib/faraday/request/multipart.rb +81 -45
- data/lib/faraday/request/retry.rb +212 -121
- data/lib/faraday/request/token_authentication.rb +15 -10
- data/lib/faraday/request/url_encoded.rb +41 -23
- data/lib/faraday/request.rb +84 -30
- data/lib/faraday/response/logger.rb +22 -48
- data/lib/faraday/response/raise_error.rb +38 -14
- data/lib/faraday/response.rb +29 -18
- data/lib/faraday/utils/headers.rb +139 -0
- data/lib/faraday/utils/params_hash.rb +61 -0
- data/lib/faraday/utils.rb +28 -216
- data/lib/faraday.rb +102 -204
- data/spec/external_adapters/faraday_specs_setup.rb +14 -0
- data/spec/faraday/adapter/em_http_spec.rb +47 -0
- data/spec/faraday/adapter/em_synchrony_spec.rb +16 -0
- data/spec/faraday/adapter/excon_spec.rb +49 -0
- data/spec/faraday/adapter/httpclient_spec.rb +73 -0
- data/spec/faraday/adapter/net_http_persistent_spec.rb +57 -0
- data/spec/faraday/adapter/net_http_spec.rb +64 -0
- data/spec/faraday/adapter/patron_spec.rb +18 -0
- data/spec/faraday/adapter/rack_spec.rb +8 -0
- data/spec/faraday/adapter/typhoeus_spec.rb +7 -0
- data/spec/faraday/adapter_registry_spec.rb +28 -0
- data/spec/faraday/adapter_spec.rb +55 -0
- data/spec/faraday/composite_read_io_spec.rb +80 -0
- data/spec/faraday/connection_spec.rb +691 -0
- data/spec/faraday/error_spec.rb +45 -0
- data/spec/faraday/middleware_spec.rb +26 -0
- data/spec/faraday/options/env_spec.rb +70 -0
- data/spec/faraday/options/options_spec.rb +297 -0
- data/spec/faraday/options/proxy_options_spec.rb +37 -0
- data/spec/faraday/options/request_options_spec.rb +19 -0
- data/spec/faraday/params_encoders/flat_spec.rb +34 -0
- data/spec/faraday/params_encoders/nested_spec.rb +134 -0
- data/spec/faraday/rack_builder_spec.rb +196 -0
- data/spec/faraday/request/authorization_spec.rb +88 -0
- data/spec/faraday/request/instrumentation_spec.rb +76 -0
- data/spec/faraday/request/multipart_spec.rb +274 -0
- data/spec/faraday/request/retry_spec.rb +242 -0
- data/spec/faraday/request/url_encoded_spec.rb +70 -0
- data/spec/faraday/request_spec.rb +109 -0
- data/spec/faraday/response/logger_spec.rb +220 -0
- data/spec/faraday/response/middleware_spec.rb +52 -0
- data/spec/faraday/response/raise_error_spec.rb +106 -0
- data/spec/faraday/response_spec.rb +75 -0
- data/spec/faraday/utils/headers_spec.rb +82 -0
- data/spec/faraday/utils_spec.rb +56 -0
- data/spec/faraday_spec.rb +37 -0
- data/spec/spec_helper.rb +132 -0
- data/spec/support/disabling_stub.rb +14 -0
- data/spec/support/fake_safe_buffer.rb +15 -0
- data/spec/support/helper_methods.rb +133 -0
- data/spec/support/shared_examples/adapter.rb +104 -0
- data/spec/support/shared_examples/params_encoder.rb +18 -0
- data/spec/support/shared_examples/request_method.rb +234 -0
- data/spec/support/streaming_response_checker.rb +35 -0
- data/spec/support/webmock_rack_app.rb +68 -0
- metadata +79 -96
- data/.document +0 -6
- data/CONTRIBUTING.md +0 -36
- data/Gemfile +0 -25
- data/faraday.gemspec +0 -34
- data/lib/faraday/upload_io.rb +0 -67
- data/script/cached-bundle +0 -46
- data/script/console +0 -7
- data/script/generate_certs +0 -42
- data/script/package +0 -7
- data/script/proxy-server +0 -42
- data/script/release +0 -17
- data/script/s3-put +0 -71
- data/script/server +0 -36
- data/script/test +0 -172
- data/test/adapters/default_test.rb +0 -14
- data/test/adapters/em_http_test.rb +0 -20
- data/test/adapters/em_synchrony_test.rb +0 -20
- data/test/adapters/excon_test.rb +0 -20
- data/test/adapters/httpclient_test.rb +0 -21
- data/test/adapters/integration.rb +0 -254
- data/test/adapters/logger_test.rb +0 -82
- data/test/adapters/net_http_persistent_test.rb +0 -20
- data/test/adapters/net_http_test.rb +0 -14
- data/test/adapters/patron_test.rb +0 -20
- data/test/adapters/rack_test.rb +0 -31
- data/test/adapters/test_middleware_test.rb +0 -114
- data/test/adapters/typhoeus_test.rb +0 -28
- data/test/authentication_middleware_test.rb +0 -65
- data/test/composite_read_io_test.rb +0 -111
- data/test/connection_test.rb +0 -522
- data/test/env_test.rb +0 -218
- data/test/helper.rb +0 -81
- data/test/live_server.rb +0 -67
- data/test/middleware/instrumentation_test.rb +0 -88
- data/test/middleware/retry_test.rb +0 -177
- data/test/middleware_stack_test.rb +0 -173
- data/test/multibyte.txt +0 -1
- data/test/options_test.rb +0 -252
- data/test/parameters_test.rb +0 -64
- data/test/request_middleware_test.rb +0 -142
- data/test/response_middleware_test.rb +0 -72
- data/test/strawberry.rb +0 -2
- data/test/utils_test.rb +0 -58
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
|
-
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
2
|
+
SHA256:
|
3
|
+
metadata.gz: 9d3d650c5d465a0862cddd7ab2ed27fbfb4a6e5f2cfcbb54ba753bcc1ce9e40e
|
4
|
+
data.tar.gz: 953336deeb3dd2e0228368209bdffc7815b376772269c439e21374bc22b70484
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: b80c084a8714d995dec61c918891a63720dbcdddf2eb3ecb7106f40a03bb341c4f03ffe976365c5450b2dcffd0b1f52c1cd4320ea24591dfaef7d5fdbbe12562
|
7
|
+
data.tar.gz: 67f8134fae885d3bb2e621afa701d6d535409bbb0141ad699f4d290059d61bf856915f622e214251f05e8b893a69bf68439118074712a22e75e3705b249dbb85
|
data/CHANGELOG.md
CHANGED
@@ -1,5 +1,261 @@
|
|
1
1
|
# Faraday Changelog
|
2
2
|
|
3
|
+
## v1.0
|
4
|
+
|
5
|
+
Features:
|
6
|
+
|
7
|
+
* Add #trace support to Faraday::Connection #861 (@technoweenie)
|
8
|
+
* Add the log formatter that is easy to override and safe to inherit #889 (@prikha)
|
9
|
+
* Support standalone adapters #941 (@iMacTia)
|
10
|
+
* Introduce Faraday::ConflictError for 409 response code #979 (@lucasmoreno)
|
11
|
+
* Add support for setting `read_timeout` option separately #1003 (@springerigor)
|
12
|
+
* Refactor and cleanup timeout settings across adapters #1022 (@technoweenie)
|
13
|
+
* Create ParamPart class to allow multipart posts with JSON content and file upload at the same time #1017 (@jeremy-israel)
|
14
|
+
* Copy UploadIO const -> FilePart for consistency with ParamPart #1018, #1021 (@technoweenie)
|
15
|
+
* Implement streaming responses in the Excon adapter #1026 (@technoweenie)
|
16
|
+
* Add default implementation of `Middleware#close`. #1069 (@ioquatix)
|
17
|
+
* Add `Adapter#close` so that derived classes can call super. #1091 (@ioquatix)
|
18
|
+
* Add log_level option to logger default formatter #1079 (@amrrbakry)
|
19
|
+
* Fix empty array for FlatParamsEncoder `{key: []} -> "key="` #1084 (@mrexox)
|
20
|
+
|
21
|
+
Bugs:
|
22
|
+
|
23
|
+
* Explicitly require date for DateTime library in Retry middleware #844 (@nickpresta)
|
24
|
+
* Refactor Adapter as final endpoints #846 (@iMacTia)
|
25
|
+
* Separate Request and Response bodies in Faraday::Env #847 (@iMacTia)
|
26
|
+
* Implement Faraday::Connection#options to make HTTP requests with the OPTIONS verb. #857 (@technoweenie)
|
27
|
+
* Multipart: Drop Ruby 1.8 String behavior compat #892 (@olleolleolle)
|
28
|
+
* Fix Ruby warnings in Faraday::Options.memoized #962 (@technoweenie)
|
29
|
+
* Allow setting min/max SSL version for a Net::HTTP::Persistent connection #972, #973 (@bdewater, @olleolleolle)
|
30
|
+
* Fix instances of frozen empty string literals #1040 (@BobbyMcWho)
|
31
|
+
* remove temp_proxy and improve proxy tests #1063 (@technoweenie)
|
32
|
+
* improve error initializer consistency #1095 (@technoweenie)
|
33
|
+
|
34
|
+
Misc:
|
35
|
+
|
36
|
+
* Convert minitest suite to RSpec #832 (@iMacTia, with help from @gaynetdinov, @Insti, @technoweenie)
|
37
|
+
* Major effort to update code to RuboCop standards. #854 (@olleolleolle, @iMacTia, @technoweenie, @htwroclau, @jherdman, @Drenmi, @Insti)
|
38
|
+
* Rubocop #1044, #1047 (@BobbyMcWho, @olleolleolle)
|
39
|
+
* Documentation tweaks (@adsteel, @Hubro, @iMacTia, @olleolleolle, @technoweenie)
|
40
|
+
* Update license year #981 (@Kevin-Kawai)
|
41
|
+
* Configure Jekyll plugin jekyll-remote-theme to support Docker usage #999 (@Lewiscowles1986)
|
42
|
+
* Fix Ruby 2.7 warnings #1009 (@tenderlove)
|
43
|
+
* Cleanup adapter connections #1023 (@technoweenie)
|
44
|
+
* Describe clearing cached stubs #1045 (@viraptor)
|
45
|
+
* Add project metadata to the gemspec #1046 (@orien)
|
46
|
+
|
47
|
+
## v0.17.3
|
48
|
+
|
49
|
+
Fixes:
|
50
|
+
|
51
|
+
* Reverts changes in error classes hierarchy. #1092 (@iMacTia)
|
52
|
+
* Fix Ruby 1.9 syntax errors and improve Error class testing #1094 (@BanzaiMan,
|
53
|
+
@mrexox, @technoweenie)
|
54
|
+
|
55
|
+
Misc:
|
56
|
+
|
57
|
+
* Stops using `&Proc.new` for block forwarding. #1083 (@olleolleolle)
|
58
|
+
* Update CI to test against ruby 2.0-2.7 #1087, #1099 (@iMacTia, @olleolleolle,
|
59
|
+
@technoweenie)
|
60
|
+
* require FARADAY_DEPRECATE=warn to show Faraday v1.0 deprecation warnings
|
61
|
+
#1098 (@technoweenie)
|
62
|
+
|
63
|
+
## v0.17.1
|
64
|
+
|
65
|
+
Final release before Faraday v1.0, with important fixes for Ruby 2.7.
|
66
|
+
|
67
|
+
Fixes:
|
68
|
+
|
69
|
+
* RaiseError response middleware raises exception if HTTP client returns a nil
|
70
|
+
status. #1042 (@jonnyom, @BobbyMcWho)
|
71
|
+
|
72
|
+
Misc:
|
73
|
+
|
74
|
+
* Fix Ruby 2.7 warnings (#1009)
|
75
|
+
* Add `Faraday::Deprecate` to warn about upcoming v1.0 changes. (#1054, #1059,
|
76
|
+
#1076, #1077)
|
77
|
+
* Add release notes up to current in CHANGELOG.md (#1066)
|
78
|
+
* Port minimal rspec suite from main branch to run backported tests. (#1058)
|
79
|
+
|
80
|
+
## v0.17.0
|
81
|
+
|
82
|
+
This release is the same as v0.15.4. It was pushed to cover up releases
|
83
|
+
v0.16.0-v0.16.2.
|
84
|
+
|
85
|
+
## v0.15.4
|
86
|
+
|
87
|
+
* Expose `pool_size` as a option for the NetHttpPersistent adapter (#834)
|
88
|
+
|
89
|
+
## v0.15.3
|
90
|
+
|
91
|
+
* Make Faraday::Request serialisable with Marshal. (#803)
|
92
|
+
* Add DEFAULT_EXCEPTIONS constant to Request::Retry (#814)
|
93
|
+
* Add support for Ruby 2.6 Net::HTTP write_timeout (#824)
|
94
|
+
|
95
|
+
## v0.15.2
|
96
|
+
|
97
|
+
* Prevents `Net::HTTP` adapters to retry request internally by setting `max_retries` to 0 if available (Ruby 2.5+). (#799)
|
98
|
+
* Fixes `NestedParamsEncoder` handling of empty array values (#801)
|
99
|
+
|
100
|
+
## v0.15.1
|
101
|
+
|
102
|
+
* NetHttpPersistent adapter better reuse of SSL connections (#793)
|
103
|
+
* Refactor: inline cached_connection (#797)
|
104
|
+
* Logger middleware: use $stdout instead of STDOUT (#794)
|
105
|
+
* Fix: do not memoize/reuse Patron session (#796)
|
106
|
+
|
107
|
+
Also in this release:
|
108
|
+
|
109
|
+
* Allow setting min/max ssl version for Net::HTTP (#792)
|
110
|
+
* Allow setting min/max ssl version for Excon (#795)
|
111
|
+
|
112
|
+
## v0.15.0
|
113
|
+
|
114
|
+
Features:
|
115
|
+
|
116
|
+
* Added retry block option to retry middleware. (#770)
|
117
|
+
* Retry middleware improvements (honour Retry-After header, retry statuses) (#773)
|
118
|
+
* Improve response logger middleware output (#784)
|
119
|
+
|
120
|
+
Fixes:
|
121
|
+
|
122
|
+
* Remove unused class error (#767)
|
123
|
+
* Fix minor typo in README (#760)
|
124
|
+
* Reuse persistent connections when using net-http-persistent (#778)
|
125
|
+
* Fix Retry middleware documentation (#781)
|
126
|
+
* Returns the http response when giving up on retrying by status (#783)
|
127
|
+
|
128
|
+
## v0.14.0
|
129
|
+
|
130
|
+
Features:
|
131
|
+
|
132
|
+
* Allow overriding env proxy #754 (@iMacTia)
|
133
|
+
* Remove legacy Typhoeus adapter #715 (@olleolleolle)
|
134
|
+
* External Typhoeus Adapter Compatibility #748 (@iMacTia)
|
135
|
+
* Warn about missing adapter when making a request #743 (@antstorm)
|
136
|
+
* Faraday::Adapter::Test stubs now support entire urls (with host) #741 (@erik-escobedo)
|
137
|
+
|
138
|
+
Fixes:
|
139
|
+
|
140
|
+
* If proxy is manually provided, this takes priority over `find_proxy` #724 (@iMacTia)
|
141
|
+
* Fixes the behaviour for Excon's open_timeout (not setting write_timeout anymore) #731 (@apachelogger)
|
142
|
+
* Handle all connection timeout messages in Patron #687 (@stayhero)
|
143
|
+
|
144
|
+
## v0.13.1
|
145
|
+
|
146
|
+
* Fixes an incompatibility with Addressable::URI being used as uri_parser
|
147
|
+
|
148
|
+
## v0.13.0
|
149
|
+
|
150
|
+
Features:
|
151
|
+
|
152
|
+
* Dynamically reloads the proxy when performing a request on an absolute domain (#701)
|
153
|
+
* Adapter support for Net::HTTP::Persistent v3.0.0 (#619)
|
154
|
+
|
155
|
+
Fixes:
|
156
|
+
|
157
|
+
* Prefer #hostname over #host. (#714)
|
158
|
+
* Fixes an edge-case issue with response headers parsing (missing HTTP header) (#719)
|
159
|
+
|
160
|
+
## v0.12.2
|
161
|
+
|
162
|
+
* Parse headers from aggregated proxy requests/responses (#681)
|
163
|
+
* Guard against invalid middleware configuration with warning (#685)
|
164
|
+
* Do not use :insecure option by default in Patron (#691)
|
165
|
+
* Fixes an issue with HTTPClient not raising a `Faraday::ConnectionFailed` (#702)
|
166
|
+
* Fixes YAML serialization/deserialization for `Faraday::Utils::Headers` (#690)
|
167
|
+
* Fixes an issue with Options having a nil value (#694)
|
168
|
+
* Fixes an issue with Faraday.default_connection not using Faraday.default_connection_options (#698)
|
169
|
+
* Fixes an issue with Options.merge! and Faraday instrumentation middleware (#710)
|
170
|
+
|
171
|
+
## v0.12.1
|
172
|
+
|
173
|
+
* Fix an issue with Patron tests failing on jruby
|
174
|
+
* Fix an issue with new `rewind_files` feature that was causing an exception when the body was not an Hash
|
175
|
+
* Expose wrapped_exception in all client errors
|
176
|
+
* Add Authentication Section to the ReadMe
|
177
|
+
|
178
|
+
## v0.12.0.1
|
179
|
+
|
180
|
+
* Hotfix release to address an issue with TravisCI deploy on Rubygems
|
181
|
+
|
182
|
+
## v0.12.0
|
183
|
+
|
184
|
+
Features:
|
185
|
+
|
186
|
+
* Proxy feature now relies on Ruby `URI::Generic#find_proxy` and can use `no_proxy` ENV variable (not compatible with ruby < 2.0)
|
187
|
+
* Adds support for `context` request option to pass arbitrary information to middlewares
|
188
|
+
|
189
|
+
Fixes:
|
190
|
+
|
191
|
+
* Fix an issue with options that was causing new options to override defaults ones unexpectedly
|
192
|
+
* Rewind `UploadIO`s on retry to fix a compatibility issue
|
193
|
+
* Make multipart boundary unique
|
194
|
+
* Improvements in `README.md`
|
195
|
+
|
196
|
+
## v0.11.0
|
197
|
+
|
198
|
+
Features:
|
199
|
+
|
200
|
+
* Add `filter` method to Logger middleware
|
201
|
+
* Add support for Ruby2.4 and Minitest 6
|
202
|
+
* Introduce block syntax to customise the adapter
|
203
|
+
|
204
|
+
Fixes:
|
205
|
+
|
206
|
+
* Fix an issue that was allowing to override `default_connection_options` from a connection instance
|
207
|
+
* Fix a bug that was causing newline escape characters ("\n") to be used when building the Authorization header
|
208
|
+
|
209
|
+
## v0.10.1
|
210
|
+
|
211
|
+
- Fix an issue with HTTPClient adapter that was causing the SSL to be reset on every request
|
212
|
+
- Rescue `IOError` instead of specific subclass
|
213
|
+
- `Faraday::Utils::Headers` can now be successfully serialised in YAML
|
214
|
+
- Handle `default_connection_options` set with hash
|
215
|
+
|
216
|
+
## v0.10.0
|
217
|
+
|
218
|
+
Breaking changes:
|
219
|
+
- Drop support for Ruby 1.8
|
220
|
+
|
221
|
+
Features:
|
222
|
+
- Include wrapped exception/reponse in ClientErrors
|
223
|
+
- Add `response.reason_phrase`
|
224
|
+
- Provide option to selectively skip logging request/response headers
|
225
|
+
- Add regex support for pattern matching in `test` adapter
|
226
|
+
|
227
|
+
Fixes:
|
228
|
+
- Add `Faraday.respond_to?` to find methods managed by `method_missing`
|
229
|
+
- em-http: `request.host` instead of `connection.host` should be taken for SSL validations
|
230
|
+
- Allow `default_connection_options` to be merged when options are passed as url parameter
|
231
|
+
- Improve splitting key-value pairs in raw HTTP headers
|
232
|
+
|
233
|
+
## v0.9.2
|
234
|
+
|
235
|
+
Adapters:
|
236
|
+
- Enable gzip compression for httpclient
|
237
|
+
- Fixes default certificate store for httpclient not having default paths.
|
238
|
+
- Make excon adapter compatible with 0.44 excon version
|
239
|
+
- Add compatibility with Patron 0.4.20
|
240
|
+
- Determine default port numbers in Net::HTTP adapters (Addressable compatibility)
|
241
|
+
- em-http: wrap "connection closed by server" as ConnectionFailed type
|
242
|
+
- Wrap Errno::ETIMEDOUT in Faraday::Error::TimeoutError
|
243
|
+
|
244
|
+
Utils:
|
245
|
+
- Add Rack-compatible support for parsing `a[][b]=c` nested queries
|
246
|
+
- Encode nil values in queries different than empty strings. Before: `a=`; now: `a`.
|
247
|
+
- Have `Faraday::Utils::Headers#replace` clear internal key cache
|
248
|
+
- Dup the internal key cache when a Headers hash is copied
|
249
|
+
|
250
|
+
Env and middleware:
|
251
|
+
- Ensure `env` stored on middleware response has reference to the response
|
252
|
+
- Ensure that Response properties are initialized during `on_complete` (VCR compatibility)
|
253
|
+
- Copy request options in Faraday::Connection#dup
|
254
|
+
- Env custom members should be copied by Env.from(env)
|
255
|
+
- Honour per-request `request.options.params_encoder`
|
256
|
+
- Fix `interval_randomness` data type for Retry middleware
|
257
|
+
- Add maximum interval option for Retry middleware
|
258
|
+
|
3
259
|
## v0.9.1
|
4
260
|
|
5
261
|
* Refactor Net:HTTP adapter so that with_net_http_connection can be overridden to allow pooled connections. (@Ben-M)
|
data/LICENSE.md
CHANGED
data/README.md
CHANGED
@@ -1,200 +1,32 @@
|
|
1
|
-
# Faraday
|
1
|
+
# ![Faraday](./docs/assets/img/repo-card-slim.png)
|
2
2
|
|
3
|
-
|
4
|
-
|
5
|
-
|
6
|
-
|
7
|
-
|
8
|
-
|
9
|
-
* Net::HTTP
|
10
|
-
* [Excon][]
|
11
|
-
* [Typhoeus][]
|
12
|
-
* [Patron][]
|
13
|
-
* [EventMachine][]
|
14
|
-
* [HTTPClient][]
|
15
|
-
|
16
|
-
It also includes a Rack adapter for hitting loaded Rack applications through
|
17
|
-
Rack::Test, and a Test adapter for stubbing requests by hand.
|
18
|
-
|
19
|
-
## Usage
|
20
|
-
|
21
|
-
```ruby
|
22
|
-
conn = Faraday.new(:url => 'http://sushi.com') do |faraday|
|
23
|
-
faraday.request :url_encoded # form-encode POST params
|
24
|
-
faraday.response :logger # log requests to STDOUT
|
25
|
-
faraday.adapter Faraday.default_adapter # make requests with Net::HTTP
|
26
|
-
end
|
27
|
-
|
28
|
-
## GET ##
|
29
|
-
|
30
|
-
response = conn.get '/nigiri/sake.json' # GET http://sushi.com/nigiri/sake.json
|
31
|
-
response.body
|
32
|
-
|
33
|
-
conn.get '/nigiri', { :name => 'Maguro' } # GET http://sushi.com/nigiri?name=Maguro
|
34
|
-
|
35
|
-
conn.get do |req| # GET http://sushi.com/search?page=2&limit=100
|
36
|
-
req.url '/search', :page => 2
|
37
|
-
req.params['limit'] = 100
|
38
|
-
end
|
39
|
-
|
40
|
-
## POST ##
|
41
|
-
|
42
|
-
conn.post '/nigiri', { :name => 'Maguro' } # POST "name=maguro" to http://sushi.com/nigiri
|
43
|
-
|
44
|
-
# post payload as JSON instead of "www-form-urlencoded" encoding:
|
45
|
-
conn.post do |req|
|
46
|
-
req.url '/nigiri'
|
47
|
-
req.headers['Content-Type'] = 'application/json'
|
48
|
-
req.body = '{ "name": "Unagi" }'
|
49
|
-
end
|
50
|
-
|
51
|
-
## Per-request options ##
|
52
|
-
|
53
|
-
conn.get do |req|
|
54
|
-
req.url '/search'
|
55
|
-
req.options.timeout = 5 # open/read timeout in seconds
|
56
|
-
req.options.open_timeout = 2 # connection open timeout in seconds
|
57
|
-
end
|
58
|
-
```
|
59
|
-
|
60
|
-
If you don't need to set up anything, you can roll with just the default middleware
|
61
|
-
stack and default adapter (see [Faraday::RackBuilder#initialize](https://github.com/lostisland/faraday/blob/master/lib/faraday/rack_builder.rb)):
|
62
|
-
|
63
|
-
```ruby
|
64
|
-
response = Faraday.get 'http://sushi.com/nigiri/sake.json'
|
65
|
-
```
|
66
|
-
|
67
|
-
## Advanced middleware usage
|
68
|
-
|
69
|
-
The order in which middleware is stacked is important. Like with Rack, the
|
70
|
-
first middleware on the list wraps all others, while the last middleware is the
|
71
|
-
innermost one, so that must be the adapter.
|
72
|
-
|
73
|
-
```ruby
|
74
|
-
Faraday.new(...) do |conn|
|
75
|
-
# POST/PUT params encoders:
|
76
|
-
conn.request :multipart
|
77
|
-
conn.request :url_encoded
|
78
|
-
|
79
|
-
conn.adapter :net_http
|
80
|
-
end
|
81
|
-
```
|
3
|
+
[![Gem Version](https://badge.fury.io/rb/faraday.svg)](https://rubygems.org/gems/faraday)
|
4
|
+
![GitHub Actions CI](https://github.com/lostisland/faraday/workflows/CI/badge.svg)
|
5
|
+
[![Test Coverage](https://api.codeclimate.com/v1/badges/f869daab091ceef1da73/test_coverage)](https://codeclimate.com/github/lostisland/faraday/test_coverage)
|
6
|
+
[![Maintainability](https://api.codeclimate.com/v1/badges/f869daab091ceef1da73/maintainability)](https://codeclimate.com/github/lostisland/faraday/maintainability)
|
7
|
+
[![Gitter](https://badges.gitter.im/lostisland/faraday.svg)](https://gitter.im/lostisland/faraday?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge)
|
82
8
|
|
83
|
-
This request middleware setup affects POST/PUT requests in the following way:
|
84
9
|
|
85
|
-
|
86
|
-
|
87
|
-
|
88
|
-
already encoded or of another type
|
89
|
-
|
90
|
-
Swapping middleware means giving the other priority. Specifying the
|
91
|
-
"Content-Type" for the request is explicitly stating which middleware should
|
92
|
-
process it.
|
93
|
-
|
94
|
-
Examples:
|
95
|
-
|
96
|
-
```ruby
|
97
|
-
# uploading a file:
|
98
|
-
payload[:profile_pic] = Faraday::UploadIO.new('/path/to/avatar.jpg', 'image/jpeg')
|
99
|
-
|
100
|
-
# "Multipart" middleware detects files and encodes with "multipart/form-data":
|
101
|
-
conn.put '/profile', payload
|
102
|
-
```
|
103
|
-
|
104
|
-
## Writing middleware
|
105
|
-
|
106
|
-
Middleware are classes that implement a `call` instance method. They hook into
|
107
|
-
the request/response cycle.
|
108
|
-
|
109
|
-
```ruby
|
110
|
-
def call(request_env)
|
111
|
-
# do something with the request
|
112
|
-
# request_env[:request_headers].merge!(...)
|
113
|
-
|
114
|
-
@app.call(request_env).on_complete do |response_env|
|
115
|
-
# do something with the response
|
116
|
-
# response_env[:response_headers].merge!(...)
|
117
|
-
end
|
118
|
-
end
|
119
|
-
```
|
120
|
-
|
121
|
-
It's important to do all processing of the response only in the `on_complete`
|
122
|
-
block. This enables middleware to work in parallel mode where requests are
|
123
|
-
asynchronous.
|
124
|
-
|
125
|
-
The `env` is a hash with symbol keys that contains info about the request and,
|
126
|
-
later, response. Some keys are:
|
127
|
-
|
128
|
-
```
|
129
|
-
# request phase
|
130
|
-
:method - :get, :post, ...
|
131
|
-
:url - URI for the current request; also contains GET parameters
|
132
|
-
:body - POST parameters for :post/:put requests
|
133
|
-
:request_headers
|
134
|
-
|
135
|
-
# response phase
|
136
|
-
:status - HTTP response status code, such as 200
|
137
|
-
:body - the response body
|
138
|
-
:response_headers
|
139
|
-
```
|
140
|
-
|
141
|
-
## Using Faraday for testing
|
142
|
-
|
143
|
-
```ruby
|
144
|
-
# It's possible to define stubbed request outside a test adapter block.
|
145
|
-
stubs = Faraday::Adapter::Test::Stubs.new do |stub|
|
146
|
-
stub.get('/tamago') { |env| [200, {}, 'egg'] }
|
147
|
-
end
|
148
|
-
|
149
|
-
# You can pass stubbed request to the test adapter or define them in a block
|
150
|
-
# or a combination of the two.
|
151
|
-
test = Faraday.new do |builder|
|
152
|
-
builder.adapter :test, stubs do |stub|
|
153
|
-
stub.get('/ebi') { |env| [ 200, {}, 'shrimp' ]}
|
154
|
-
end
|
155
|
-
end
|
156
|
-
|
157
|
-
# It's also possible to stub additional requests after the connection has
|
158
|
-
# been initialized. This is useful for testing.
|
159
|
-
stubs.get('/uni') { |env| [ 200, {}, 'urchin' ]}
|
160
|
-
|
161
|
-
resp = test.get '/tamago'
|
162
|
-
resp.body # => 'egg'
|
163
|
-
resp = test.get '/ebi'
|
164
|
-
resp.body # => 'shrimp'
|
165
|
-
resp = test.get '/uni'
|
166
|
-
resp.body # => 'urchin'
|
167
|
-
resp = test.get '/else' #=> raises "no such stub" error
|
168
|
-
|
169
|
-
# If you like, you can treat your stubs as mocks by verifying that all of
|
170
|
-
# the stubbed calls were made. NOTE that this feature is still fairly
|
171
|
-
# experimental: It will not verify the order or count of any stub, only that
|
172
|
-
# it was called once during the course of the test.
|
173
|
-
stubs.verify_stubbed_calls
|
174
|
-
```
|
10
|
+
Faraday is an HTTP client library that provides a common interface over many
|
11
|
+
adapters (such as Net::HTTP) and embraces the concept of Rack middleware when
|
12
|
+
processing the request/response cycle.
|
175
13
|
|
176
|
-
##
|
14
|
+
## Getting Started
|
177
15
|
|
178
|
-
|
179
|
-
|
16
|
+
The best starting point is the [Faraday Website][website], with its introduction and explanation.
|
17
|
+
Need more details? See the [Faraday API Documentation][apidoc] to see how it works internally.
|
180
18
|
|
181
19
|
## Supported Ruby versions
|
182
20
|
|
183
|
-
This library aims to support and is [tested against][
|
21
|
+
This library aims to support and is [tested against][actions] the following Ruby
|
184
22
|
implementations:
|
185
23
|
|
186
|
-
*
|
187
|
-
* MRI 1.9.2
|
188
|
-
* MRI 1.9.3
|
189
|
-
* MRI 2.0.0
|
190
|
-
* MRI 2.1.0
|
191
|
-
* [JRuby][]
|
192
|
-
* [Rubinius][]
|
24
|
+
* Ruby 2.4+
|
193
25
|
|
194
26
|
If something doesn't work on one of these Ruby versions, it's a bug.
|
195
27
|
|
196
28
|
This library may inadvertently work (or seem to work) on other Ruby
|
197
|
-
implementations, however support will only be provided for the versions listed
|
29
|
+
implementations and versions, however support will only be provided for the versions listed
|
198
30
|
above.
|
199
31
|
|
200
32
|
If you would like this library to support another Ruby version, you may
|
@@ -204,17 +36,20 @@ implementation, you will be responsible for providing patches in a timely
|
|
204
36
|
fashion. If critical issues for a particular implementation exist at the time
|
205
37
|
of a major release, support for that Ruby version may be dropped.
|
206
38
|
|
207
|
-
##
|
39
|
+
## Contribute
|
208
40
|
|
209
|
-
|
210
|
-
|
41
|
+
Do you want to contribute to Faraday?
|
42
|
+
Open the issues page and check for the `help wanted` label!
|
43
|
+
But before you start coding, please read our [Contributing Guide][contributing]
|
211
44
|
|
212
|
-
|
213
|
-
[
|
214
|
-
|
215
|
-
[
|
216
|
-
[
|
217
|
-
[
|
218
|
-
[
|
219
|
-
[
|
220
|
-
[
|
45
|
+
## Copyright
|
46
|
+
© 2009 - 2019, the [Faraday Team][faraday_team]. Website and branding design by [Elena Lo Piccolo](https://elelopic.design).
|
47
|
+
|
48
|
+
[website]: https://lostisland.github.io/faraday
|
49
|
+
[faraday_team]: https://lostisland.github.io/faraday/team
|
50
|
+
[contributing]: https://github.com/lostisland/faraday/blob/master/.github/CONTRIBUTING.md
|
51
|
+
[apidoc]: http://www.rubydoc.info/gems/faraday
|
52
|
+
[actions]: https://github.com/lostisland/faraday/actions
|
53
|
+
[jruby]: http://jruby.org/
|
54
|
+
[rubinius]: http://rubini.us/
|
55
|
+
[license]: LICENSE.md
|
data/Rakefile
CHANGED
@@ -1,71 +1,7 @@
|
|
1
|
-
|
2
|
-
require 'fileutils'
|
3
|
-
require 'openssl'
|
4
|
-
require 'rake/testtask'
|
5
|
-
require 'bundler'
|
6
|
-
Bundler::GemHelper.install_tasks
|
1
|
+
# frozen_string_literal: true
|
7
2
|
|
8
|
-
|
3
|
+
require 'rspec/core/rake_task'
|
9
4
|
|
10
|
-
|
5
|
+
RSpec::Core::RakeTask.new(:spec)
|
11
6
|
|
12
|
-
|
13
|
-
@name ||= Dir['*.gemspec'].first.split('.').first
|
14
|
-
end
|
15
|
-
|
16
|
-
def version
|
17
|
-
line = File.read("lib/#{name}.rb")[/^\s*VERSION\s*=\s*.*/]
|
18
|
-
line.match(/.*VERSION\s*=\s*['"](.*)['"]/)[1]
|
19
|
-
end
|
20
|
-
|
21
|
-
def gemspec_file
|
22
|
-
"#{name}.gemspec"
|
23
|
-
end
|
24
|
-
|
25
|
-
def gem_file
|
26
|
-
"#{name}-#{version}.gem"
|
27
|
-
end
|
28
|
-
|
29
|
-
def replace_header(head, header_name)
|
30
|
-
head.sub!(/(\.#{header_name}\s*= ').*'/) { "#{$1}#{send(header_name)}'"}
|
31
|
-
end
|
32
|
-
|
33
|
-
# Adapted from WEBrick::Utils. Skips cert extensions so it
|
34
|
-
# can be used as a CA bundle
|
35
|
-
def create_self_signed_cert(bits, cn, comment)
|
36
|
-
rsa = OpenSSL::PKey::RSA.new(bits)
|
37
|
-
cert = OpenSSL::X509::Certificate.new
|
38
|
-
cert.version = 2
|
39
|
-
cert.serial = 1
|
40
|
-
name = OpenSSL::X509::Name.new(cn)
|
41
|
-
cert.subject = name
|
42
|
-
cert.issuer = name
|
43
|
-
cert.not_before = Time.now
|
44
|
-
cert.not_after = Time.now + (365*24*60*60)
|
45
|
-
cert.public_key = rsa.public_key
|
46
|
-
cert.sign(rsa, OpenSSL::Digest::SHA1.new)
|
47
|
-
return [cert, rsa]
|
48
|
-
end
|
49
|
-
|
50
|
-
## standard tasks
|
51
|
-
|
52
|
-
desc "Run all tests"
|
53
|
-
task :test do
|
54
|
-
exec 'script/test'
|
55
|
-
end
|
56
|
-
|
57
|
-
desc "Generate certificates for SSL tests"
|
58
|
-
task :'test:generate_certs' do
|
59
|
-
cert, key = create_self_signed_cert(1024, [['CN', 'localhost']], 'Faraday Test CA')
|
60
|
-
FileUtils.mkdir_p 'tmp'
|
61
|
-
File.open('tmp/faraday-cert.key', 'w') {|f| f.puts(key) }
|
62
|
-
File.open('tmp/faraday-cert.crt', 'w') {|f| f.puts(cert.to_s) }
|
63
|
-
end
|
64
|
-
|
65
|
-
file 'tmp/faraday-cert.key' => :'test:generate_certs'
|
66
|
-
file 'tmp/faraday-cert.crt' => :'test:generate_certs'
|
67
|
-
|
68
|
-
desc "Open an irb session preloaded with this library"
|
69
|
-
task :console do
|
70
|
-
sh "irb -rubygems -r ./lib/#{name}.rb"
|
71
|
-
end
|
7
|
+
task default: :spec
|
data/UPGRADING.md
ADDED
@@ -0,0 +1,55 @@
|
|
1
|
+
## Faraday 1.0
|
2
|
+
|
3
|
+
### Errors
|
4
|
+
* Removes sub-class constants definition from `Faraday::Error`. A sub-class (e.g. `ClientError`) was previously accessible
|
5
|
+
either through the `Faraday` module (e.g. `Faraday::ClientError`) or through the `Faraday::Error` class (e.g. `Faraday::Error::ClientError`).
|
6
|
+
The latter is no longer available and the former should be used instead, so check your `rescue`s.
|
7
|
+
* Introduces a new `Faraday::ServerError` (5xx status codes) alongside the existing `Faraday::ClientError` (4xx status codes).
|
8
|
+
Please note `Faraday::ClientError` was previously used for both.
|
9
|
+
* Introduces new Errors that describe the most common REST status codes:
|
10
|
+
* Faraday::BadRequestError (400)
|
11
|
+
* Faraday::UnauthorizedError (401)
|
12
|
+
* Faraday::ForbiddenError (403)
|
13
|
+
* Faraday::ProxyAuthError (407). Please note this raised a `Faraday::ConnectionFailed` before.
|
14
|
+
* Faraday::ConflictError (409)
|
15
|
+
* Faraday::UnprocessableEntityError (422)
|
16
|
+
* The following error classes have changed the hierarchy to better mirror their real-world usage and semantic meaning:
|
17
|
+
* TimeoutError < ServerError (was < ClientError)
|
18
|
+
* ConnectionFailed < Error (was < ClientError)
|
19
|
+
* SSLError < Error (was < ClientError)
|
20
|
+
* ParsingError < Error (was < ClientError)
|
21
|
+
* RetriableResponse < Error (was < ClientError)
|
22
|
+
|
23
|
+
### Custom adapters
|
24
|
+
If you have written a custom adapter, please be aware that `env.body` is now an alias to the two new properties `request_body` and `response_body`.
|
25
|
+
This should work without you noticing if your adapter inherits from `Faraday::Adapter` and calls `save_response`, but if it doesn't, then please ensure you set the `status` BEFORE the `body` while processing the response.
|
26
|
+
|
27
|
+
### Others
|
28
|
+
* Dropped support for jruby and Rubinius.
|
29
|
+
* Officially supports Ruby 2.4+
|
30
|
+
* In order to specify the adapter you now MUST use the `#adapter` method on the connection builder. If you don't do so and your adapter inherits from `Faraday::Adapter` then Faraday will raise an exception. Otherwise, Faraday will automatically push the default adapter at the end of the stack causing your request to be executed twice.
|
31
|
+
```ruby
|
32
|
+
class OfficialAdapter < Faraday::Adapter
|
33
|
+
...
|
34
|
+
end
|
35
|
+
|
36
|
+
class MyAdapter
|
37
|
+
...
|
38
|
+
end
|
39
|
+
|
40
|
+
# This will raise an exception
|
41
|
+
conn = Faraday.new(...) do |f|
|
42
|
+
f.use OfficialAdapter
|
43
|
+
end
|
44
|
+
|
45
|
+
# This will cause Faraday inserting the default adapter at the end of the stack
|
46
|
+
conn = Faraday.new(...) do |f|
|
47
|
+
f.use MyAdapter
|
48
|
+
end
|
49
|
+
|
50
|
+
# You MUST use `adapter` method
|
51
|
+
conn = Faraday.new(...) do |f|
|
52
|
+
f.adapter AnyAdapter
|
53
|
+
end
|
54
|
+
```
|
55
|
+
|