wrest 1.5.3 → 1.5.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: af75d10ad96bd8e0539620594008b533d1d19a1a
-  data.tar.gz: 5760c9925189879d52eb6a83c599fcac4788f700
+  metadata.gz: c2ef12f85a25ae1566e9dc1b687a364d765f6a08
+  data.tar.gz: fb83d920f115473b271d16cad06195fb73524d00
 SHA512:
-  metadata.gz: e566458f7d00c59cda57695f0d8b55bc16d06d27e10d6980837584dbf184a7a74167e10644ba3b4c444d1073d0eaf8a9686cd51cda89a6825e2e13d4997a3edd
-  data.tar.gz: d1571b4cb17d98827dc391e616755d5e55d07c47da244fa09e5690c0dff1ac85a3f4480da7d46b856deecf598830363fbb48619bd3310fcdd6a952dfec45616e
+  metadata.gz: a88c38044cafcad5a161e4fd974b8023600c830865f1734451a5e948720d647b828f73caeca7b89ef008b6f8c472c44e2a05cc8b4602458939280427dd7121ab
+  data.tar.gz: baff6d4f993a61763836866bd838b0517c802aaa1547593aeb07b92c5a599defa77a70db5616e2e3bdacec48b343c4c78f1513990e4bb1727d537d69f5a17688

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.
 
+== 1.5.4
+ * Make thread pool configurable
+
 == 1.5.3
  * Implemented a thread pool for async requests using ThreadBackend
  * Updated request/response logging to include current thread id

data/README.md

@@ -1,6 +1,6 @@
 [![Build Status](https://travis-ci.org/c42/wrest.svg?branch=master)](https://travis-ci.org/c42/wrest)
 
-# Wrest 1.5.3
+# Wrest 1.5.4
 
 (c) Copyright 2009-2015 [Sidu Ponnappa](http://twitter.com/ponnappa). All Rights Reserved.
 
@@ -9,10 +9,7 @@ Wrest is a ruby REST/HTTP client library which
 * Allows you to use Net::HTTP or libCurl
 * Allows you to pick your Ruby: use 2.x.x, JRuby 1.7.6 (and higher), JRuby 9.0.0.0.pre2
 * Supports RFC 2616 based [caching](https://github.com/kaiwren/wrest/blob/caching/Caching.markdown)
-* **_Alpha_**
-
-      Allows you to go async: use Threads or EventMachine
-
+* Async http calls using Threads (reliable only on JRuby) 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
@@ -31,15 +28,16 @@ For Facebook, Twitter, Delicious, GitHub and other API examples, see http://gith
 * Basic API calls
 
     ```
-    'http://twitter.com/statuses/public_timeline.json'.to_uri.get.deserialise  # works with json and xml out of the box
-
-    'http://twitter.com/statuses/public_timeline.xml'.to_uri.get.deserialise   # see lib/wrest/components/translators to add other formats
+    # Works with json and xml out of the box
+    # See lib/wrest/components/translators to add other formats
+    
+    'https://api.github.com/repos/c42/wrest/issues'.to_uri.get.deserialize
     ```
 
 * Timeout support
 
     ```
-    'http://twitter.com/statuses/public_timeline.json'.to_uri.get(:timeout => 5).body
+    'https://api.github.com/repos/c42/wrest/issues'.to_uri.get(:timeout => 5).body
     ```
 
 * Redirect support
@@ -217,11 +215,15 @@ Asynchronous requests support pluggable backends. The default backend used for a
   Wrest::AsyncRequest.wait_for_thread_pool!
 ```
 
-You can change the default to eventmachine.
+You can change the default to eventmachine or to threads.
 
 ```
   Wrest::AsyncRequest.default_to_em!
 ```
+or
+```
+  Wrest::AsyncRequest.default_to_threads!
+```
 
 You can also override the default on Uri objects.
 
@@ -233,7 +235,16 @@ You can also override the default on Uri objects.
   end
 ```
 
-Note: The current implementation of asynchronous requests is currently in alpha and should not be used in production.
+You can decide which AsyncBackend to use at runtime through to `to_uri`'s options hash.
+
+```
+  "http://c42.in".to_uri(asynchronous_backend: ThreadBackend.new(number_of_threads)).get_async do |callback|
+    callback.on_ok do |response|
+      Wrest.logger.info "Ok."
+    end
+  end
+```
+
 
 ### Other useful stuff
 

data/lib/wrest/async_request.rb

@@ -27,8 +27,8 @@ module Wrest
     end
 
     # Assign default backend for asynchronous request to using threads. 
-    def self.default_to_threads!
-      self.default_backend = Wrest::AsyncRequest::ThreadBackend.new
+    def self.default_to_threads!(number_of_threads = 5)
+      self.default_backend = Wrest::AsyncRequest::ThreadBackend.new(number_of_threads)
     end
 
     # Returns the default backend, which is the ThreadBackend

data/lib/wrest/async_request/thread_pool.rb

@@ -14,12 +14,10 @@ module Wrest
         @threads = []
         @number_of_threads = number_of_threads
         @queue = Queue.new
-        halt_on_sigint
-        halt_on_int
-        initialize_thread_pool
       end
       
       def execute_eventually(request)
+        initialize_thread_pool if @threads.empty?
         @queue.push(request)
         nil
       end
@@ -32,6 +30,8 @@ module Wrest
       
       private
       def initialize_thread_pool
+        halt_on_sigint
+        halt_on_int
         main_thread = Thread.current
         @threads =  @number_of_threads.times.map do |i|
           Thread.new do |thread|
@@ -55,9 +55,11 @@ module Wrest
       end
     
       def halt
-        Wrest.logger.debug "Shutting down ThreadPool..."
-        @threads.each(&:terminate)
-        Wrest.logger.debug "Halted ThreadPool, continuing with shutdown..."
+        unless @threads.empty?
+          Wrest.logger.debug "Wrest: Shutting down ThreadPool..."
+          @threads.each(&:terminate)
+          Wrest.logger.debug "Wrest: Halted ThreadPool, continuing with shutdown."
+        end
         Process.exit
       end
     end

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 = "1.5.3"
+  VERSION = "1.5.4"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: wrest
 version: !ruby/object:Gem::Version
-  version: 1.5.3
+  version: 1.5.4
 platform: ruby
 authors:
 - Sidu Ponnappa
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-08-04 00:00:00.000000000 Z
+date: 2015-08-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec