123456789_123456789_123456789_123456789_123456789_

Class: Bundler::Fetcher::Downloader

Relationships & Source Files
Inherits: Object
Defined in: lib/bundler/fetcher/downloader.rb

Constant Summary

  • HTTP_NON_RETRYABLE_ERRORS =
    # File 'lib/bundler/fetcher/downloader.rb', line 6 
    [
  SocketError,
  Errno::EADDRNOTAVAIL,
  Errno::ECONNREFUSED,
  Errno::EHOSTDOWN,
  Errno::EHOSTUNREACH,
  Errno::ENETDOWN,
  Errno::ENETUNREACH,
].freeze
  • HTTP_RETRYABLE_ERRORS =

    The vendored net-http raises Gem::Timeout::Error, but when Gem::Net is the real Net (hosts without a vendored net-http), timeouts are plain Timeout::Error subclasses instead.

    # File 'lib/bundler/fetcher/downloader.rb', line 19 
    [
  Gem::Timeout::Error,
  *(::Timeout::Error if defined?(::Timeout::Error)),
  EOFError,
  Errno::EINVAL,
  Errno::ECONNRESET,
  Errno::ETIMEDOUT,
  Errno::EAGAIN,
  Gem::Net::HTTPBadResponse,
  Gem::Net::HTTPHeaderSyntaxError,
  Gem::Net::ProtocolError,
  Zlib::BufError,
].freeze

Class Method Summary

Instance Attribute Summary

Instance Method Summary

Constructor Details

.new(connections, redirect_limit) ⇒ Downloader

[ GitHub ] 

  


# File 'lib/bundler/fetcher/downloader.rb', line 36



def initialize(connections, redirect_limit)
  @connections = connections
  @redirect_limit = redirect_limit
end


  







Instance Attribute Details



  

    #connections   (readonly)
  

  [ GitHub ]


  

  


# File 'lib/bundler/fetcher/downloader.rb', line 33



attr_reader :connections


  








  

    #redirect_limit   (readonly)
  

  [ GitHub ]


  

  


# File 'lib/bundler/fetcher/downloader.rb', line 34



attr_reader :redirect_limit


  







Instance Method Details



  

    #fetch(uri, headers = {}, counter = 0)  
  



  

    
  





  
Raises:





  [ GitHub ]


  

  


# File 'lib/bundler/fetcher/downloader.rb', line 41



def fetch(uri, headers = {}, counter = 0)
  raise HTTPError, "Too many redirects" if counter >= redirect_limit

  filtered_uri = URICredentialsFilter.credential_filtered_uri(uri)

  response = request(uri, headers)
  Bundler.ui.debug("HTTP #{response.code} #{response.message} #{filtered_uri}")

  case response
  when Gem::Net::HTTPSuccess, Gem::Net::HTTPNotModified
    response
  when Gem::Net::HTTPRedirection
    new_uri = Gem::URI.parse(response["location"])
    # Following a downgrade would put the credentials this request carries
    # on a plaintext connection, so refuse it like Gem::RemoteFetcher does.
    if https?(uri) && !https?(new_uri)
      raise HTTPError, "Redirecting to a non-https URI is not allowed: #{URICredentialsFilter.credential_filtered_uri(new_uri)}"
    end
    if new_uri.host == uri.host
      new_uri.user = uri.user
      new_uri.password = uri.password
    end
    fetch(new_uri, headers, counter + 1)
  when Gem::Net::HTTPRequestedRangeNotSatisfiable
    new_headers = headers.dup
    new_headers.delete("Range")
    fetch(uri, new_headers)
  when Gem::Net::HTTPRequestEntityTooLarge
    raise FallbackError, response.body
  when Gem::Net::HTTPTooManyRequests
    raise TooManyRequestsError, response.body
  when Gem::Net::HTTPUnauthorized
    raise BadAuthenticationError, uri.host if uri.userinfo
    raise AuthenticationRequiredError, uri.host
  when Gem::Net::HTTPForbidden
    raise AuthenticationForbiddenError, uri.host
  when Gem::Net::HTTPNotFound
    raise FallbackError, "Gem::Net::HTTPNotFound: #{filtered_uri}"
  else
    message = "Gem::#{response.class.name.gsub(/\AGem::/, "")}"
    message += ": #{response.body}" unless response.body.empty?
    raise HTTPError, message
  end
end


  








  

    #https?(uri)  ⇒ Boolean  (private)
  



  

    
  





  


  [ GitHub ]


  

  


# File 'lib/bundler/fetcher/downloader.rb', line 128



def https?(uri)
  uri.scheme&.casecmp("https")&.zero?
end


  








  

    #network_down_error(uri, filtered_uri)   (private)
  

  [ GitHub ]


  

  


# File 'lib/bundler/fetcher/downloader.rb', line 120



def network_down_error(uri, filtered_uri)
  host = uri.host
  host_port = "#{host}:#{uri.port}"
  host = host_port if filtered_uri.to_s.include?(host_port)
  NetworkDownError.new("Could not reach host #{host}. Check your network " \
    "connection and try again.")
end


  








  

    #request(uri, headers)  
  

  [ GitHub ]


  

  


# File 'lib/bundler/fetcher/downloader.rb', line 86



def request(uri, headers)
  validate_uri_scheme!(uri)

  filtered_uri = URICredentialsFilter.credential_filtered_uri(uri)

  Bundler.ui.debug "HTTP GET #{filtered_uri}"
  connections.request(uri, headers)
rescue Gem::RemoteFetcher::FetchError => e
  Bundler.ui.trace e

  case e.message
  when /certificate verify failed/
    raise CertificateFailureError.new(uri)
  when /host is down|host down/i
    raise network_down_error(uri, filtered_uri)
  else
    raise HTTPError, "Network error while fetching #{filtered_uri}" \
        " (#{e})"
  end
rescue OpenSSL::SSL::SSLError
  raise CertificateFailureError.new(uri)
rescue *HTTP_NON_RETRYABLE_ERRORS => e
  Bundler.ui.trace e

  raise network_down_error(uri, filtered_uri)
rescue *HTTP_RETRYABLE_ERRORS => e
  Bundler.ui.trace e

  raise HTTPError, "Network error while fetching #{filtered_uri}" \
      " (#{e})"
end


  








  

    #validate_uri_scheme!(uri)   (private)
  



  

    
  





  
Raises:





  [ GitHub ]


  

  


# File 'lib/bundler/fetcher/downloader.rb', line 132



def validate_uri_scheme!(uri)
  return if /\Ahttps?\z/.match?(uri.scheme)
  raise InvalidOption,
    "The request uri `#{uri}` has an invalid scheme (`#{uri.scheme}`). " \
    "Did you mean `http` or `https`?"
end