faraday 0.6.0 → 0.9.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 0e442daff424089e143751d7cb1d684c169bf4fc
+  data.tar.gz: ba1dd50171576d5064350e48b8869364c0710a26
+SHA512:
+  metadata.gz: 80c7a955f7d0a2217fcde0be2760649b9e5fc2d950929b118383ba61ea7282410b224315e289b40fec12be13898b0b00551e441704462ac39269368a8f9d5931
+  data.tar.gz: cdef47ebdb9519d0e45e7511326ed1368fa520ad314a4055ea154187193c967f8821573705161e3bbca5d3cbbf40f219071223ba8d24821c5dd89e37ddd16a9e

data/.document

@@ -0,0 +1,6 @@
+CONTRIBUTING.md
+LICENSE.md
+README.md
+bin/*
+lib/**/*.rb
+test/**/*.rb

data/CHANGELOG.md

@@ -0,0 +1,15 @@
+# Faraday Changelog
+
+## v0.9.0
+
+* Add HTTPClient adapter (@hakanensari)
+* Improve Retry handler (@mislav)
+* Remove autoloading by default (@technoweenie)
+* Improve internal docs (@technoweenie, @mislav)
+* Respect user/password in http proxy string (@mislav)
+* Adapter options are structs.  Reinforces consistent options across adapters
+  (@technoweenie)
+* Stop stripping trailing / off base URLs in a Faraday::Connection. (@technoweenie)
+* Add a configurable URI parser. (@technoweenie)
+* Remove need to manually autoload when using the authorization header helpers on `Faraday::Connection`. (@technoweenie)
+* `Faraday::Adapter::Test` respects the `Faraday::RequestOptions#params_encoder` option. (@technoweenie)

data/CONTRIBUTING.md

@@ -0,0 +1,36 @@
+## Contributing
+
+You can run the test suite against a live server by running `script/test`. It
+automatically starts a test server in background. Only tests in
+`test/adapters/*_test.rb` require a server, though.
+
+``` sh
+# run the whole suite
+$ script/test
+
+# run only specific files
+$ script/test excon typhoeus
+
+# run tests using SSL
+$ SSL=yes script/test
+```
+
+We will accept middleware that:
+
+1. is useful to a broader audience, but can be implemented relatively
+   simple; and
+2. which isn't already present in [faraday_middleware][] project.
+
+We will accept adapters that:
+
+1. support SSL & streaming;
+1. are proven and may have better performance than existing ones; or
+2. if they have features not present in included adapters.
+
+We are pushing towards a 1.0 release, when we will have to follow [Semantic
+Versioning][semver].  If your patch includes changes to break compatiblitity,
+note that so we can add it to the [Changelog][].
+
+[semver]:    http://semver.org/
+[changelog]: https://github.com/technoweenie/faraday/wiki/Changelog
+[faraday_middleware]: https://github.com/pengwynn/faraday_middleware/wiki

data/Gemfile

@@ -1,19 +1,29 @@
-source "http://rubygems.org"
+source 'https://rubygems.org'
 
