269 lines
7.8 KiB
Ruby
269 lines
7.8 KiB
Ruby
require 'thread'
|
|
require 'cgi'
|
|
require 'set'
|
|
require 'forwardable'
|
|
|
|
# Public: This is the main namespace for Faraday. You can either use it to
|
|
# create Faraday::Connection objects, or access it directly.
|
|
#
|
|
# Examples
|
|
#
|
|
# Faraday.get "http://faraday.com"
|
|
#
|
|
# conn = Faraday.new "http://faraday.com"
|
|
# conn.get '/'
|
|
#
|
|
module Faraday
|
|
VERSION = "0.9.0"
|
|
|
|
class << self
|
|
# Public: Gets or sets the root path that Faraday is being loaded from.
|
|
# This is the root from where the libraries are auto-loaded from.
|
|
attr_accessor :root_path
|
|
|
|
# Public: Gets or sets the path that the Faraday libs are loaded from.
|
|
attr_accessor :lib_path
|
|
|
|
# Public: Gets or sets the Symbol key identifying a default Adapter to use
|
|
# for the default Faraday::Connection.
|
|
attr_reader :default_adapter
|
|
|
|
# Public: Sets the default Faraday::Connection for simple scripts that
|
|
# access the Faraday constant directly.
|
|
#
|
|
# Faraday.get "https://faraday.com"
|
|
attr_writer :default_connection
|
|
|
|
# Public: Sets the default options used when calling Faraday#new.
|
|
attr_writer :default_connection_options
|
|
|
|
# Public: Initializes a new Faraday::Connection.
|
|
#
|
|
# url - The optional String base URL to use as a prefix for all
|
|
# requests. Can also be the options Hash.
|
|
# options - The optional Hash used to configure this Faraday::Connection.
|
|
# Any of these values will be set on every request made, unless
|
|
# overridden for a specific request.
|
|
# :url - String base URL.
|
|
# :params - Hash of URI query unencoded key/value pairs.
|
|
# :headers - Hash of unencoded HTTP header key/value pairs.
|
|
# :request - Hash of request options.
|
|
# :ssl - Hash of SSL options.
|
|
# :proxy - Hash of Proxy options.
|
|
#
|
|
# Examples
|
|
#
|
|
# Faraday.new 'http://faraday.com'
|
|
#
|
|
# # http://faraday.com?page=1
|
|
# Faraday.new 'http://faraday.com', :params => {:page => 1}
|
|
#
|
|
# # same
|
|
#
|
|
# Faraday.new :url => 'http://faraday.com',
|
|
# :params => {:page => 1}
|
|
#
|
|
# Returns a Faraday::Connection.
|
|
def new(url = nil, options = nil)
|
|
block = block_given? ? Proc.new : nil
|
|
options = options ? default_connection_options.merge(options) : default_connection_options.dup
|
|
Faraday::Connection.new(url, options, &block)
|
|
end
|
|
|
|
# Internal: Requires internal Faraday libraries.
|
|
#
|
|
# *libs - One or more relative String names to Faraday classes.
|
|
#
|
|
# Returns nothing.
|
|
def require_libs(*libs)
|
|
libs.each do |lib|
|
|
require "#{lib_path}/#{lib}"
|
|
end
|
|
end
|
|
|
|
# Public: Updates default adapter while resetting
|
|
# #default_connection.
|
|
#
|
|
# Returns the new default_adapter.
|
|
def default_adapter=(adapter)
|
|
@default_connection = nil
|
|
@default_adapter = adapter
|
|
end
|
|
|
|
alias require_lib require_libs
|
|
|
|
private
|
|
# Internal: Proxies method calls on the Faraday constant to
|
|
# #default_connection.
|
|
def method_missing(name, *args, &block)
|
|
default_connection.send(name, *args, &block)
|
|
end
|
|
end
|
|
|
|
self.root_path = File.expand_path "..", __FILE__
|
|
self.lib_path = File.expand_path "../faraday", __FILE__
|
|
self.default_adapter = :net_http
|
|
|
|
# Gets the default connection used for simple scripts.
|
|
#
|
|
# Returns a Faraday::Connection, configured with the #default_adapter.
|
|
def self.default_connection
|
|
@default_connection ||= Connection.new
|
|
end
|
|
|
|
# Gets the default connection options used when calling Faraday#new.
|
|
#
|
|
# Returns a Faraday::ConnectionOptions.
|
|
def self.default_connection_options
|
|
@default_connection_options ||= ConnectionOptions.new
|
|
end
|
|
|
|
if (!defined?(RUBY_ENGINE) || "ruby" == RUBY_ENGINE) && RUBY_VERSION < '1.9'
|
|
begin
|
|
require 'system_timer'
|
|
Timer = SystemTimer
|
|
rescue LoadError
|
|
warn "Faraday: you may want to install system_timer for reliable timeouts"
|
|
end
|
|
end
|
|
|
|
unless const_defined? :Timer
|
|
require 'timeout'
|
|
Timer = Timeout
|
|
end
|
|
|
|
# Public: Adds the ability for other modules to register and lookup
|
|
# middleware classes.
|
|
module MiddlewareRegistry
|
|
# Public: Register middleware class(es) on the current module.
|
|
#
|
|
# mapping - A Hash mapping Symbol keys to classes. Classes can be expressed
|
|
# as fully qualified constant, or a Proc that will be lazily
|
|
# called to return the former.
|
|
#
|
|
# Examples
|
|
#
|
|
# module Faraday
|
|
# class Whatever
|
|
# # Middleware looked up by :foo returns Faraday::Whatever::Foo.
|
|
# register_middleware :foo => Foo
|
|
#
|
|
# # Middleware looked up by :bar returns Faraday::Whatever.const_get(:Bar)
|
|
# register_middleware :bar => :Bar
|
|
#
|
|
# # Middleware looked up by :baz requires 'baz' and returns Faraday::Whatever.const_get(:Baz)
|
|
# register_middleware :baz => [:Baz, 'baz']
|
|
# end
|
|
# end
|
|
#
|
|
# Returns nothing.
|
|
def register_middleware(autoload_path = nil, mapping = nil)
|
|
if mapping.nil?
|
|
mapping = autoload_path
|
|
autoload_path = nil
|
|
end
|
|
middleware_mutex do
|
|
@middleware_autoload_path = autoload_path if autoload_path
|
|
(@registered_middleware ||= {}).update(mapping)
|
|
end
|
|
end
|
|
|
|
# Public: Lookup middleware class with a registered Symbol shortcut.
|
|
#
|
|
# key - The Symbol key for the registered middleware.
|
|
#
|
|
# Examples
|
|
#
|
|
# module Faraday
|
|
# class Whatever
|
|
# register_middleware :foo => Foo
|
|
# end
|
|
# end
|
|
#
|
|
# Faraday::Whatever.lookup_middleware(:foo)
|
|
# # => Faraday::Whatever::Foo
|
|
#
|
|
# Returns a middleware Class.
|
|
def lookup_middleware(key)
|
|
load_middleware(key) ||
|
|
raise(Faraday::Error.new("#{key.inspect} is not registered on #{self}"))
|
|
end
|
|
|
|
def middleware_mutex(&block)
|
|
@middleware_mutex ||= begin
|
|
require 'monitor'
|
|
Monitor.new
|
|
end
|
|
@middleware_mutex.synchronize(&block)
|
|
end
|
|
|
|
def fetch_middleware(key)
|
|
defined?(@registered_middleware) && @registered_middleware[key]
|
|
end
|
|
|
|
def load_middleware(key)
|
|
value = fetch_middleware(key)
|
|
case value
|
|
when Module
|
|
value
|
|
when Symbol, String
|
|
middleware_mutex do
|
|
@registered_middleware[key] = const_get(value)
|
|
end
|
|
when Proc
|
|
middleware_mutex do
|
|
@registered_middleware[key] = value.call
|
|
end
|
|
when Array
|
|
middleware_mutex do
|
|
const, path = value
|
|
if root = @middleware_autoload_path
|
|
path = "#{root}/#{path}"
|
|
end
|
|
require(path)
|
|
@registered_middleware[key] = const
|
|
end
|
|
load_middleware(key)
|
|
end
|
|
end
|
|
end
|
|
|
|
def self.const_missing(name)
|
|
if name.to_sym == :Builder
|
|
warn "Faraday::Builder is now Faraday::RackBuilder."
|
|
const_set name, RackBuilder
|
|
else
|
|
super
|
|
end
|
|
end
|
|
|
|
require_libs "utils", "options", "connection", "rack_builder", "parameters",
|
|
"middleware", "adapter", "request", "response", "upload_io", "error"
|
|
|
|
if !ENV["FARADAY_NO_AUTOLOAD"]
|
|
require_lib 'autoload'
|
|
end
|
|
end
|
|
|
|
# not pulling in active-support JUST for this method. And I love this method.
|
|
class Object
|
|
# The primary purpose of this method is to "tap into" a method chain,
|
|
# in order to perform operations on intermediate results within the chain.
|
|
#
|
|
# Examples
|
|
#
|
|
# (1..10).tap { |x| puts "original: #{x.inspect}" }.to_a.
|
|
# tap { |x| puts "array: #{x.inspect}" }.
|
|
# select { |x| x%2 == 0 }.
|
|
# tap { |x| puts "evens: #{x.inspect}" }.
|
|
# map { |x| x*x }.
|
|
# tap { |x| puts "squares: #{x.inspect}" }
|
|
#
|
|
# Yields self.
|
|
# Returns self.
|
|
def tap
|
|
yield(self)
|
|
self
|
|
end unless Object.respond_to?(:tap)
|
|
end
|