rest-client 1.6.7 → 1.8.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 683937d317980acfcfcfbc94eb76f2566ed3bf92
+  data.tar.gz: fa2f669653292404bc814fb436c17755060a75a6
+SHA512:
+  metadata.gz: c57e29fbfe2e0bb92cf1556e38438171c04739dc6499098c651021c3e797e7724aa12b70f552d4ad43fe78f7e30d20eeea4b94e29dacb7122d936a253d1d8b98
+  data.tar.gz: 234257c6569615bc71b4642c7d2f4850b79bbe5eefc3afc8b62eb899023d3a1e12fd3e81366c356817217b50899c7357fd6a9d16f59819c2ca3a1c0b55e9f480

data/.gitignore

@@ -0,0 +1,7 @@
+*.gem
+/Gemfile.lock
+/.bundle
+/vendor
+/doc
+/pkg
+/rdoc

data/.rspec

@@ -0,0 +1 @@
+--colour --format progress --order random

data/.travis.yml

@@ -0,0 +1,14 @@
+language: ruby
+rvm:
+  - "1.9.2"
+  - "1.9.3"
+  - "2.0.0"
+  # Forgo 2.1.0 until Travis has a satisfactory fix for
+  # https://github.com/travis-ci/travis-ci/issues/2220
+  - "2.1"  # always the latest 2.1.x
+  - "jruby-19mode"
+script:
+  bundle exec rake test
+branches:
+  except:
+    - "readme-edits"

data/AUTHORS

@@ -0,0 +1,81 @@
+The Ruby REST Client would not be what it is today without the help of
+the following kind souls:
+
+Adam Jacob
+Adam Wiggins
+Aman Gupta
+Andy Brody
+Blake Mizerany
+Brad Ediger
+Braintree
+Brian Donovan
+Caleb Land
+Chris Dinn
+Chris Frohoff
+Chris Green
+Coda Hale
+Crawford
+Cyril Rohr
+Dan Mayer
+David Backeus
+David Perkowski
+Dmitri Dolguikh
+Dusty Doris
+Dylan Egan
+El Draper
+Evan Smith
+François Beausoleil
+Gabriele Cirulli
+Garry Shutler
+Giovanni Cappellotto
+Greg Borenstein
+Harm Aarts
+Hiro Asari
+Hugh McGowan
+Ian Warshak
+Ivan Makfinsky
+JH. Chabran
+James Edward Gray II
+Jari Bakken
+Jeff Remer
+Jeffrey Hardy
+Jeremy Kemper
+John Barnette
+Jon Rowe
+Jordi Massaguer Pla
+Juan Alvarez
+Julien Kirch
+Justin Coyne
+Justin Lambert
+Keith Rarick
+Kenichi Kamiya
+Kevin Read
+Kosuke Asami
+Kyle VanderBeek
+Lars Gierth
+Lawrence Leonard Gilbert
+Lee Jarvis
+Lennon Day-Reynolds
+Marc-André Cournoyer
+Matthew Manning
+Michael Klett
+Mike Fletcher
+Nicholas Wieland
+Nick Plante
+Niko Dittmann
+Oscar Del Ben
+Pablo Astigarraga
+Paul Dlug
+Pedro Belo
+Philip Corliss
+Pierre-Louis Gottfrois
+Rafael Ssouza
+Rick "technoweenie"
+Robert Eanes
+Rodrigo Panachi
+Syl Turner
+T. Watanabe
+Tekin
+W. Andrew Loe III
+Waynn Lue
+tpresa

data/Gemfile

@@ -0,0 +1,11 @@
+source "https://rubygems.org"
+
+if !!File::ALT_SEPARATOR
+  gemspec :name => 'rest-client.windows'
+else
+  gemspec :name => 'rest-client'
+end
+
+group :test do
+  gem 'rake'
+end

data/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2008-2014 Rest Client Authors
+
+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

@@ -1,11 +1,34 @@
 = REST Client -- simple DSL for accessing HTTP and REST resources
 
