-
Notifications
You must be signed in to change notification settings - Fork 615
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
9 changed files
with
58 additions
and
17 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,48 @@ | ||
# Upgrading from v2.x to v3.x | ||
|
||
Savon 3 is a major release that replaces its HTTP transport client, [HTTPI](https://github.com/savonrb/httpi) with [Faraday](https://lostisland.github.io/faraday), introducing major breaking changes. | ||
|
||
While this brings significant new features and improvements, it also removes or changes some existing features and options. | ||
|
||
## Removed Options | ||
|
||
### ssl_cert_key_file, ssl_cert_key_password, ssl_cert_file, ssl_ca_cert | ||
|
||
These options are no longer supported, as Faraday does not directly support them, and attempting to use them will raise an error. | ||
|
||
Resolution: | ||
|
||
For `ssl_cert_key_file` and `ssl_cert_key_password` open and decrypt the client key using OpenSSL, and provide the result as the `ssl_cert_key` option instead. | ||
|
||
For `ssl_cert_file` pass the `OpenSSL::X509::Certificate` as the `ssl_cert` option instead. | ||
|
||
For `ssl_ca_cert` pass the file as the `ssl_ca_cert_file` option instead. | ||
|
||
For more information please see https://lostisland.github.io/faraday/#/customization/ssl-options | ||
|
||
### ssl_ciphers | ||
|
||
Specifying SSL ciphers is no longer supported, as Faraday does not support this, and attempting to use this option will raise an error. | ||
|
||
Resolution: remove code that attempts to set `ssl_ciphers`. | ||
|
||
### digest_auth | ||
|
||
Digest authentication is no longer natively supported. If you need to use it, consider [Faraday::DigestAuth](https://github.com/bhaberer/faraday-digestauth) | ||
|
||
## Changed options | ||
|
||
### cookies | ||
|
||
The `cookies` option now distinguishes between empty and nil string values. If you want to send an empty cookie, you must now set it to an empty string, rather than nil. Nil is reserved for cookie flags like `HttpOnly` or `Secure`. For example: | ||
|
||
```ruby | ||
cookies({accept: 'application/json', 'some-cookie': 'foo', "empty-cookie": "", HttpOnly: nil}) | ||
``` | ||
|
||
will send the following cookies: | ||
|
||
``` | ||
"accept=application/json; some-cookie=foo; empty-cookie=; HttpOnly" | ||
``` | ||
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters