wrest 2.1.9 → 2.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 69a30e75377430e134d3be264b50b1e97e823152
-  data.tar.gz: f721a616192a527d21afa74c0adba3dd3dfd5b41
+  metadata.gz: 74d6752f1e1d310a56a31c8b5d412bc33f4c6405
+  data.tar.gz: 82875275d48826a8154e481982f6e69ccfd60de2
 SHA512:
-  metadata.gz: 94db9fae0c8540e80497fb182b2d8634fbc6fdc8e7fd374fe13931b348244513ffaab8128c76369a92b2fb45bd018cbd7817d6529fc80b4ad5077f085fb47165
-  data.tar.gz: 1e411d00090ff33e317774678a9072b20689862f3e2879715f4b5d95baea7b90459a52d7a0e00e21a85b9ac9922d55305018dcf83d99c21ca0eca04e2d83a4ce
+  metadata.gz: c5c9cbc733ef503e952a52d45db4376fe1513584bccd3fce9c3692f51ebfd2c9dc067026d7c1e42e82cb9664e631f7f336e8b82f2622cc66d034619b1684e7a9
+  data.tar.gz: 9a813bde3499e6fbc91e5782c26bf1b6f185ffdd6bcb384db857756b154d8d6757e063a579ba1a70f40bafaf5ede38e8dbaf18acb0ed8c5c5d9aaa9c4ede05c6

data/CHANGELOG

@@ -2,6 +2,9 @@ Features under the section marked 'Current' are completed but pending release as
 
 Features under a numbered section are complete and available in the Wrest gem.
 
+== 2.2.0
+ * Add support for HTTP PATCH [Aditi Raveesh]
+
 == 2.1.9
  * Switch to using concurrent-ruby
 

data/README.md

@@ -1,15 +1,14 @@
 [![Build Status](https://travis-ci.org/c42/wrest.svg?branch=master)](https://travis-ci.org/c42/wrest)
 
-# Wrest 2.1.9
+# Wrest 2.2.0
 
 (c) Copyright 2009-2016 [Sidu Ponnappa](http://twitter.com/ponnappa). All Rights Reserved.
 
-Wrest is a ruby REST/HTTP client library which
+Wrest is a ruby REST/HTTP client library. It is currently in use at substantial scale across all Ruby/JRuby systems at [GO-JEK](https://twitter.com/GojekTech).
 
-* Allows you to use Net::HTTP
-* Allows you to pick your Ruby: use 2.x.x, JRuby 9.x.x
+* Allows you to pick your Ruby: use CRuby or JRuby
 * Supports RFC 2616 based [caching](https://github.com/kaiwren/wrest/blob/caching/Caching.markdown)
-* Async http calls using Threads (reliable only on JRuby) or EventMachine
+* Async http calls using Threads (truly useful only on JRuby due to [GIL](https://en.wikipedia.org/wiki/Global_interpreter_lock) limitations on CRuby) or EventMachine
 * Allows you to quickly build object oriented wrappers around any web service
 * Is designed to be used as a library, not just a command line REST client (fewer class/static methods, more object oriented)
 * Is spec driven, strongly favours immutable objects and avoids class methods and setters making it better suited for use as a library, especially in multi-threaded environments
@@ -17,7 +16,7 @@ Wrest is a ruby REST/HTTP client library which
 
 To receive notifications whenever new features are added to Wrest, please subscribe to my [twitter feed](http://twitter.com/ponnappa).
 
-##Examples
+## Examples
 
 For Facebook, Twitter, Delicious, GitHub and other API examples, see http://github.com/c42/wrest/tree/master/examples
 
@@ -37,7 +36,7 @@ For Facebook, Twitter, Delicious, GitHub and other API examples, see http://gith
 * Timeout support
 
     ```
-    'https://api.github.com/repos/c42/wrest/issues'.to_uri.get(timeout: 5).body
+    'https://api.github.com/repos/c42/wrest/issues'.to_uri(timeout: 5).get.body
     ```
 
 * Redirect support
@@ -137,7 +136,7 @@ Wrest supports caching with the following pluggable back-ends:
   - Memcached
   - Redis
 
-####Hash
+#### Hash
 
 Use the following method to enable caching for all requests, and set Hash as the default cache store.
 Note: Hash should NEVER be used in a production environment. It is unbounded and will keep increasing in size.
@@ -153,7 +152,7 @@ To use Hash as a cache store in an explicit request (without setting hash as def
     r1 = "http://c42.in".to_uri.using_hash.get
 ```
 
-####Memcached
+#### Memcached
 
 A Memcached based caching back-end is available in Wrest. You can get instructions on how to install Memcached on your system [here](http://code.google.com/p/memcached/wiki/NewInstallFromPackage).
 The Dalli gem is used by Wrest to interface with Memcached. Install dalli using 'gem install dalli'.
@@ -171,7 +170,7 @@ To use Memcached as a cache store in an explicit request (without setting memcac
     r2 = "http://c42.in".to_uri.using_memcached.get
 ```
 
-####Redis
+#### Redis
 
 Wrest also supports a Redis based caching back-end. Follow the guide [here](http://redis.io/topics/quickstart) to install Redis in your system.
 It uses [redis-rd](https://github.com/redis/redis-rb) to interface with Redis. Install redis-rb using `gem install redis`.
@@ -396,24 +395,31 @@ You can launch the interactive Wrest shell by running bin/wrest if you have the
 
 Start the Sinatra test server for functional test. The dependencies for the test app are managed separately by a Gemfile under spec/sample_app.
 
+To start the sample application:
+
 ```
-  rake -f spec/sample_app/Rakefile  # runs on port 3000
+  cd spec/sample_app
+  bundle install
+  bundle exec rake  # runs sample app on port 3000
 ```
 
-Start a memcached daemon/process on port 11211
+Start a memcached daemon/process on port 11211 and redis on 6379 (both default ports)
 
 ```
-  /usr/local/bin/memcached
+  brew install memcached
+  brew install redis
+  brew services start memcached
+  brew services start redis
 ```
 
 Run the tests in a different terminal:
 
 ```
   # Run the normal test suite.
-  rake
+  bundle exec rake
 
   # Runs the functional test suite.
-  rake rspec:functional
+  bundle exec rake rspec:functional
 ```
 
 ## Contributors

data/lib/wrest/native.rb

@@ -24,6 +24,7 @@ require "wrest/native/redirection"
 require "wrest/native/request"
 require "wrest/native/get"
 require "wrest/native/put"
+require "wrest/native/patch"
 require "wrest/native/post"
 require "wrest/native/delete"
 require "wrest/native/options"

data/lib/wrest/native/patch.rb

@@ -0,0 +1,23 @@
+# Copyright 2009 Sidu Ponnappa
+
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0
+# Unless required by applicable law or agreed to in writing, software distributed under the License
+# is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and limitations under the License.
+
+module Wrest::Native
+  class Patch < Request
+    def initialize(wrest_uri, body = '', headers = {}, parameters = {}, options = {})
+      super(
+        wrest_uri,
+        Net::HTTP::Patch,
+        parameters,
+        body,
+        headers,
+        options
+      )
+    end
+  end
+end

data/lib/wrest/uri.rb

@@ -115,6 +115,11 @@ module Wrest #:nodoc:
     def build_put(body = '', headers = {}, parameters = {}, &block)
       Http::Put.new(self, body.to_s, default_headers.merge(headers), parameters, block ? @options.merge(:callback_block => block) : @options)
     end
+
+    #:nodoc:
+    def build_patch(body = '', headers = {}, parameters = {}, &block)
+      Http::Patch.new(self, body.to_s, default_headers.merge(headers), parameters, block ? @options.merge(:callback_block => block) : @options)
+    end
     
     #:nodoc:
     def build_post(body = '', headers = {}, parameters = {}, &block)
@@ -171,6 +176,24 @@ module Wrest #:nodoc:
       @asynchronous_backend.execute(build_put(body, headers, parameters, &block))
     end
 
+    # Make a PATCH request to this URI. This is a convenience API
+    # that creates a Wrest::Native::Patch, executes it and returns a Wrest::Native::Response.
+    #
+    # Remember to escape all parameter strings if necessary, using URI.escape
+    def patch(body = '', headers = {}, parameters = {}, &block)
+      build_patch(body, headers, parameters, &block).invoke
+    end
+
+    # Make a PATCH request to this URI. This is a convenience API
+    # that creates a Wrest::Native::Patch.
+    #
+    # Remember to escape all parameter strings if necessary, using URI.escape
+    #
+    # Note: patch_async does not return a response and the response should be accessed through callbacks.
+    def patch_async(body = '', headers = {}, parameters = {}, &block)
+      @asynchronous_backend.execute(build_patch(body, headers, parameters, &block))
+    end
+
     # Makes a POST request to this URI. This is a convenience API
     # that creates a Wrest::Native::Post, executes it and returns a Wrest::Native::Response.
     #

data/lib/wrest/version.rb

@@ -8,5 +8,5 @@
 # See the License for the specific language governing permissions and limitations under the License.
 
 module Wrest
-  VERSION = "2.1.9"
+  VERSION = "2.2.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: wrest
 version: !ruby/object:Gem::Version
-  version: 2.1.9
+  version: 2.2.0
 platform: ruby
 authors:
 - Sidu Ponnappa
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-01-13 00:00:00.000000000 Z
+date: 2017-04-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec
@@ -39,20 +39,6 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: 1.0.0
-- !ruby/object:Gem::Dependency
-  name: metric_fu
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
 - !ruby/object:Gem::Dependency
   name: activesupport
   requirement: !ruby/object:Gem::Requirement
@@ -127,7 +113,7 @@ description: Wrest is a fluent, easy-to-use, object oriented Ruby HTTP/REST clie
   library with support for RFC2616 HTTP caching, multiple HTTP backends and async
   calls. It runs on CRuby and JRuby and is in production use at substantial scale.
 email:
-- sidu@c42.in
+- ckponnappa@gmail.com
 executables:
 - wrest
 extensions: []
@@ -180,6 +166,7 @@ files:
 - lib/wrest/native/delete.rb
 - lib/wrest/native/get.rb
 - lib/wrest/native/options.rb
+- lib/wrest/native/patch.rb
 - lib/wrest/native/post.rb
 - lib/wrest/native/post_multipart.rb
 - lib/wrest/native/put.rb
@@ -204,7 +191,7 @@ files:
 - lib/wrest/xml_mini/rexml.rb
 - lib/wrest/xml_mini/rexml/xpath_filter.rb
 - lib/wrest_no_ext.rb
-homepage: http://c42.in/open_source
+homepage: https://github.com/gojek-engineering/wrest
 licenses: []
 metadata: {}
 post_install_message: 
@@ -224,14 +211,12 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: 1.3.0
 requirements:
 - To use Memcached as caching back-end, install the 'dalli' gem.
+- To use Redis as caching back-end, install the 'redis' gem.
 - To use multipart post, install the 'multipart-post' gem.
-- To use curl as the http engine, install the 'patron' gem. This feature is not available
-  (and should be unneccessary) on jruby.
 - To use eventmachine as a parallel backend, install the 'eventmachine' gem.
 rubyforge_project: wrest
 rubygems_version: 2.6.8
 signing_key: 
 specification_version: 4
-summary: Wrest is a fluent, object oriented HTTP client library for 2.x.x, JRuby 1.7.6
-  (and higher), JRuby 9.0.0.0.pre2.
+summary: Wrest is a fluent, object oriented HTTP client library for 2.x.x, JRuby 9.x
 test_files: []