RubyGems - rest-client - Versions diffs - 1.6.14 - Mend

rest-client 1.6.14

Potentially problematic release.

This version of rest-client might be problematic. Click here for more details.

Files changed (44) hide show

checksums.yaml +7 -0
data/.gitignore +8 -0
data/.rspec +1 -0
data/.travis.yml +3 -0
data/AUTHORS +75 -0
data/Gemfile +7 -0
data/README.rdoc +300 -0
data/Rakefile +49 -0
data/bin/restclient +93 -0
data/history.md +160 -0
data/lib/rest-client.rb +2 -0
data/lib/rest_client.rb +2 -0
data/lib/restclient.rb +170 -0
data/lib/restclient/abstract_response.rb +106 -0
data/lib/restclient/exceptions.rb +198 -0
data/lib/restclient/net_http_ext.rb +55 -0
data/lib/restclient/payload.rb +240 -0
data/lib/restclient/platform.rb +29 -0
data/lib/restclient/raw_response.rb +34 -0
data/lib/restclient/request.rb +360 -0
data/lib/restclient/resource.rb +169 -0
data/lib/restclient/response.rb +26 -0
data/lib/restclient/version.rb +7 -0
data/rest-client.gemspec +26 -0
data/spec/abstract_response_spec.rb +85 -0
data/spec/base.rb +13 -0
data/spec/exceptions_spec.rb +98 -0
data/spec/integration/capath_digicert/244b5494.0 +19 -0
data/spec/integration/capath_digicert/81b9768f.0 +19 -0
data/spec/integration/capath_digicert/README +8 -0
data/spec/integration/capath_digicert/digicert.crt +19 -0
data/spec/integration/certs/digicert.crt +19 -0
data/spec/integration/certs/verisign.crt +14 -0
data/spec/integration/request_spec.rb +75 -0
data/spec/integration_spec.rb +38 -0
data/spec/master_shake.jpg +0 -0
data/spec/payload_spec.rb +244 -0
data/spec/raw_response_spec.rb +17 -0
data/spec/request2_spec.rb +35 -0
data/spec/request_spec.rb +528 -0
data/spec/resource_spec.rb +136 -0
data/spec/response_spec.rb +169 -0
data/spec/restclient_spec.rb +73 -0
metadata +192 -0

checksums.yaml ADDED

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 317f1bdcf77b2dae0fe9a08a165a56c71fb9c3d79b71c8d6c5a12cb1e4868a4e
+  data.tar.gz: d2a662189817597ff1fca0e6685cdd5d06bdac1ca72bf9a932f1d7def456b26b
+SHA512:
+  metadata.gz: f789e7291285e26aa719119331d0d1a6322ec618a25eb2626a1a8486e3584fb07e52d25dfb7a56972cb495e5e2cad6c67eae5f3da98d66974d51f3c4fc2566f1
+  data.tar.gz: cf43508dbbc1f6977b3e8ad047651591760b8f386e3daa472888fc81f262b3d2669798f847b88fdd7b6f6f77b2a44990688c88efc53e02072bb9f284459c6b41

data/.gitignore ADDED

@@ -0,0 +1,8 @@
+.idea
+.rvmrc
+doc
+rdoc
+pkg
+*.gem
+scratchpad.rb
+/Gemfile.lock

data/.rspec ADDED

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

data/.travis.yml ADDED

@@ -0,0 +1,3 @@
+language: ruby
+rvm:
+  - "1.8.7"

data/AUTHORS ADDED

@@ -0,0 +1,75 @@
+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 Green
+Coda Hale
+Crawford
+Cyril Rohr
+Dan Mayer
+David Backeus
+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
+James Edward Gray II
+Jari Bakken
+Jeff Remer
+JH. Chabran
+John Barnette
+Jon Rowe
+Jordi Massaguer Pla
+Juan Alvarez
+Julien Kirch
+Justin Coyne
+Keith Rarick
+Kenichi Kamiya
+Kevin Read
+Kosuke Asami
+Kyle VanderBeek
+Lars Gierth
+Lawrence Leonard Gilbert
+Lee Jarvis
+Lennon Day-Reynolds
+macournoyer
+Matthew Manning
+Michael Klett
+Mike Fletcher
+Nicholas Wieland
+Nick Plante
+Niko Dittmann
+Oscar Del Ben
+Pablo Astigarraga
+Paul Dlug
+Pedro Belo
+rafael.ssouza
+Philip Corliss
+Rick "technoweenie"
+Robert Eanes
+Rodrigo Panachi
+Syl Turner
+T. Watanabe
+Tekin
+tpresa
+W. Andrew Loe III
+Waynn Lue

data/Gemfile ADDED

@@ -0,0 +1,7 @@
+source "https://rubygems.org"
+gemspec
+group :test do
+  gem 'rake'
+end

data/README.rdoc ADDED

@@ -0,0 +1,300 @@
+= REST Client -- simple DSL for accessing HTTP and REST resources
+Build status: {<img src="https://travis-ci.org/rest-client/rest-client.svg?branch=1.6-legacy" 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: https://github.com/rest-client/rest-client
+* Mailing list: rest.client@librelist.com (send a mail to subscribe).
+== Usage: Raw URL
+  require 'rest_client'
+  RestClient.get 'http://example.com/resource'
+  RestClient.get 'http://example.com/resource', {:params => {:id => 50, 'foo' => 'bar'}}
+  RestClient.get 'https://user:password@example.com/private/resource', {:accept => :json}
+  RestClient.post 'http://example.com/resource', :param1 => 'one', :nested => { :param2 => 'two' }
+  RestClient.post "http://example.com/resource", { 'x' => 1 }.to_json, :content_type => :json, :accept => :json
+  RestClient.delete 'http://example.com/resource'
+  response = RestClient.get 'http://example.com/resource'
+  response.code
+  ➔ 200
+  response.cookies
+  ➔ {"Foo"=>"BAR", "QUUX"=>"QUUUUX"}
+  response.headers
+  ➔ {:content_type=>"text/html; charset=utf-8", :cache_control=>"private" ...
+  response.to_str
+  ➔ \n<!DOCTYPE html PUBLIC \"-//W3C//DTD HTML 4.01//EN\"\n   \"http://www.w3.org/TR/html4/strict.dtd\">\n\n<html ....
+  RestClient.post( url,
+    {
+      :transfer => {
+        :path => '/foo/bar',
+        :owner => 'that_guy',
+        :group => 'those_guys'
+      },
+       :upload => {
+        :file => File.new(path, 'rb')
+      }
+    })
+== Multipart
+Yeah, that's right!  This does multipart sends for you!
+  RestClient.post '/data', :myfile => File.new("/path/to/image.jpg", 'rb')
+This does two things for you:
+* Auto-detects that you have a File value sends it as multipart
+* Auto-detects the mime of the file and sets it in the HEAD of the payload for each entry
+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
+== Usage: ActiveResource-Style
+  resource = RestClient::Resource.new 'http://example.com/resource'
+  resource.get
+  private_resource = RestClient::Resource.new 'https://example.com/private/resource', 'user', 'pass'
+  private_resource.put File.read('pic.jpg'), :content_type => 'image/jpg'
+See RestClient::Resource module docs for details.
+== Usage: Resource Nesting
+  site = RestClient::Resource.new('http://example.com')
+  site['posts/1/comments'].post 'Good article.', :content_type => 'text/plain'
+See RestClient::Resource docs for details.
+== Exceptions (see http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html)
+* 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
+   begin
+     RestClient.get 'http://example.com/resource'
+   rescue => e
+     e.response
+   end
+   ➔ 404 Resource Not Found | text/html 282 bytes
+== Result handling
+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
+  RestClient.get('http://example.com/resource'){|response, request, result| response }
+  ➔ 404 Resource Not Found | text/html 282 bytes
+  # Manage a specific error code
+  RestClient.get('http://my-rest-service.com/resource'){ |response, request, result, &block|
+    case response.code
+    when 200
+      p "It worked !"
+      response
+    when 423
+      raise SomeCustomExceptionIfYouWant
+    else
+      response.return!(request, result, &block)
+    end
+  }
+  # Follow redirections for all request types and not only for get and head
+  # RFC : "If the 301, 302 or 307 status code is received in response to a request other than GET or HEAD,
+  #        the user agent MUST NOT automatically redirect the request unless it can be confirmed by the user,
+  #        since this might change the conditions under which the request was issued."
+  RestClient.get('http://my-rest-service.com/resource'){ |response, request, result, &block|
+    if [301, 302, 307].include? response.code
+      response.follow_redirection(request, result, &block)
+    else
+      response.return!(request, result, &block)
+    end
+  }
+== Non-normalized URIs
+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 provides a lower-level API.
+You can:
+* specify ssl parameters
+* override cookies
+* manually handle the response (e.g. to operate on it as a stream rather than reading it all into memory)
+See RestClient::Request's documentation for more information.
+== Shell
+The restclient shell command gives an IRB session with RestClient already loaded:
+  $ restclient
+  >> RestClient.get 'http://example.com'
+Specify a URL argument for get/post/put/delete on that resource:
+  $ restclient http://example.com
+  >> put '/resource', 'data'
+Add a user and password for authenticated resources:
+  $ restclient https://example.com user pass
+  >> delete '/private/resource'
+Create ~/.restclient for named sessions:
+  sinatra:
+    url: http://localhost:4567
+  rack:
+    url: http://localhost:9292
+  private_site:
+    url: http://example.com
+    username: user
+    password: pass
+Then invoke:
+  $ restclient private_site
+Use as a one-off, curl-style:
+  $ restclient get http://example.com/resource > output_body
+  $ restclient put http://example.com/resource < input_body
+== Logging
+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"):
+   $ RESTCLIENT_LOG=stdout path/to/my/program
+Either produces logs like this:
+  RestClient.get "http://some/resource"
+  # => 200 OK | text/html 250 bytes
+  RestClient.put "http://some/resource", "payload"
+  # => 401 Unauthorized | application/xml 340 bytes
+Note that these logs are valid Ruby, so you can paste them into the restclient
+shell or a script to replay your sequence of rest calls.
+== Proxy
+All calls to RestClient, including Resources, will use the proxy specified by
+RestClient.proxy:
+  RestClient.proxy = "http://proxy.example.com/"
+  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
+use whatever proxy the system is configured to use:
+  RestClient.proxy = ENV['http_proxy']
+== Query parameters
+Request objects know about query parameters and will automatically add them to
+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
+== Cookies
+Request and Response objects know about HTTP cookies, and will automatically
+extract and set headers for them as needed:
+  response = RestClient.get 'http://example.com/action_which_sets_session_id'
+  response.cookies
+  # => {"_applicatioN_session_id" => "1234"}
+  response2 = RestClient.post(
+    'http://localhost:3000/',
+    {:param1 => "foo"},
+    {:cookies => {:session_id => "1234"}}
+  )
+  # ...response body
+== SSL Client Certificates
+  RestClient::Resource.new(
+    'https://example.com',
+    :ssl_client_cert  =>  OpenSSL::X509::Certificate.new(File.read("cert.pem")),
+    :ssl_client_key   =>  OpenSSL::PKey::RSA.new(File.read("key.pem"), "passphrase, if any"),
+    :ssl_ca_file      =>  "ca_certificate.pem",
+    :verify_ssl       =>  OpenSSL::SSL::VERIFY_PEER
+  ).get
+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 direct access to the HTTP request.
+Example:
+  # Add oauth support using the oauth gem
+  require 'oauth'
+  access_token = ...
+  RestClient.add_before_execution_proc do |req, params|
+    access_token.sign! req
+  end
+  RestClient.get 'http://example.com'
+== More
+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
+== Credits
+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/)

data/Rakefile ADDED

@@ -0,0 +1,49 @@
+begin
+  # optionally load `rake build/install/release tasks'
+  require 'bundler/gem_tasks'
+rescue LoadError
+end
+require "rspec/core/rake_task"
+desc "Run all specs"
+task :spec => ["spec:unit", "spec:integration"]
+desc "Run unit specs"
+RSpec::Core::RakeTask.new('spec:unit') do |t|
+  t.pattern = ['spec/*_spec.rb']
+end
+desc "Run integration specs"
+RSpec::Core::RakeTask.new('spec:integration') do |t|
+  t.pattern = ['spec/integration/*_spec.rb']
+end
+desc "Print specdocs"
+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"
+RSpec::Core::RakeTask.new('rcov') do |t|
+  t.pattern = ['spec/*_spec.rb']
+  t.rcov = true
+  t.rcov_opts = ['--exclude', 'examples']
+end
+task :default => :spec
+############################
+require 'rdoc/task'
+Rake::RDocTask.new do |t|
+  t.rdoc_dir = 'rdoc'
+  t.title    = "rest-client, fetch RESTful resources effortlessly"
+  t.options << '--line-numbers' << '--inline-source' << '-A cattr_accessor=object'
+  t.options << '--charset' << 'utf-8'
+  t.rdoc_files.include('README.rdoc')
+  t.rdoc_files.include('lib/*.rb')
+end