-# Bundle gems for the local environment. Make sure to
-# put test-only gems in this group so their generators
-# and rake tasks are available in development mode:
-group :development, :test do
-  gem 'patron', '~> 0.4', :platforms => :ruby
-  gem 'sinatra', '~> 1.1'
-  gem 'typhoeus', '~> 0.2', :platforms => :ruby
-  gem 'excon', '~> 0.5.8'
-  gem 'em-http-request', '~> 0.3', :require => 'em-http', :platforms => :ruby
-  gem 'em-synchrony', '~> 0.2', :require => ['em-synchrony', 'em-synchrony/em-http'], :platforms => :ruby_19
-  gem 'webmock'
-  # ActiveSupport::JSON will be used in ruby 1.8 and Yajl in 1.9; this is to test against both adapters
-  gem 'activesupport', '~> 2.3.8', :require => nil, :platforms => [:ruby_18, :jruby]
-  gem 'yajl-ruby', :require => 'yajl', :platforms => :ruby_19
+gem 'ffi-ncurses', '~> 0.3', :platforms => :jruby
+gem 'jruby-openssl', '~> 0.8.8', :platforms => :jruby
+gem 'rake'
+
+group :test do
+  gem 'coveralls', :require => false
+  gem 'em-http-request', '>= 1.1', :require => 'em-http'
+  gem 'em-synchrony', '>= 1.0.3', :require => ['em-synchrony', 'em-synchrony/em-http']
+  gem 'excon', '>= 0.27.4'
+  gem 'httpclient', '>= 2.2'
+  gem 'leftright', '>= 0.9', :require => false
+  gem 'mime-types', '~> 1.25', :platforms => [:jruby, :ruby_18]
+  gem 'minitest', '>= 5.0.5'
+  gem 'net-http-persistent', '>= 2.5', :require => false
+  gem 'patron', '>= 0.4.2', :platforms => :ruby
+  gem 'rack-test', '>= 0.6', :require => 'rack/test'
+  gem 'simplecov'
+  gem 'sinatra', '~> 1.3'
+  gem 'typhoeus', '~> 0.3.3', :platforms => :ruby
+end
+
+platforms :rbx do
+  gem 'rubinius-coverage'
+  gem 'rubysl'
 end
 
 gemspec

data/{LICENSE → LICENSE.md}

@@ -1,4 +1,4 @@
-Copyright (c) 2009-* rick olson, zack hobson
+Copyright (c) 2009-2013 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

data/README.md

@@ -1,166 +1,216 @@
-# faraday
+# Faraday
 
-Modular HTTP client library using middleware heavily inspired by Rack.
+Faraday is an HTTP client lib that provides a common interface over many
+adapters (such as Net::HTTP) and embraces the concept of Rack middleware when
+processing the request/response cycle.
 
-This mess is gonna get raw, like sushi. So, haters to the left.
+Faraday supports these adapters:
+
+* Net::HTTP
+* [Excon][]
+* [Typhoeus][]
+* [Patron][]
+* [EventMachine][]
+
+It also includes a Rack adapter for hitting loaded Rack applications through
+Rack::Test, and a Test adapter for stubbing requests by hand.
 
 ## Usage
 
-    conn = Faraday.new(:url => 'http://sushi.com') do |builder|
-      builder.use Faraday::Request::UrlEncoded  # convert request params as "www-form-urlencoded"
-      builder.use Faraday::Request::JSON        # encode request params as json
-      builder.use Faraday::Response::Logger     # log the request to STDOUT
-      builder.use Faraday::Adapter::NetHttp     # make http requests with Net::HTTP
-
-      # or, use shortcuts:
-      builder.request  :url_encoded
-      builder.request  :json
-      builder.response :logger
-      builder.adapter  :net_http
-    end
-    
-    ## GET ##
-
-    response = conn.get '/nigiri/sake.json'     # GET http://sushi.com/nigiri/sake.json
-    response.body
-
-    conn.get '/nigiri', 'X-Awesome' => true     # custom request header
-    
-    conn.get do |req|                           # GET http://sushi.com/search?page=2&limit=100
-      req.url '/search', :page => 2
-      req.params['limit'] = 100
-    end
-    
-    ## POST ##
-    
-    conn.post '/nigiri', { :name => 'Maguro' }  # POST "name=maguro" to http://sushi.com/nigiri
-    
-    # post payload as JSON instead of "www-form-urlencoded" encoding:
-    conn.post '/nigiri', payload, 'Content-Type' => 'application/json'
-
-    # a more verbose way:
-    conn.post do |req|
-      req.url '/nigiri'
-      req.headers['Content-Type'] = 'application/json'
-      req.body = { :name => 'Unagi' }
-    end
-
-If you're ready to roll with just the bare minimum:
-
-    # default stack (net/http), no extra middleware:
-    response = Faraday.get 'http://sushi.com/nigiri/sake.json'
+```ruby
+conn = Faraday.new(:url => 'http://sushi.com') do |faraday|
+  faraday.request  :url_encoded             # form-encode POST params
+  faraday.response :logger                  # log requests to STDOUT
+  faraday.adapter  Faraday.default_adapter  # make requests with Net::HTTP
+end
+
+## GET ##
+
+response = conn.get '/nigiri/sake.json'     # GET http://sushi.com/nigiri/sake.json
+response.body
+
+conn.get '/nigiri', { :name => 'Maguro' }   # GET /nigiri?name=Maguro
+
+conn.get do |req|                           # GET http://sushi.com/search?page=2&limit=100
+  req.url '/search', :page => 2
+  req.params['limit'] = 100
+end
+
+## POST ##
+
+conn.post '/nigiri', { :name => 'Maguro' }  # POST "name=maguro" to http://sushi.com/nigiri
+
+# post payload as JSON instead of "www-form-urlencoded" encoding:
+conn.post do |req|
+  req.url '/nigiri'
+  req.headers['Content-Type'] = 'application/json'
+  req.body = '{ "name": "Unagi" }'
+end
+
+## Per-request options ##
+
+conn.get do |req|
+  req.url '/search'
+  req.options.timeout = 5           # open/read timeout in seconds
+  req.options.open_timeout = 2      # connection open timeout in seconds
+end
+```
+
+If you don't need to set up anything, you can roll with just the bare minimum:
+
+```ruby
+# using the default stack:
+response = Faraday.get 'http://sushi.com/nigiri/sake.json'
+```
 
 ## Advanced middleware usage
 
-The order in which middleware is stacked is important. Like with Rack, the first middleware on the list wraps all others, while the last middleware is the innermost one, so that's usually the adapter.
+The order in which middleware is stacked is important. Like with Rack, the
+first middleware on the list wraps all others, while the last middleware is the
+innermost one, so that must be the adapter.
 
-    conn = Faraday.new(:url => 'http://sushi.com') do |builder|
-      # POST/PUT params encoders:
-      builder.request  :multipart
-      builder.request  :url_encoded
-      builder.request  :json
-      
-      builder.adapter  :net_http
-    end
+```ruby
+Faraday.new(...) do |conn|
+  # POST/PUT params encoders:
+  conn.request :multipart
+  conn.request :url_encoded
+
+  conn.adapter :net_http
+end
+```
 
 This request middleware setup affects POST/PUT requests in the following way:
 
-1. `Request::Multipart` checks for files in the payload, otherwise leaves everything untouched;
-2. `Request::UrlEncoded` encodes as "application/x-www-form-urlencoded" if not already encoded or of another type
-2. `Request::JSON` encodes as "application/json" if not already encoded or of another type
+1. `Request::Multipart` checks for files in the payload, otherwise leaves
+  everything untouched;
+2. `Request::UrlEncoded` encodes as "application/x-www-form-urlencoded" if not
+  already encoded or of another type
 
-Because "UrlEncoded" is higher on the stack than JSON encoder, it will get to process the request first. Swapping them means giving the other priority. Specifying the "Content-Type" for the request is explicitly stating which middleware should process it.
+Swapping middleware means giving the other priority. Specifying the
+"Content-Type" for the request is explicitly stating which middleware should
+process it.
 
 Examples:
 
-    payload = { :name => 'Maguro' }
-    
-    # post payload as JSON instead of urlencoded:
-    conn.post '/nigiri', payload, 'Content-Type' => 'application/json'
-    
-    # uploading a file:
-    payload = { :profile_pic => Faraday::UploadIO.new('avatar.jpg', 'image/jpeg') }
-    
-    # "Multipart" middleware detects files and encodes with "multipart/form-data":
-    conn.put '/profile', payload
+```ruby
+# uploading a file:
+payload[:profile_pic] = Faraday::UploadIO.new('/path/to/avatar.jpg', 'image/jpeg')
+
+# "Multipart" middleware detects files and encodes with "multipart/form-data":
+conn.put '/profile', payload
+```
 
 ## Writing middleware
 
-Middleware are classes that respond to `call()`. They wrap the request/response cycle.
-
-    def call(env)
-      # do something with the request
-      
-      @app.call(env).on_complete do
-        # do something with the response
-      end
-    end
-
-It's important to do all processing of the response only in the `on_complete` block. This enables middleware to work in parallel mode where requests are asynchronous.
-
-The `env` is a hash with symbol keys that contains info about the request and, later, response. Some keys are:
-
-    # request phase
-    :method - :get, :post, ...
-    :url    - URI for the current request; also contains GET parameters
-    :body   - POST parameters for :post/:put requests
-    :request_headers
-
-    # response phase
-    :status - HTTP response status code, such as 200
-    :body   - the response body
-    :response_headers
-
-## Testing
-
-    # It's possible to define stubbed request outside a test adapter block.
-    stubs = Faraday::Adapter::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.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
+Middleware are classes that implement a `call` instance method. They hook into
+the request/response cycle.
+
+```ruby
+def call(env)
+  # do something with the request
+
+  @app.call(env).on_complete do
+    # do something with the response
+  end
+end
+```
+
+It's important to do all processing of the response only in the `on_complete`
+block. This enables middleware to work in parallel mode where requests are
+asynchronous.
+
+The `env` is a hash with symbol keys that contains info about the request and,
+later, response. Some keys are:
+
+```
+# request phase
+:method - :get, :post, ...
+:url    - URI for the current request; also contains GET parameters
+:body   - POST parameters for :post/:put requests
+:request_headers
+
+# response phase
+:status - HTTP response status code, such as 200
+:body   - the response body
+:response_headers
+```
+
+## Using Faraday for testing
+
+```ruby
+# It's possible to define stubbed request outside a test adapter block.
+stubs = Faraday::Adapter::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.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
+## Supported Ruby versions
+
+This library aims to support and is [tested against][travis] the following Ruby
+implementations:
+
+* MRI 1.8.7
+* MRI 1.9.2
+* MRI 1.9.3
+* MRI 2.0.0
+* MRI 2.1.0
+* [JRuby][]
+* [Rubinius][]
+
+If something doesn't work on one of these Ruby versions, it's a bug.
+
+This library may inadvertently work (or seem to work) on other Ruby
+implementations, however support will only be provided for the versions listed
+above.
 
-* 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.
+If you would like this library to support another Ruby version, you may
+volunteer to be a maintainer. Being a maintainer entails making sure all tests
+run and pass on that implementation. When something breaks on your
+implementation, you will be responsible for providing patches in a timely
+fashion. If critical issues for a particular implementation exist at the time
+of a major release, support for that Ruby version may be dropped.
 
 ## Copyright
 
-Copyright (c) 2009-2011 rick, hobson. See LICENSE for details.
+Copyright (c) 2009-2013 [Rick Olson](mailto:technoweenie@gmail.com), Zack Hobson.
+See [LICENSE][] for details.
+
+[travis]:    http://travis-ci.org/lostisland/faraday
+[excon]:     https://github.com/geemus/excon#readme
+[typhoeus]:  https://github.com/typhoeus/typhoeus#readme
+[patron]:    http://toland.github.com/patron/
+[eventmachine]: https://github.com/igrigorik/em-http-request#readme
+[jruby]:     http://jruby.org/
+[rubinius]:  http://rubini.us/
+[license]:   LICENSE.md

data/Rakefile

@@ -1,12 +1,13 @@
-require 'rubygems'
-require 'rake'
 require 'date'
+require 'fileutils'
+require 'openssl'
+require 'rake/testtask'
+require 'bundler'
+Bundler::GemHelper.install_tasks
+
+task :default => :test
 
-#############################################################################
-#
-# Helper functions
-#
-#############################################################################
+## helper functions
 
 def name
   @name ||= Dir['*.gemspec'].first.split('.').first
@@ -17,14 +18,6 @@ def version
   line.match(/.*VERSION\s*=\s*['"](.*)['"]/)[1]
 end
 
-def date
-  Date.today.to_s
-end
-
-def rubyforge_project
-  name
-end
-
 def gemspec_file
   "#{name}.gemspec"
 end
@@ -37,98 +30,42 @@ def replace_header(head, header_name)
   head.sub!(/(\.#{header_name}\s*= ').*'/) { "#{$1}#{send(header_name)}'"}
 end
 
-#############################################################################
-#
-# Standard tasks
-#
-#############################################################################
-
-task :default => :test
-
-require 'rake/testtask'
-Rake::TestTask.new(:test) do |test|
-  test.libs << 'lib' << 'test'
-  test.pattern = 'test/**/*_test.rb'
-  test.verbose = true
-end
-
-desc "Open an irb session preloaded with this library"
-task :console do
-  sh "irb -rubygems -r ./lib/#{name}.rb"
+# Adapted from WEBrick::Utils. Skips cert extensions so it
+# can be used as a CA bundle
+def create_self_signed_cert(bits, cn, comment)
+  rsa = OpenSSL::PKey::RSA.new(bits)
+  cert = OpenSSL::X509::Certificate.new
+  cert.version = 2
+  cert.serial = 1
+  name = OpenSSL::X509::Name.new(cn)
+  cert.subject = name
+  cert.issuer = name
+  cert.not_before = Time.now
+  cert.not_after = Time.now + (365*24*60*60)
+  cert.public_key = rsa.public_key
+  cert.sign(rsa, OpenSSL::Digest::SHA1.new)
+  return [cert, rsa]
 end
 
-#############################################################################
-#
-# Custom tasks (add your own tasks here)
-#
-#############################################################################
-
+## standard tasks
 
-
-#############################################################################
-#
-# Packaging tasks
-#
-#############################################################################
-
-desc "Create tag v#{version} and build and push #{gem_file} to Rubygems"
-task :release => :build do
-  unless `git branch` =~ /^\* master$/
-    puts "You must be on the master branch to release!"
-    exit!
-  end
-  sh "git commit --allow-empty -a -m 'Release #{version}'"
-  sh "git tag v#{version}"
-  sh "git push origin master"
-  sh "git push origin v#{version}"
-  sh "gem push pkg/#{gem_file}"
+desc "Run all tests"
+task :test do
+  exec 'script/test'
 end
 
-desc "Build #{gem_file} into the pkg directory"
-task :build => :gemspec do
-  sh "mkdir -p pkg"
-  sh "gem build #{gemspec_file}"
-  sh "mv #{gem_file} pkg"
+desc "Generate certificates for SSL tests"
+task :'test:generate_certs' do
+  cert, key = create_self_signed_cert(1024, [['CN', 'localhost']], 'Faraday Test CA')
+  FileUtils.mkdir_p 'tmp'
+  File.open('tmp/faraday-cert.key', 'w') {|f| f.puts(key) }
+  File.open('tmp/faraday-cert.crt', 'w') {|f| f.puts(cert.to_s) }
 end
 
-desc "Generate #{gemspec_file}"
-task :gemspec => :validate do
-  # read spec file and split out manifest section
-  spec = File.read(gemspec_file)
-  head, manifest, tail = spec.split("  # = MANIFEST =\n")
-
-  # replace name version and date
-  replace_header(head, :name)
-  replace_header(head, :version)
-  replace_header(head, :date)
-  #comment this out if your rubyforge_project has a different name
-  replace_header(head, :rubyforge_project)
+file 'tmp/faraday-cert.key' => :'test:generate_certs'
+file 'tmp/faraday-cert.crt' => :'test:generate_certs'
 
-  # determine file list from git ls-files
-  files = `git ls-files`.
-    split("\n").
-    sort.
-    reject { |file| file =~ /^\./ }.
-    reject { |file| file =~ /^(rdoc|pkg)/ }.
-    map { |file| "    #{file}" }.
-    join("\n")
-
-  # piece file back together and write
-  manifest = "  s.files = %w[\n#{files}\n  ]\n"
-  spec = [head, manifest, tail].join("  # = MANIFEST =\n")
-  File.open(gemspec_file, 'w') { |io| io.write(spec) }
-  puts "Updated #{gemspec_file}"
-end
-
-desc "Validate #{gemspec_file}"
-task :validate do
-  libfiles = Dir['lib/*'] - ["lib/#{name}.rb", "lib/#{name}"]
-  unless libfiles.empty?
-    puts "Directory `lib` should only contain a `#{name}.rb` file and `#{name}` dir."
-    exit!
-  end
-  unless Dir['VERSION*'].empty?
-    puts "A `VERSION` file at root level violates Gem best practices."
-    exit!
-  end
+desc "Open an irb session preloaded with this library"
+task :console do
+  sh "irb -rubygems -r ./lib/#{name}.rb"
 end