Class/Module Index [+]

Quicksearch

Excon

Define defaults first so they will be available to other files

Public Class Methods

defaults() click to toggle source

@return [Hash] defaults for Excon connections

# File lib/excon.rb, line 17
def defaults
  @defaults ||= {
    :chunk_size         => CHUNK_SIZE || DEFAULT_CHUNK_SIZE,
    :connect_timeout    => 60,
    :headers            => {},
    :idempotent         => false,
    :instrumentor_name  => 'excon',
    :middlewares        => [
      Excon::Middleware::Expects,
      Excon::Middleware::Idempotent,
      Excon::Middleware::Instrumentor,
      Excon::Middleware::Mock
    ],
    :mock               => false,
    :nonblock           => DEFAULT_NONBLOCK,
    :read_timeout       => 60,
    :retry_limit        => DEFAULT_RETRY_LIMIT,
    :ssl_ca_file        => DEFAULT_CA_FILE,
    :ssl_verify_peer    => RbConfig::CONFIG['host_os'] !~ /mswin|win32|dos|cygwin|mingw/,
    :uri_parser         => URI,
    :write_timeout      => 60
  }
end
defaults=(new_defaults) click to toggle source

Change defaults for Excon connections @return [Hash] defaults for Excon connections

# File lib/excon.rb, line 43
def defaults=(new_defaults)
  @defaults = new_defaults
end
mock() click to toggle source

Status of mocking

# File lib/excon.rb, line 67
def mock
  $stderr.puts("Excon#mock is deprecated, pass Excon.defaults[:mock] instead (#{caller.first})")
  self.defaults[:mock]
end
mock=(new_mock) click to toggle source

Change the status of mocking false is the default and works as expected true returns a value from stubs or raises

# File lib/excon.rb, line 75
def mock=(new_mock)
  $stderr.puts("Excon#mock is deprecated, pass Excon.defaults[:mock]= instead (#{caller.first})")
  self.defaults[:mock] = new_mock
end
new(url, params = {}) click to toggle source

@see Connection#initialize Initializes a new keep-alive session for a given remote host

@param [String] url The destination URL
@param [Hash<Symbol, >] params One or more option params to set on the Connection instance
@return [Connection] A new Excon::Connection instance
# File lib/excon.rb, line 111
def new(url, params = {})
  uri_parser = params[:uri_parser] || Excon.defaults[:uri_parser]
  uri = uri_parser.parse(url)
  params = {
    :host       => uri.host,
    :path       => uri.path,
    :port       => uri.port.to_s,
    :query      => uri.query,
    :scheme     => uri.scheme,
    :user       => (URI.decode(uri.user) if uri.user),
    :password   => (URI.decode(uri.password) if uri.password),
  }.merge!(params)
  Excon::Connection.new(params)
end
ssl_ca_path() click to toggle source

@return [String] The filesystem path to the SSL Certificate Authority

# File lib/excon.rb, line 81
def ssl_ca_path
  $stderr.puts("Excon#ssl_ca_path is deprecated, use Excon.defaults[:ssl_ca_path] instead (#{caller.first})")
  self.defaults[:ssl_ca_path]
end
ssl_ca_path=(new_ssl_ca_path) click to toggle source

Change path to the SSL Certificate Authority @return [String] The filesystem path to the SSL Certificate Authority

# File lib/excon.rb, line 88
def ssl_ca_path=(new_ssl_ca_path)
  $stderr.puts("Excon#ssl_ca_path= is deprecated, use Excon.defaults[:ssl_ca_path]= instead (#{caller.first})")
  self.defaults[:ssl_ca_path] = new_ssl_ca_path
end
ssl_verify_peer() click to toggle source

@return [true, false] Whether or not to verify the peer's SSL certificate / chain

# File lib/excon.rb, line 94
def ssl_verify_peer
  $stderr.puts("Excon#ssl_verify_peer= is deprecated, use Excon.defaults[:ssl_verify_peer]= instead (#{caller.first})")
  self.defaults[:ssl_verify_peer]
end
ssl_verify_peer=(new_ssl_verify_peer) click to toggle source

Change the status of ssl peer verification @see Excon#ssl_verify_peer (attr_reader)

# File lib/excon.rb, line 101
def ssl_verify_peer=(new_ssl_verify_peer)
  $stderr.puts("Excon#ssl_verify_peer is deprecated, use Excon.defaults[:ssl_verify_peer] instead (#{caller.first})")
  self.defaults[:ssl_verify_peer] = new_ssl_verify_peer
end
stub(request_params = {}, response_params = nil) click to toggle source

push an additional stub onto the list to check for mock requests

@param [Hash<Symbol, >] request params to match against, omitted params match all
@param [Hash<Symbol, >] response params to return from matched request or block to call with params
# File lib/excon.rb, line 129
def stub(request_params = {}, response_params = nil)
  if url = request_params.delete(:url)
    uri = URI.parse(url)
    request_params.update(
      :host              => uri.host,
      :path              => uri.path,
      :port              => uri.port.to_s,
      :query             => uri.query,
      :scheme            => uri.scheme
    )
    if uri.user || uri.password
      request_params[:headers] ||= {}
      request_params[:headers]['Authorization'] ||= 'Basic ' << ['' << uri.user.to_s << ':' << uri.password.to_s].pack('m').delete(Excon::CR_NL)
    end
  end
  if block_given?
    if response_params
      raise(ArgumentError.new("stub requires either response_params OR a block"))
    else
      stub = [request_params, Proc.new]
    end
  elsif response_params
    stub = [request_params, response_params]
  else
    raise(ArgumentError.new("stub requires either response_params OR a block"))
  end
  stubs.unshift(stub)
  stub
end
stubs() click to toggle source

get a list of defined stubs

# File lib/excon.rb, line 160
def stubs
  @stubs ||= []
end

[Validate]

Generated with the Darkfish Rdoc Generator 2.