Class: Async::HTTP::Internet

Inherits:
Object
  • Object
show all
Defined in:
lib/async/http/internet.rb,
lib/async/http/internet/instance.rb

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(**options) ⇒ Internet

Returns a new instance of Internet.



17
18
19
20
 
# File 'lib/async/http/internet.rb', line 17

def initialize(**options)
  @clients = Hash.new
  @options = options
end

Instance Attribute Details

#clients ⇒ Object

A cache of clients.



24
25
26
 
# File 'lib/async/http/internet.rb', line 24

def clients
  @clients
end

Class Method Details

.instance ⇒ Object

The global instance of the internet.



14
15
16
 
# File 'lib/async/http/internet/instance.rb', line 14

def self.instance
  ::Thread.current.async_http_internet_instance ||= self.new
end

Instance Method Details

#call(verb, url, *arguments, **options, &block) ⇒ Object

Make a request to the internet with the given ‘method` and `url`.

If you provide non-frozen headers, they may be mutated.



42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
 
# File 'lib/async/http/internet.rb', line 42

def call(verb, url, *arguments, **options, &block)
  endpoint = Endpoint[url]
  client = self.client_for(endpoint)
  
  options[:authority] ||= endpoint.authority
  options[:scheme] ||= endpoint.scheme
  
  request = ::Protocol::HTTP::Request[verb, endpoint.path, *arguments, **options]
  
  response = client.call(request)
  
  return response unless block_given?
  
  begin
    yield response
  ensure
    response.close
  end
end

#client_for(endpoint) ⇒ Object 



26
27
28
29
30
31
32
 
# File 'lib/async/http/internet.rb', line 26

def client_for(endpoint)
  key = host_key(endpoint)
  
  @clients.fetch(key) do
    @clients[key] = self.make_client(endpoint)
  end
end

#close ⇒ Object 



62
63
64
65
66
67
68
 
# File 'lib/async/http/internet.rb', line 62

def close
  # The order of operations here is to avoid a race condition between iterating over clients (#close may yield) and creating new clients.
  clients = @clients.values
  @clients.clear
  
  clients.each(&:close)
end