excon 0.92.4 → 0.93.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 27d135a08d31acae6470830e52c2106edb009aa323e722b8b4f33f1e363ba751
-  data.tar.gz: 39b76ea9456a60d7bde87139cca00d58da653cc4f518ae3ca65863e9fe8fdda3
+  metadata.gz: 3a01332c97d386ee2fa377ba1fd77181638bc1c2d0b66bf12c438a000dfa1cf9
+  data.tar.gz: 58a820d5454126fca8e207a2ad73da5191530e79288bac722ce404b65d6b6b89
 SHA512:
-  metadata.gz: 63cdd6010814edb1a94e7bc1c694e7dedb2cca7c51dee26fe89a7bd71fad1f2a803763d49ae0f6e8103c7114acc423e92d0c610620b97ae817a936b0990af484
-  data.tar.gz: f759aa0467043e50c8af544c881fadab669505a7a62b58cc2a68dd7bf1be9a3e6db3656092e66618dd8161310d39deee1d841adf6ed0b8d02719574211d3d983
+  metadata.gz: e37baf618e3fee07197ee59773c045aa9319532ed7e604eb9ad0df58fe44385358411e56b724bded235b0a57cf95ea6190445b27144359128abbf3e577363b87
+  data.tar.gz: e0376d6b306d053a8eba47fb9f188fdb96fcbbd7c11b9a9eba4deb9f7c1b55432bdb5a63b8880316ed99e078b382a36d00c1a5b3eb12be76e708c91d76689d10

data/README.md

@@ -127,6 +127,38 @@ connection.request(:method => 'GET')
 # expect one or more status codes, or raise an error
 connection.request(:expects => [200, 201], :method => :get)
 
+# use basic authentication by supplying credentials in the URL or as parameters
+connection = Excon.new('http://username:password@secure.geemus.com')
+# Note: username & password is unescaped for request, so you should provide escaped values here
+# i. e. instead of `password: 'pa%%word'` you should use `password: Excon::Utils.escape_uri('pa%%word')`,
+# which return `pa%25%25word`
+connection = Excon.new('http://secure.geemus.com',
+  :user => 'username', :password => 'password')
+
+# use custom uri parser
+require 'addressable/uri'
+connection = Excon.new('http://geemus.com/', uri_parser: Addressable::URI)
+```
+
+Compared to web browsers and other http client libraries, e.g. curl, Excon is a bit more low-level and doesn't assume much by default. If you are seeing different results compared to other clients, the following options might help:
+
+```ruby
+# opt-in to omitting port from http:80 and https:443
+connection = Excon.new('http://geemus.com/', :omit_default_port => true)
+
+# accept gzip encoding
+connection = Excon.new('http://geemus.com/', :headers => { "Accept-Encoding" => "gzip" })
+
+# turn off peer verification (less secure)
+Excon.defaults[:ssl_verify_peer] = false
+connection = Excon.new('https://...')
+```
+
+## Timeouts and Retries
+
+You can modify timeouts and define whether and how many (blocking) retries Excon should attempt if errors occur.
+
+```ruby
 # this request can be repeated safely, so retry on errors up to 4 times
 connection.request(:idempotent => true)
 
@@ -137,6 +169,10 @@ connection.request(:idempotent => true, :retry_limit => 6)
 # in between each retry
 connection.request(:idempotent => true, :retry_limit => 6, :retry_interval => 5)
 
+# specify the errors on which to retry (default Timeout, Socket, HTTPStatus)
+# only retry on timeouts
+connection.request(:idempotent => true, :retry_limit => 6, :retry_interval => 5, :retry_errors => [Excon::Error::Timeout] )
+
 # set longer read_timeout (default is 60 seconds)
 connection.request(:read_timeout => 360)
 
@@ -155,32 +191,6 @@ connection = Excon.new('http://geemus.com/', :connect_timeout => 360)
 
 # opt-out of nonblocking operations for performance and/or as a workaround
 connection = Excon.new('http://geemus.com/', :nonblock => false)
-
-# use basic authentication by supplying credentials in the URL or as parameters
-connection = Excon.new('http://username:password@secure.geemus.com')
-# Note: username & password is unescaped for request, so you should provide escaped values here
-# i. e. instead of `password: 'pa%%word'` you should use `password: Excon::Utils.escape_uri('pa%%word')`,
-# which return `pa%25%25word`
-connection = Excon.new('http://secure.geemus.com',
-  :user => 'username', :password => 'password')
-
-# use custom uri parser
-require 'addressable/uri'
-connection = Excon.new('http://geemus.com/', uri_parser: Addressable::URI)
-```
-
-Compared to web browsers and other http client libraries, e.g. curl, Excon is a bit more low-level and doesn't assume much by default. If you are seeing different results compared to other clients, the following options might help:
-
-```ruby
-# opt-in to omitting port from http:80 and https:443
-connection = Excon.new('http://geemus.com/', :omit_default_port => true)
-
-# accept gzip encoding
-connection = Excon.new('http://geemus.com/', :headers => { "Accept-Encoding" => "gzip" })
-
-# turn off peer verification (less secure)
-Excon.defaults[:ssl_verify_peer] = false
-connection = Excon.new('https://...')
 ```
 
 ## Chunked Requests

data/lib/excon/ssl_socket.rb

@@ -133,7 +133,7 @@ module Excon
 
       # Server Name Indication (SNI) RFC 3546
       if @socket.respond_to?(:hostname=)
-        @socket.hostname = @data[:host]
+        @socket.hostname = @data[:ssl_verify_peer_host] || @data[:host]
       end
 
       begin

data/lib/excon/version.rb

@@ -1,4 +1,4 @@
 # frozen_string_literal: true
 module Excon
-  VERSION = '0.92.4'
+  VERSION = '0.93.0'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: excon
 version: !ruby/object:Gem::Version
-  version: 0.92.4
+  version: 0.93.0
 platform: ruby
 authors:
 - dpiddy (Dan Peterson)
@@ -10,7 +10,7 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-07-20 00:00:00.000000000 Z
+date: 2022-09-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec