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

rest-client 1.6.14 → 2.0.2

Files changed (65) hide show

checksums.yaml +5 -5
data/.gitignore +6 -6
data/.rspec +2 -1
data/.rubocop-disables.yml +384 -0
data/.rubocop.yml +3 -0
data/.travis.yml +46 -1
data/AUTHORS +28 -5
data/Gemfile +5 -1
data/LICENSE +21 -0
data/README.md +784 -0
data/Rakefile +95 -12
data/bin/restclient +11 -12
data/history.md +180 -16
data/lib/restclient.rb +25 -11
data/lib/restclient/abstract_response.rb +171 -51
data/lib/restclient/exceptions.rb +102 -56
data/lib/restclient/params_array.rb +72 -0
data/lib/restclient/payload.rb +43 -74
data/lib/restclient/platform.rb +22 -2
data/lib/restclient/raw_response.rb +7 -3
data/lib/restclient/request.rb +672 -179
data/lib/restclient/resource.rb +6 -7
data/lib/restclient/response.rb +64 -10
data/lib/restclient/utils.rb +235 -0
data/lib/restclient/version.rb +2 -1
data/lib/restclient/windows.rb +8 -0
data/lib/restclient/windows/root_certs.rb +105 -0
data/rest-client.gemspec +16 -11
data/rest-client.windows.gemspec +19 -0
data/spec/helpers.rb +22 -0
data/spec/integration/_lib.rb +1 -0
data/spec/integration/capath_verisign/415660c1.0 +14 -0
data/spec/integration/capath_verisign/7651b327.0 +14 -0
data/spec/integration/capath_verisign/README +8 -0
data/spec/integration/capath_verisign/verisign.crt +14 -0
data/spec/integration/httpbin_spec.rb +87 -0
data/spec/integration/integration_spec.rb +125 -0
data/spec/integration/request_spec.rb +72 -20
data/spec/spec_helper.rb +29 -0
data/spec/unit/_lib.rb +1 -0
data/spec/unit/abstract_response_spec.rb +145 -0
data/spec/unit/exceptions_spec.rb +108 -0
data/spec/{master_shake.jpg → unit/master_shake.jpg} +0 -0
data/spec/unit/params_array_spec.rb +36 -0
data/spec/{payload_spec.rb → unit/payload_spec.rb} +73 -54
data/spec/{raw_response_spec.rb → unit/raw_response_spec.rb} +5 -4
data/spec/unit/request2_spec.rb +54 -0
data/spec/unit/request_spec.rb +1250 -0
data/spec/unit/resource_spec.rb +134 -0
data/spec/unit/response_spec.rb +241 -0
data/spec/unit/restclient_spec.rb +79 -0
data/spec/unit/utils_spec.rb +147 -0
data/spec/unit/windows/root_certs_spec.rb +22 -0
metadata +143 -53
data/README.rdoc +0 -300
data/lib/restclient/net_http_ext.rb +0 -55
data/spec/abstract_response_spec.rb +0 -85
data/spec/base.rb +0 -13
data/spec/exceptions_spec.rb +0 -98
data/spec/integration_spec.rb +0 -38
data/spec/request2_spec.rb +0 -35
data/spec/request_spec.rb +0 -528
data/spec/resource_spec.rb +0 -136
data/spec/response_spec.rb +0 -169
data/spec/restclient_spec.rb +0 -73

data/README.rdoc DELETED

@@ -1,300 +0,0 @@
-= 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/lib/restclient/net_http_ext.rb DELETED

@@ -1,55 +0,0 @@
-module Net
-  class HTTP
-  # Adding the patch method if it doesn't exist (rest-client issue: https://github.com/archiloque/rest-client/issues/79)
-  if !defined?(Net::HTTP::Patch)
-    # Code taken from this commit: https://github.com/ruby/ruby/commit/ab70e53ac3b5102d4ecbe8f38d4f76afad29d37d#lib/net/http.rb
-    class Protocol
-      # Sends a PATCH request to the +path+ and gets a response,
-      # as an HTTPResponse object.
-      def patch(path, data, initheader = nil, dest = nil, &block) # :yield: +body_segment+
-        send_entity(path, data, initheader, dest, Patch, &block)
-      end
-      # Executes a request which uses a representation
-      # and returns its body.
-      def send_entity(path, data, initheader, dest, type, &block)
-        res = nil
-        request(type.new(path, initheader), data) {|r|
-          r.read_body dest, &block
-          res = r
-        }
-        unless @newimpl
-          res.value
-          return res, res.body
-        end
-        res
-      end
-    end
-    class Patch < HTTPRequest
-      METHOD = 'PATCH'
-      REQUEST_HAS_BODY = true
-      RESPONSE_HAS_BODY = true
-    end
-  end
-    #
-    # Replace the request method in Net::HTTP to sniff the body type
-    # and set the stream if appropriate
-    #
-    # Taken from:
-    # http://www.missiondata.com/blog/ruby/29/streaming-data-to-s3-with-ruby/
-    alias __request__ request
-    def request(req, body=nil, &block)
-      if body != nil && body.respond_to?(:read)
-        req.body_stream = body
-        return __request__(req, nil, &block)
-      else
-        return __request__(req, body, &block)
-      end
-    end
-  end
-end

data/spec/abstract_response_spec.rb DELETED

@@ -1,85 +0,0 @@
-require File.join( File.dirname(File.expand_path(__FILE__)), 'base')
-describe RestClient::AbstractResponse do
-  class MyAbstractResponse
-    include RestClient::AbstractResponse
-    attr_accessor :size
-    def initialize net_http_res, args
-      @net_http_res = net_http_res
-      @args = args
-    end
-  end
-  before do
-    @net_http_res = double('net http response')
-    @response = MyAbstractResponse.new(@net_http_res, {})
-  end
-  it "fetches the numeric response code" do
-    @net_http_res.should_receive(:code).and_return('200')
-    @response.code.should eq 200
-  end
-  it "has a nice description" do
-    @net_http_res.should_receive(:to_hash).and_return({'Content-Type' => ['application/pdf']})
-    @net_http_res.should_receive(:code).and_return('200')
-    @response.description.should eq "200 OK | application/pdf  bytes\n"
-  end
-  it "beautifies the headers by turning the keys to symbols" do
-    h = RestClient::AbstractResponse.beautify_headers('content-type' => [ 'x' ])
-    h.keys.first.should eq :content_type
-  end
-  it "beautifies the headers by turning the values to strings instead of one-element arrays" do
-    h = RestClient::AbstractResponse.beautify_headers('x' => [ 'text/html' ] )
-    h.values.first.should eq 'text/html'
-  end
-  it "fetches the headers" do
-    @net_http_res.should_receive(:to_hash).and_return('content-type' => [ 'text/html' ])
-    @response.headers.should eq({ :content_type => 'text/html' })
-  end
-  it "extracts cookies from response headers" do
-    @net_http_res.should_receive(:to_hash).and_return('set-cookie' => ['session_id=1; path=/'])
-    @response.cookies.should eq({ 'session_id' => '1' })
-  end
-  it "extract strange cookies" do
-    @net_http_res.should_receive(:to_hash).and_return('set-cookie' => ['session_id=ZJ/HQVH6YE+rVkTpn0zvTQ==; path=/'])
-    @response.cookies.should eq({ 'session_id' => 'ZJ%2FHQVH6YE+rVkTpn0zvTQ%3D%3D' })
-  end
-  it "doesn't escape cookies" do
-    @net_http_res.should_receive(:to_hash).and_return('set-cookie' => ['session_id=BAh7BzoNYXBwX25hbWUiEGFwcGxpY2F0aW9uOgpsb2dpbiIKYWRtaW4%3D%0A--08114ba654f17c04d20dcc5228ec672508f738ca; path=/'])
-    @response.cookies.should eq({ 'session_id' => 'BAh7BzoNYXBwX25hbWUiEGFwcGxpY2F0aW9uOgpsb2dpbiIKYWRtaW4%3D%0A--08114ba654f17c04d20dcc5228ec672508f738ca' })
-  end
-  it "can access the net http result directly" do
-    @response.net_http_res.should eq @net_http_res
-  end
-  describe "#return!" do
-    it "should return the response itself on 200-codes" do
-      @net_http_res.should_receive(:code).and_return('200')
-      @response.return!.should be_equal(@response)
-    end
-    it "should raise RequestFailed on unknown codes" do
-      @net_http_res.should_receive(:code).and_return('1000')
-      lambda { @response.return! }.should raise_error RestClient::RequestFailed
-    end
-    it "should raise an error on a redirection after non-GET/HEAD requests" do
-      @net_http_res.should_receive(:code).and_return('301')
-      @response.args.merge(:method => :put)
-      lambda { @response.return! }.should raise_error RestClient::RequestFailed
-    end
-  end
-end

data/spec/base.rb DELETED

@@ -1,13 +0,0 @@
-def is_ruby_19?
-  RUBY_VERSION > '1.9'
-end
-require 'rubygems'
-begin
-  require "ruby-debug"
-rescue LoadError
-  # NOP, ignore
-end
-require File.dirname(__FILE__) + '/../lib/restclient'