Module: HTTPX::Plugins::Persistent

Defined in:
lib/httpx/plugins/persistent.rb

Overview

This plugin implements a session that persists connections over the duration of the process.

This will improve connection reuse in a long-running process.

One important caveat to note is, although this session might not close connections, other sessions from the same process that don’t have this plugin turned on might.

This session will still be able to work with it, as if, when expecting a connection terminated by a different session, it will just retry on a new one and keep it open.

This plugin is also not recommendable when connecting to >9000 (like, a lot) different origins. So when you use this, make sure that you don’t fall into this trap.

gitlab.com/os85/httpx/wikis/Persistent

Defined Under Namespace

Modules: InstanceMethods

Class Method Summary collapse

Class Method Details

.extra_options(options) ⇒ Object 



34
35
36
 
# File 'lib/httpx/plugins/persistent.rb', line 34

def self.extra_options(options)
  options.merge(persistent: true)
end

.load_dependencies(klass) ⇒ Object 



22
23
24
25
26
27
28
29
30
31
 
# File 'lib/httpx/plugins/persistent.rb', line 22

def load_dependencies(klass)
  klass.plugin(:fiber_concurrency)

  max_retries = if klass.default_options.respond_to?(:max_retries)
    [klass.default_options.max_retries, 1].max
  else
    1
  end
  klass.plugin(:retries, max_retries: max_retries)
end