+Build status: {<img src="https://travis-ci.org/rest-client/rest-client.svg?branch=master" alt="Build Status" />}[https://travis-ci.org/rest-client/rest-client]
+
 A simple HTTP and REST client for Ruby, inspired by the Sinatra's microframework style
 of specifying actions: get, put, post, delete.
 
-* Main page: http://github.com/archiloque/rest-client
+* Main page: https://github.com/rest-client/rest-client
 * Mailing list: rest.client@librelist.com (send a mail to subscribe).
 
+== Requirements
+
+MRI Ruby 1.9.2 and newer are supported. Alternative interpreters compatible with
+1.9.1+ should work as well.
+
+Ruby 1.8.7 is no longer supported.  That's because the Ruby 1.8.7 interpreter
+itself no longer has official support, _not_ _even_ _security_ _patches!_ If you
+have been putting off upgrading your servers, now is the time.
+({More info is on the Ruby developers'
+blog.}[http://www.ruby-lang.org/en/news/2013/06/30/we-retire-1-8-7/])
+
+The rest-client gem depends on these other gems for installation and usage:
+
+* {mime-types}[http://rubygems.org/gems/mime-types]
+* {netrc}[http://rubygems.org/gems/netrc]
+* {rdoc}[http://rubygems.org/gems/rdoc]
+
+If you want to hack on the code, you should also have {the Bundler
+gem}[http://bundler.io/] installed so it can manage all necessary development
+dependencies for you.
+
 == Usage: Raw URL
 
   require 'rest_client'
@@ -57,7 +80,7 @@ This does two things for you:
 
 If you are sending params that do not contain a File object but the payload needs to be multipart then:
 
-  RestClient.post '/data', :foo => 'bar', :multipart => true
+  RestClient.post '/data', {:foo => 'bar', :multipart => true}
 
 == Usage: ActiveResource-Style
 
@@ -78,10 +101,10 @@ See RestClient::Resource docs for details.
 
 == Exceptions (see http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html)
 
-* for results code between 200 and 207 a RestClient::Response will be returned
-* for results code 301, 302 or 307 the redirection will be followed if the request is a get or a head
-* for result code 303 the redirection will be followed and the request transformed into a get
-* for other cases a RestClient::Exception holding the Response will be raised, a specific exception class will be thrown for know error codes
+* for result codes between 200 and 207, a RestClient::Response will be returned
+* for result codes 301, 302 or 307, the redirection will be followed if the request is a GET or a HEAD
+* for result code 303, the redirection will be followed and the request transformed into a GET
+* for other cases, a RestClient::Exception holding the Response will be raised; a specific exception class will be thrown for known error codes
 
    RestClient.get 'http://example.com/resource'
    ➔ RestClient::ResourceNotFound: RestClient::ResourceNotFound
@@ -95,7 +118,7 @@ See RestClient::Resource docs for details.
 
 == Result handling
 
-A block can be passed to the RestClient method, this block will then be called with the Response.
+A block can be passed to the RestClient method. This block will then be called with the Response.
 Response.return! can be called to invoke the default response's behavior.
 
   # Don't raise exceptions but return the response
@@ -127,24 +150,25 @@ Response.return! can be called to invoke the default response's behavior.
     end
   }
 
-== Non-normalized URIs.
+== Non-normalized URIs
 
-If you want to use non-normalized URIs, you can normalize them with the addressable gem (http://addressable.rubyforge.org/api/).
+If you need to normalize URIs, e.g. to work with International Resource Identifiers (IRIs),
+use the addressable gem (http://addressable.rubyforge.org/api/) in your code:
 
   require 'addressable/uri'
   RestClient.get(Addressable::URI.parse("http://www.詹姆斯.com/").normalize.to_str)
 
 == Lower-level access
 
-For cases not covered by the general API, you can use the RestClient::Request class which provide a lower-level API.
+For cases not covered by the general API, you can use the RestClient::Request class, which provides a lower-level API.
 
 You can:
 
 * specify ssl parameters
 * override cookies
-* manually handle the response (so you can operate on the response stream than reading it fully in memory)
+* manually handle the response (e.g. to operate on it as a stream rather than reading it all into memory)
 
-see the class' rdoc for more information.
+See RestClient::Request's documentation for more information.
 
 == Shell
 
@@ -186,10 +210,10 @@ Use as a one-off, curl-style:
 
 == Logging
 
-To enable logging you can
+To enable logging you can:
 
-* set RestClient.log with a ruby Logger
-* or set an environment variable to avoid modifying the code (in this case you can use a file name, "stdout" or "stderr"):
+* set RestClient.log with a Ruby Logger, or
+* set an environment variable to avoid modifying the code (in this case you can use a file name, "stdout" or "stderr"):
 
    $ RESTCLIENT_LOG=stdout path/to/my/program
 
@@ -212,7 +236,7 @@ RestClient.proxy:
   RestClient.get "http://some/resource"
   # => response from some/resource as proxied through proxy.example.com
 
-Often the proxy url is set in an environment variable, so you can do this to
+Often the proxy URL is set in an environment variable, so you can do this to
 use whatever proxy the system is configured to use:
 
   RestClient.proxy = ENV['http_proxy']
@@ -220,8 +244,7 @@ use whatever proxy the system is configured to use:
 == Query parameters
 
 Request objects know about query parameters and will automatically add them to
-the url for GET, HEAD and DELETE requests and escape the keys and values as 
-needed:
+the URL for GET, HEAD and DELETE requests, escaping the keys and values as needed:
 
   RestClient.get 'http://example.com/resource', :params => {:foo => 'bar', :baz => 'qux'}
   # will GET http://example.com/resource?foo=bar&baz=qux
@@ -256,11 +279,12 @@ Self-signed certificates can be generated with the openssl command-line tool.
 
 == Hook
 
-RestClient.add_before_execution_proc add a Proc to be called before each execution, it's handy if you need a direct access to the http request.
+RestClient.add_before_execution_proc add a Proc to be called before each execution.
+It's handy if you need direct access to the HTTP request.
 
 Example:
 
-  # Add oath support using the oauth gem
+  # Add oauth support using the oauth gem
   require 'oauth'
   access_token = ...
 
@@ -272,14 +296,29 @@ Example:
 
 == More
 
-Need caching, more advanced logging or any ability provided by a rack middleware ?
+Need caching, more advanced logging or any ability provided by Rack middleware?
 
-Have a look at rest-client-components http://github.com/crohr/rest-client-components
+Have a look at rest-client-components: http://github.com/crohr/rest-client-components
 
-== Meta
+== Credits
 
-Written by Adam Wiggins, major modifications by Blake Mizerany, maintained by Julien Kirch
+REST Client Team:: Matthew Manning, Lawrence Leonard Gilbert, Andy Brody
+
+Creator:: Adam Wiggins
+
+Maintainer Emeritus:: Julien Kirch
+
+Major contributions:: Blake Mizerany, Julien Kirch
 
 Patches contributed by many, including Chris Anderson, Greg Borenstein, Ardekantur, Pedro Belo, Rafael Souza, Rick Olson, Aman Gupta, François Beausoleil and Nick Plante.
 
+== Legal
+
 Released under the MIT License: http://www.opensource.org/licenses/mit-license.php
+
+"Master Shake" photo (http://www.flickr.com/photos/solgrundy/924205581/) by
+"SolGrundy"; used under terms of the Creative Commons Attribution-ShareAlike 2.0
+Generic license (http://creativecommons.org/licenses/by-sa/2.0/)
+
+Code for reading Windows root certificate store derived from work by Puppet;
+used under terms of the Apache License, Version 2.0.

data/Rakefile

@@ -1,59 +1,110 @@
-require 'rake'
-
-require 'jeweler'
-
-Jeweler::Tasks.new do |s|
-  s.name = "rest-client"
-  s.description = "A simple HTTP and REST client for Ruby, inspired by the Sinatra microframework style of specifying actions: get, put, post, delete."
-  s.summary = "Simple HTTP and REST client for Ruby, inspired by microframework syntax for specifying actions."
-  s.authors = ["Adam Wiggins", "Julien Kirch"]
-  s.email = "rest.client@librelist.com"
-  s.homepage = "http://github.com/archiloque/rest-client"
-  s.files = FileList["[A-Z]*", "{bin,lib,spec}/**/*"]
-  s.test_files = FileList["{spec}/**/*"]
-  s.add_runtime_dependency("mime-types", ">= 1.16")
-  s.add_development_dependency("webmock", ">= 0.9.1")
-  s.add_development_dependency("rspec")
-  s.extra_rdoc_files = [ 'README.rdoc', 'history.md']
-end
+# load `rake build/install/release tasks'
+require 'bundler/setup'
+require_relative './lib/restclient/version'
 
-############################
+namespace :ruby do
+  Bundler::GemHelper.install_tasks(:name => 'rest-client')
+end
 
-require 'spec/rake/spectask'
+require "rspec/core/rake_task"
 
 desc "Run all specs"
-task :spec => ["spec:unit", "spec:integration"]
+RSpec::Core::RakeTask.new('spec')
 
 desc "Run unit specs"
-Spec::Rake::SpecTask.new('spec:unit') do |t|
-  t.spec_opts = ['--colour --format progress --loadby mtime --reverse']
-  t.spec_files = FileList['spec/*_spec.rb']
+RSpec::Core::RakeTask.new('spec:unit') do |t|
+  t.pattern = 'spec/unit/*_spec.rb'
 end
 
 desc "Run integration specs"
-Spec::Rake::SpecTask.new('spec:integration') do |t|
-  t.spec_opts = ['--colour --format progress --loadby mtime --reverse']
-  t.spec_files = FileList['spec/integration/*_spec.rb']
+RSpec::Core::RakeTask.new('spec:integration') do |t|
+  t.pattern = 'spec/integration/*_spec.rb'
 end
 
 desc "Print specdocs"
-Spec::Rake::SpecTask.new(:doc) do |t|
-  t.spec_opts = ["--format", "specdoc", "--dry-run"]
-  t.spec_files = FileList['spec/*_spec.rb']
+RSpec::Core::RakeTask.new(:doc) do |t|
+  t.rspec_opts = ["--format", "specdoc", "--dry-run"]
+  t.pattern = 'spec/**/*_spec.rb'
 end
 
 desc "Run all examples with RCov"
-Spec::Rake::SpecTask.new('rcov') do |t|
-  t.spec_files = FileList['spec/*_spec.rb']
+RSpec::Core::RakeTask.new('rcov') do |t|
+  t.pattern = 'spec/*_spec.rb'
   t.rcov = true
   t.rcov_opts = ['--exclude', 'examples']
 end
 
-task :default => :spec
+task :default do
+  sh 'rake -T'
+end
+
+def alias_task(alias_task, original)
+  desc "Alias for rake #{original}"
+  task alias_task, Rake.application[original].arg_names => original
+end
+alias_task(:test, :spec)
 
 ############################
 
-require 'rake/rdoctask'
+WindowsPlatforms = %w{x86-mingw32 x64-mingw32 x86-mswin32}
+
+namespace :all do
+
+  desc "Build rest-client #{RestClient::VERSION} for all platforms"
+  task :build => ['ruby:build'] + \
+    WindowsPlatforms.map {|p| "windows:#{p}:build"}
+
+  desc "Create tag v#{RestClient::VERSION} and for all platforms build and push " \
+    "rest-client #{RestClient::VERSION} to Rubygems"
+  task :release => ['build', 'ruby:release'] + \
+    WindowsPlatforms.map {|p| "windows:#{p}:push"}
+
+end
+
+namespace :windows do
+  spec_path = File.join(File.dirname(__FILE__), 'rest-client.windows.gemspec')
+
+  WindowsPlatforms.each do |platform|
+    namespace platform do
+      gem_filename = "rest-client-#{RestClient::VERSION}-#{platform}.gem"
+      base = File.dirname(__FILE__)
+      pkg_dir = File.join(base, 'pkg')
+      gem_file_path = File.join(pkg_dir, gem_filename)
+
+      desc "Build #{gem_filename} into the pkg directory"
+      task 'build' do
+        orig_platform = ENV['BUILD_PLATFORM']
+        begin
+          ENV['BUILD_PLATFORM'] = platform
+
+          sh("gem build -V #{spec_path}") do |ok, res|
+            if ok
+              FileUtils.mkdir_p(pkg_dir)
+              FileUtils.mv(File.join(base, gem_filename), pkg_dir)
+              Bundler.ui.confirm("rest-client #{RestClient::VERSION} " \
+                                 "built to pkg/#{gem_filename}")
+            else
+              abort "Command `gem build` failed: #{res}"
+            end
+          end
+
+        ensure
+          ENV['BUILD_PLATFORM'] = orig_platform
+        end
+      end
+
+      desc "Push #{gem_filename} to Rubygems"
+      task 'push' do
+        sh("gem push #{gem_file_path}")
+      end
+    end
+  end
+
+end
+
+############################
+
+require 'rdoc/task'
 
 Rake::RDocTask.new do |t|
   t.rdoc_dir = 'rdoc'
@@ -63,4 +114,3 @@ Rake::RDocTask.new do |t|
   t.rdoc_files.include('README.rdoc')
   t.rdoc_files.include('lib/*.rb')
 end
-

data/bin/restclient

@@ -1,6 +1,6 @@
 #!/usr/bin/env ruby
 
-$:.unshift File.dirname(__FILE__) + "/../lib"
+$LOAD_PATH.unshift File.dirname(__FILE__) + "/../lib"
 
 require 'rubygems'
 require 'restclient'
@@ -26,10 +26,10 @@ end
 
 config = YAML.load(File.read(ENV['HOME'] + "/.restclient")) rescue {}
 
-@url, @username, @password = if c = config[@url]
-  [c['url'], c['username'], c['password']]
+if (c = config[@url])
+  @url, @username, @password = [c['url'], c['username'], c['password']]
 else
-  [@url, * ARGV]
+  @url, @username, @password = [@url, * ARGV]
 end
 
 usage("invalid url '#{@url}") unless @url =~ /^https?/
@@ -50,7 +50,7 @@ if @verb
     end
     exit 0
   rescue RestClient::Exception => e
-    puts e.response.body if e.respond_to? :response
+    puts e.response.body if e.respond_to?(:response) && e.response
     raise
   end
 end
@@ -58,7 +58,7 @@ end
 POSSIBLE_VERBS.each do |m|
   eval <<-end_eval
 def  #{m}(path, *args, &b)
-	r[path].#{m}(*args, &b)
+  r[path].#{m}(*args, &b)
 end
   end_eval
 end
@@ -79,11 +79,12 @@ end
 require 'irb'
 require 'irb/completion'
 
-if File.exists? ".irbrc"
+if File.exist? ".irbrc"
   ENV['IRBRC'] = ".irbrc"
 end
 
-if File.exists?(File.expand_path(rcfile = "~/.restclientrc"))
+rcfile = File.expand_path("~/.restclientrc")
+if File.exist?(rcfile)
   load(rcfile)
 end
 

data/history.md

@@ -1,3 +1,65 @@
+# 1.8.0
+
+- Security: implement standards compliant cookie handling by adding a
+  dependency on http-cookie. This breaks compatibility, but was necessary to
+  address a session fixation / cookie disclosure vulnerability.
+  (#369 / CVE-2015-1820)
+
+  Previously, any Set-Cookie headers found in an HTTP 30x response would be
+  sent to the redirection target, regardless of domain. Responses now expose a
+  cookie jar and respect standards compliant domain / path flags in Set-Cookie
+  headers.
+
+# 1.7.3
+
+- Security: redact password in URI from logs (#349 / OSVDB-117461)
+- Drop monkey patch on MIME::Types (added `type_for_extension` method, use
+  the public interface instead.
+
+# 1.7.2
+
+- Ignore duplicate certificates in CA store on Windows
+
+# 1.7.1
+
+- Relax mime-types dependency to continue supporting mime-types 1.x series.
+  There seem to be a large number of popular gems that have depended on
+  mime-types '~> 1.16' until very recently.
+- Improve urlencode performance
+- Clean up a number of style points
+
+# 1.7.0
+
+- This release drops support for Ruby 1.8.7 and breaks compatibility in a few
+  other relatively minor ways
+- Upgrade to mime-types ~> 2.0
+- Don't CGI.unescape cookie values sent to the server (issue #89)
+- Add support for reading credentials from netrc
+- Lots of SSL changes and enhancements: (#268)
+  - Enable peer verification by default (setting `VERIFY_PEER` with OpenSSL)
+  - By default, use the system default certificate store for SSL verification,
+    even on Windows (this uses a separate Windows build that pulls in ffi)
+  - Add support for SSL `ca_path`
+  - Add support for SSL `cert_store`
+  - Add support for SSL `verify_callback` (with some caveats for jruby, OS X, #277)
+  - Add support for SSL ciphers, and choose secure ones by default
+- Run tests under travis
+- Several other bugfixes and test improvements
+  - Convert Errno::ETIMEDOUT to RestClient::RequestTimeout
+  - Handle more HTTP response codes from recent standards
+  - Save raw responses to binary mode tempfile (#110)
+  - Disable timeouts with :timeout => nil rather than :timeout => -1
+  - Drop all Net::HTTP monkey patches
+
+# 1.6.8
+
+- The 1.6.x series will be the last to support Ruby 1.8.7
+- Pin mime-types to < 2.0 to maintain Ruby 1.8.7 support
+- Add Gemfile, AUTHORS, add license to gemspec
+- Point homepage at https://github.com/rest-client/rest-client
+- Clean up and fix various tests and ruby warnings
+- Backport `ssl_verify_callback` functionality from 1.7.0
+
 # 1.6.7
 
 - rebuild with 1.8.7 to avoid https://github.com/rubygems/rubygems/pull/57
@@ -131,4 +193,4 @@ The only breaking change should be the exception classes, but as the new classes
 
 All changes exept the last one should be fully compatible with the previous version.
 
-NOTE: due to a dependency problem and to the last change, heroku users should update their heroku gem to >= 1.5.3 to be able to use this version.
+NOTE: due to a dependency problem and to the last change, heroku users should update their heroku gem to >= 1.5.3 to be able to use this version.