module HTTPX::Plugins::Retries

  1. lib/httpx/plugins/retries.rb

This plugin adds support for retrying requests when errors happen.

It has a default max number of retries (see MAX_RETRIES and the max_retries option), after which it will return the last response, error or not. It will not raise an exception.

It does not retry which are not considered idempotent (see retry_change_requests to override).

gitlab.com/os85/httpx/wikis/Retries

Methods

Public Class

  1. extra_options

Constants

DEFAULT_JITTER = ->(interval) { interval * ((rand + 1) * 0.5) }  
IDEMPOTENT_METHODS = %w[GET OPTIONS HEAD PUT DELETE].freeze  

TODO: pass max_retries in a configure/load block
MAX_RETRIES = 3  
RECONNECTABLE_ERRORS = [ IOError, EOFError, Errno::ECONNRESET, Errno::ECONNABORTED, Errno::EPIPE, Errno::EINVAL, Errno::ETIMEDOUT, ConnectionError, TLSError, Connection::HTTP2::Error, ].freeze  

subset of retryable errors which are safe to retry when reconnecting
RETRYABLE_ERRORS = (RECONNECTABLE_ERRORS + [ Parser::Error, TimeoutError, ]).freeze  

Public Class methods

extra_options(options)
[show source] 
   # File lib/httpx/plugins/retries.rb
42 def self.extra_options(options)
43   options.merge(max_retries: MAX_RETRIES)
44 end