shin-faraday 0.4.7

data/.document

@@ -0,0 +1,5 @@
+README.rdoc
+lib/**/*.rb
+bin/*
+features/**/*.feature
+LICENSE

data/.gitignore

@@ -0,0 +1,21 @@
+## MAC OS
+.DS_Store
+
+## TEXTMATE
+*.tmproj
+tmtags
+
+## EMACS
+*~
+\#*
+.\#*
+
+## VIM
+*.swp
+
+## PROJECT::GENERAL
+coverage
+rdoc
+pkg
+
+## PROJECT::SPECIFIC

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009-* rick olson, zack hobson
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.rdoc

@@ -0,0 +1,84 @@
+= faraday
+
+Modular HTTP client library using middleware heavily inspired by Rack.
+
+This mess is gonna get raw, like sushi. So, haters to the left.
+
+== Usage
+
+  conn = Faraday::Connection.new(:url => 'http://sushi.com') do |builder|
+    builder.use Faraday::Request::Yajl     # convert body to json with Yajl lib
+    builder.use Faraday::Adapter::Logger   # log the request somewhere?
+    builder.use Faraday::Adapter::Typhoeus # make http request with typhoeus
+    builder.use Faraday::Response::Yajl    # # parse body with yajl
+
+    # or use shortcuts
+    builder.request  :yajl     # Faraday::Request::Yajl
+    builder.adapter  :logger   # Faraday::Adapter::Logger
+    builder.adapter  :typhoeus # Faraday::Adapter::Typhoeus
+    builder.response :yajl     # Faraday::Response::Yajl
+  end
+
+  resp1 = conn.get '/nigiri/sake.json'
+  resp2 = conn.post do |req|
+    req.url  "/nigiri.json", :page => 2
+    req[:content_type] = 'application/json'
+    req.body = {:name => 'Unagi'}
+  end
+
+  # If you're ready to roll with just the bare minimum (net/http):
+  resp1 = Faraday.get 'http://sushi.com/nigiri/sake.json'
+
+== Testing
+
+  # It's possible to define stubbed request outside a test adapter block.
+  stubs = Faraday::Test::Stubs.new do |stub|
+    stub.get('/tamago') { [200, {}, 'egg'] }
+  end
+
+  # You can pass stubbed request to the test adapter or define them in a block
+  # or a combination of the two.
+  test = Faraday::Connection.new do |builder|
+    builder.adapter :test, stubs do |stub|
+      stub.get('/ebi') {[ 200, {}, 'shrimp' ]}
+    end
+  end
+
+  # It's also possible to stub additional requests after the connection has
+  # been initialized. This is useful for testing.
+  stubs.get('/uni') {[ 200, {}, 'urchin' ]}
+
+  resp = test.get '/tamago'
+  resp.body # => 'egg'
+  resp = test.get '/ebi'
+  resp.body # => 'shrimp'
+  resp = test.get '/uni'
+  resp.body # => 'urchin'
+  resp = test.get '/else' #=> raises "no such stub" error
+
+  # If you like, you can treat your stubs as mocks by verifying that all of 
+  # the stubbed calls were made. NOTE that this feature is still fairly
+  # experimental: It will not verify the order or count of any stub, only that
+  # it was called once during the course of the test.
+  stubs.verify_stubbed_calls
+
+== TODO
+
+* support streaming requests/responses
+* better stubbing API
+* Support timeouts
+* Add curb, em-http, fast_http
+
+== Note on Patches/Pull Requests
+ 
+* Fork the project.
+* Make your feature addition or bug fix.
+* Add tests for it. This is important so I don't break it in a
+  future version unintentionally.
+* Commit, do not mess with rakefile, version, or history.
+  (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
+* Send me a pull request. Bonus points for topic branches.
+
+== Copyright
+
+Copyright (c) 2009-2010 rick, hobson. See LICENSE for details.

data/Rakefile

@@ -0,0 +1,53 @@
+require 'rubygems'
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "shin-faraday"
+    gem.summary = "HTTP/REST API client library"
+    gem.description = "HTTP/REST API client library with pluggable components"
+    gem.email = "technoweenie@gmail.com"
+    gem.homepage = "http://github.com/shingara/faraday"
+    gem.authors = ["rick", "Cyril Mougel"]
+    gem.add_dependency "rack",        ">= 1.0.1"
+    gem.add_dependency "addressable", ">= 2.1.1"
+  end
+  Jeweler::GemcutterTasks.new
+
+  task :test => :check_dependencies
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: gem install jeweler"
+end
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'lib' << 'test'
+  test.pattern = 'test/**/*_test.rb'
+  test.verbose = true
+end
+
+begin
+  require 'rcov/rcovtask'
+  Rcov::RcovTask.new do |test|
+    test.libs << 'test'
+    test.pattern = 'test/**/*_test.rb'
+    test.verbose = true
+  end
+rescue LoadError
+  task :rcov do
+    abort "RCov is not available. In order to run rcov, you must: sudo gem install spicycode-rcov"
+  end
+end
+
+task :default => :test
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "faraday #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

@@ -0,0 +1 @@
+0.4.7

data/faraday.gemspec

@@ -0,0 +1,87 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{faraday}
+  s.version = "0.4.6"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["rick"]
+  s.date = %q{2010-05-28}
+  s.description = %q{HTTP/REST API client library with pluggable components}
+  s.email = %q{technoweenie@gmail.com}
+  s.extra_rdoc_files = [
+    "LICENSE",
+     "README.rdoc"
+  ]
+  s.files = [
+    ".document",
+     ".gitignore",
+     "LICENSE",
+     "README.rdoc",
+     "Rakefile",
+     "VERSION",
+     "faraday.gemspec",
+     "lib/faraday.rb",
+     "lib/faraday/adapter/net_http.rb",
+     "lib/faraday/adapter/patron.rb",
+     "lib/faraday/adapter/test.rb",
+     "lib/faraday/adapter/typhoeus.rb",
+     "lib/faraday/builder.rb",
+     "lib/faraday/connection.rb",
+     "lib/faraday/error.rb",
+     "lib/faraday/middleware.rb",
+     "lib/faraday/request.rb",
+     "lib/faraday/request/active_support_json.rb",
+     "lib/faraday/request/yajl.rb",
+     "lib/faraday/response.rb",
+     "lib/faraday/response/active_support_json.rb",
+     "lib/faraday/response/yajl.rb",
+     "test/adapters/live_test.rb",
+     "test/adapters/test_middleware_test.rb",
+     "test/adapters/typhoeus_test.rb",
+     "test/connection_app_test.rb",
+     "test/connection_test.rb",
+     "test/env_test.rb",
+     "test/helper.rb",
+     "test/live_server.rb",
+     "test/request_middleware_test.rb",
+     "test/response_middleware_test.rb"
+  ]
+  s.homepage = %q{http://github.com/technoweenie/faraday}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.6}
+  s.summary = %q{HTTP/REST API client library}
+  s.test_files = [
+    "test/adapters/live_test.rb",
+     "test/adapters/test_middleware_test.rb",
+     "test/adapters/typhoeus_test.rb",
+     "test/connection_app_test.rb",
+     "test/connection_test.rb",
+     "test/env_test.rb",
+     "test/helper.rb",
+     "test/live_server.rb",
+     "test/request_middleware_test.rb",
+     "test/response_middleware_test.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<rack>, [">= 1.0.1"])
+      s.add_runtime_dependency(%q<addressable>, [">= 2.1.1"])
+    else
+      s.add_dependency(%q<rack>, [">= 1.0.1"])
+      s.add_dependency(%q<addressable>, [">= 2.1.1"])
+    end
+  else
+    s.add_dependency(%q<rack>, [">= 1.0.1"])
+    s.add_dependency(%q<addressable>, [">= 2.1.1"])
+  end
+end
+

data/lib/faraday.rb

@@ -0,0 +1,94 @@
+require 'rack/utils'
+
+module Faraday
+  class << self
+    attr_accessor :default_adapter
+    attr_writer   :default_connection
+
+  private
+    def method_missing(name, *args, &block)
+      default_connection.send(name, *args, &block)
+    end
+  end
+
+  self.default_adapter = :net_http
+
+  def self.default_connection
+    @default_connection ||= Connection.new
+  end
+
+  module AutoloadHelper
+    def register_lookup_modules(mods)
+      (@lookup_module_index ||= {}).update(mods)
+    end
+
+    def lookup_module(key)
+      return if !@lookup_module_index
+      const_get @lookup_module_index[key] || key
+    end
+
+    def autoload_all(prefix, options)
+      options.each do |const_name, path|
+        autoload const_name, File.join(prefix, path)
+      end
+    end
+
+    # Loads each autoloaded constant.  If thread safety is a concern, wrap
+    # this in a Mutex.
+    def load_autoloaded_constants
+      constants.each do |const|
+        const_get(const) if autoload?(const)
+      end
+    end
+
+    def all_loaded_constants
+      constants.map { |c| const_get(c) }.select { |a| a.loaded? }
+    end
+  end
+
+  extend AutoloadHelper
+
+  autoload_all 'faraday', 
+    :Connection => 'connection',
+    :Middleware => 'middleware',
+    :Builder    => 'builder',
+    :Request    => 'request',
+    :Response   => 'response',
+    :Error      => 'error'
+
+  module Adapter
+    extend AutoloadHelper
+    autoload_all 'faraday/adapter',
+      :ActionDispatch => 'action_dispatch',
+      :NetHttp        => 'net_http',
+      :Typhoeus       => 'typhoeus',
+      :Patron         => 'patron',
+      :Test           => 'test'
+
+    register_lookup_modules \
+      :action_dispatch => :ActionDispatch,
+      :test            => :Test,
+      :net_http        => :NetHttp,
+      :typhoeus        => :Typhoeus,
+      :patron          => :Patron,
+      :net_http        => :NetHttp
+  end
+end
+
+# not pulling in active-support JUST for this method.
+class Object
+  # Yields <code>x</code> to the block, and then returns <code>x</code>.
+  # The primary purpose of this method is to "tap into" a method chain,
+  # in order to perform operations on intermediate results within the chain.
+  #
+  #   (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}" }
+  def tap
+    yield self
+    self
+  end unless Object.respond_to?(:tap)
+end

data/lib/faraday/adapter/action_dispatch.rb

@@ -0,0 +1,33 @@
+module Faraday
+  module Adapter
+    class ActionDispatch < Middleware
+      attr_reader :session
+
+      # Initializes a new middleware instance for each request.  Instead of 
+      # initiating an HTTP request with a web server, this adapter calls
+      # a Rails 3 app using integration tests.
+      #
+      # app     - The current Faraday request.
+      # session - An ActionDispatch::Integration::Session instance.
+      #
+      # Returns nothing.
+      def initialize(app, session)
+        super(app)
+        @session = session
+        @session.reset!
+      end
+
+      def call(env)
+        process_body_for_request(env)
+        full_path = full_path_for(env[:url].path, env[:url].query, env[:url].fragment)
+        @session.__send__(env[:method], full_path, env[:body], env[:request_headers])
+        resp = @session.response
+        env.update \
+          :status           => resp.status,
+          :response_headers => resp.headers,
+          :body             => resp.body
+        @app.call env
+      end
+    end
+  end
+end

data/lib/faraday/adapter/net_http.rb

@@ -0,0 +1,59 @@
+begin
+  require 'net/https'
+rescue LoadError
+  puts "no such file to load -- net/https. Make sure openssl is installed if you want ssl support"
+  require 'net/http'
+end
+
+module Faraday
+  module Adapter
+    class NetHttp < Middleware
+      def call(env)
+        process_body_for_request(env)
+
+        is_ssl = env[:url].scheme == 'https'
+
+        http = net_http_class(env).new(env[:url].host, env[:url].port || (is_ssl ? 443 : 80))
+        if http.use_ssl = is_ssl
+          ssl = env[:ssl]
+          if ssl[:verify] == false
+            http.verify_mode = OpenSSL::SSL::VERIFY_NONE
+          else
+            http.verify_mode = ssl[:verify]
+          end
+          http.cert    = ssl[:client_cert] if ssl[:client_cert]
+          http.key     = ssl[:client_key]  if ssl[:client_key]
+          http.ca_file = ssl[:ca_file]     if ssl[:ca_file]
+        end
+        req = env[:request]
+        http.read_timeout = net.open_timeout = req[:timeout] if req[:timeout]
+        http.open_timeout = req[:open_timeout]               if req[:open_timeout]
+        
+        full_path = full_path_for(env[:url].path, env[:url].query, env[:url].fragment)
+        http_resp = http.send_request(env[:method].to_s.upcase, full_path, env[:body], env[:request_headers])
+
+        resp_headers = {}
+        http_resp.each_header do |key, value|
+          resp_headers[key] = value
+        end
+
+        env.update \
+          :status           => http_resp.code.to_i, 
+          :response_headers => resp_headers, 
+          :body             => http_resp.body
+
+        @app.call env
+      rescue Errno::ECONNREFUSED
+        raise Error::ConnectionFailed, "connection refused"
+      end
+
+      def net_http_class(env)
+        if proxy = env[:request][:proxy]
+          Net::HTTP::Proxy(proxy[:uri].host, proxy[:uri].port, proxy[:user], proxy[:password])
+        else
+          Net::HTTP
+        end
+      end
+    end
+  end
+end