excon 0.109.0 → 1.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 619c4a4efc7daf30961e09303c2618d592714ccacd16b8e2567592eb3517c68c
-  data.tar.gz: bddecc90a89dc8af8b3bde08d75ade78a164b246b8de0c03df15b344613bb888
+  metadata.gz: 5fea894ca265007d66dbec2fcd785d793fff59080175f64c268208d225e32a70
+  data.tar.gz: bdfe0c227062cc7560e5c8ca9ec4b5dabca2365443b50ab378312a38fc3c73d3
 SHA512:
-  metadata.gz: f5995d37357a44359685cf48946e30fcc4b2fb4f10ab8e6a818404554305bac72e6edf6b908baad25b7860d72141473c1b0d03f2d52ca24a90cc6585ec8dc7e1
-  data.tar.gz: e7dd12e91db7c4c09ef2727c8fd1e49460cd591d4288f1a6e9b7693b3682bf6b96ff638fc51a082395b535e4381c7af667df49c782b00cd17ee0304f97e318ff
+  metadata.gz: 3baf7973f3a75855cebac881fe5ff3bf28da851dc03900151454802cf2b57700dca2c08bf1f532fe43583ac27baa4e9b8fb0f66611bb3209e1a259e38e947a75
+  data.tar.gz: b087fedfedbfa0655eb2febab2705f2e699376ec6ec4974c42bd0d3dc55a068ccf7251b0b201f6e051c27b01334b2f1bea4d27cd6b1f5b7fea872b1401df40ae

data/README.md

@@ -4,8 +4,8 @@ Usable, fast, simple Ruby HTTP 1.1
 
 Excon was designed to be simple, fast and performant. It works great as a general HTTP(s) client and is particularly well suited to usage in API clients.
 
-[![Build Status](https://github.com/excon/excon/actions/workflows/ruby.yml/badge.svg)](https://github.com/excon/excon/actions/workflows/ruby.yml)
-[![Gem Version](https://badge.fury.io/rb/excon.svg)](https://badge.fury.io/rb/excon)
+[![Build Status](https://github.com/excon/excon/actions/workflows/ci.yml/badge.svg)](https://github.com/excon/excon/actions/workflows/ci.yml)
+[![Gem Version](https://badge.fury.io/rb/excon.svg)](https://rubygems.org/gems/excon)
 
 - [Getting Started](#getting-started)
 - [Options](#options)
@@ -190,6 +190,9 @@ connection.request(:timeout => 0.1) # timeout if the entire request takes longer
 #
 connection = Excon.new('http://geemus.com/', :tcp_nodelay => true)
 
+# opt-in to having Excon add a default port (http:80 and https:443)
+connection = Excon.new('http://geemus.com/', :include_default_port => true)
+
 # set longer connect_timeout (default is 60 seconds)
 connection = Excon.new('http://geemus.com/', :connect_timeout => 360)
 
@@ -210,6 +213,19 @@ dns_resolver = Resolv::DNS.new(nameserver: ['127.0.0.1'])
 dns_resolver.timeouts = 3
 resolver = Resolv.new([Resolv::Hosts.new, dns_resolver])
 connection = Excon.new('http://geemus.com', :resolv_resolver => resolver)
+
+# As an global alternative for Excon, you can configure a custom resolver
+# factory which produces new resolver instances, configured to your likings.
+# This even works with Ruby Ractors!
+class CustomResolverFactory
+  # @return [Resolv] the new resolver instance
+  def self.create_resolver
+    dns_resolver = Resolv::DNS.new(nameserver: ['127.0.0.1'])
+    dns_resolver.timeouts = 3
+    Resolv.new([Resolv::Hosts.new, dns_resolver])
+  end
+end
+Excon.defaults[:resolver_factory] = CustomResolverFactory
 ```
 
 ## Chunked Requests
@@ -308,10 +324,10 @@ s.close
 The Unix socket will work for one-off requests and multiuse connections. A Unix socket path must be provided separate from the resource path.
 
 ```ruby
-connection = Excon.new('unix:///', :socket => '/tmp/unicorn.sock')
+connection = Excon.new('unix:///', :socket => '/tmp/puma.sock')
 connection.request(:method => :get, :path => '/ping')
 
-Excon.get('unix:///ping', :socket => '/tmp/unicorn.sock')
+Excon.get('unix:///ping', :socket => '/tmp/puma.sock')
 ```
 
 NOTE: Proxies will be ignored when using a Unix socket, since a Unix socket has to be local.
@@ -509,6 +525,7 @@ Either of these should allow you to work around the socket error and continue wi
 
 ## Getting Help
 
+- We support and test-against non-EOL Ruby versions. If you need older version support, please reach out.
 - Ask specific questions on [Stack Overflow](http://stackoverflow.com/questions/tagged/excon).
 - Report bugs and discuss potential features in [Github issues](https://github.com/excon/excon/issues).