rest-core 3.5.7 → 3.5.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 92e289bb3e825b93385443dade7adf26959b90b8
-  data.tar.gz: 5861deec728b6d154f582702c5b2643ad7797b07
+  metadata.gz: 23c11f1f962e09fd0bbb320ca71d7f74618dd79a
+  data.tar.gz: c9a39501f38e887d9a8ce115bd3280ac4151d253
 SHA512:
-  metadata.gz: 6a33744abd434667196c62f2066c0fecfa0315d0d397239964d16d13d7726cd94d0aa98dc3581924e84912decbb6f32040106d42cdeaafd5b962d3ba75382c94
-  data.tar.gz: d6f3fe16efe1d82931cbb88cd9053509e2ca064e7d693365d963c5aefe154ef04e8e08d154aa3b79c4f4f3035e3795c6e14022d526a03a9624cdeff84e5e06c1
+  metadata.gz: 889495dc4261d1ae0dea20a0d821e5320053083c12c830508a17574dbf8a42fd1413ed5a7d83f3f396ed70c04df050b143e8c48f9f2d6e76982f1ac79382ffa1
+  data.tar.gz: e90f5213c0a9a4e0517b5ced5bf970c31793334c4224e47ab684c4a9ed29f06bb29699f55743dd7d689d8e22838a48e567b291cbcbfc7d6bed7299f0b6bdbd70

data/.travis.yml

@@ -1,11 +1,19 @@
-
+sudo: false
 language: ruby
 rvm:
   - 2.0
   - 2.1
   - 2.2
-  - rbx-2
-  - jruby
+  - rbx
+  - jruby-9
 
+before_install:
+  - rvm get head
+  - rvm reload
+  - rvm use --install $TRAVIS_RUBY_VERSION --binary --latest
 install: 'bundle install --retry=3'
-script: 'ruby -r bundler/setup -S rake test'
+script: 'ruby -vr bundler/setup -S rake test'
+
+matrix:
+  allow_failures:
+    - rvm: rbx

data/CHANGES.md

@@ -1,5 +1,11 @@
 # CHANGES
 
+## rest-core 3.5.8 -- 2015-12-07
+
+### Enhancements
+
+* Added `Client.defer` for doing arbitrary asynchronous tasks.
+
 ## rest-core 3.5.7 -- 2015-09-10
 
 ### Incompatible changes

data/README.md

@@ -246,6 +246,22 @@ end
 
 If you're using unicorn, you probably want to put that in the config.
 
+### Random Asynchronous Tasks
+
+Occasionally we might want to do some asynchronous tasks which could take
+the advantage of the concurrency facilities inside rest-core, for example,
+using `wait` and `shutdown`. You could do this with `defer` for a particular
+client. Still take `RC::Universal` as an example:
+
+``` ruby
+RC::Universal.defer do
+  sleep(1)
+  puts "Slow task done"
+end
+
+RC::Universal.wait
+```
+
 ### Persistent connections (keep-alive connections)
 
 Since we're using [httpclient][] by default now, we would reuse connections,

data/lib/rest-core/builder.rb

@@ -1,5 +1,6 @@
 
 require 'thread'
+require 'weakref'
 require 'rest-core/client'
 
 class RestCore::Builder
@@ -104,6 +105,20 @@ class RestCore::Builder
 
       def thread_pool; RestCore::ThreadPool[self]; end
 
+      def defer
+        raise ArgumentError.new('no block given') unless block_given?
+        promise = RestCore::Promise.new(RestCore::CLIENT => self)
+        give_promise(WeakRef.new(promise))
+        promise.defer do
+          begin
+            yield
+          ensure
+            promise.done
+          end
+        end
+        promise
+      end
+
       def give_promise weak_promise, ps=promises, m=mutex
         m.synchronize do
           ps << weak_promise

data/lib/rest-core/client.rb

@@ -211,7 +211,7 @@ module RestCore::Client
   private
   def request_complete res
     if err = res[FAIL].find{ |f| f.kind_of?(Exception) }
-      RC::Promise.set_backtrace(err) unless err.backtrace
+      Promise.set_backtrace(err) unless err.backtrace
       error_callback.call(err) if error_callback
       if res[ASYNC]
         res.merge(response_key(res) => err)

data/lib/rest-core/promise.rb

@@ -118,6 +118,11 @@ class RestCore::Promise
     self
   end
 
+  # called in Client.defer to mark this promise as done
+  def done
+    fulfill('', 0, {})
+  end
+
   # It's considered done only if the HTTP request is done, and we're not
   # in asynchronous mode otherwise the callback should be called first.
   # For synchronous mode, since we're waiting for the callback anyway,

data/lib/rest-core/version.rb

@@ -1,4 +1,4 @@
 
 module RestCore
-  VERSION = '3.5.7'
+  VERSION = '3.5.8'
 end

data/rest-core.gemspec

@@ -1,14 +1,14 @@
 # -*- encoding: utf-8 -*-
-# stub: rest-core 3.5.7 ruby lib
+# stub: rest-core 3.5.8 ruby lib
 
 Gem::Specification.new do |s|
   s.name = "rest-core"
-  s.version = "3.5.7"
+  s.version = "3.5.8"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.require_paths = ["lib"]
   s.authors = ["Lin Jen-Shin (godfat)"]
-  s.date = "2015-09-10"
+  s.date = "2015-12-07"
   s.description = "Modular Ruby clients interface for REST APIs.\n\nThere has been an explosion in the number of REST APIs available today.\nTo address the need for a way to access these APIs easily and elegantly,\nwe have developed rest-core, which consists of composable middleware\nthat allows you to build a REST client for any REST API. Or in the case of\ncommon APIs such as Facebook, Github, and Twitter, you can simply use the\ndedicated clients provided by [rest-more][].\n\n[rest-more]: https://github.com/godfat/rest-more"
   s.email = ["godfat (XD) godfat.org"]
   s.files = [
@@ -113,7 +113,7 @@ Gem::Specification.new do |s|
   "test/test_universal.rb"]
   s.homepage = "https://github.com/godfat/rest-core"
   s.licenses = ["Apache License 2.0"]
-  s.rubygems_version = "2.4.8"
+  s.rubygems_version = "2.5.0"
   s.summary = "Modular Ruby clients interface for REST APIs."
   s.test_files = [
   "test/test_auth_basic.rb",

data/test/test_promise.rb

@@ -45,6 +45,18 @@ describe RC::Promise do
     @promise.send(:headers).should.eq('K' => 'V')
   end
 
+  would 'work, wait, done' do
+    @client.pool_size = 3
+    flag = 0
+    promise = @client.defer do
+      flag.should.eq 0
+      flag += 1
+    end
+    @client.wait
+    flag.should.eq 1
+    promise.should.done?
+  end
+
   would 'warn on callback error' do
     mock(any_instance_of(RC::Promise)).warn(is_a(String)) do |msg|
       msg.should.eq 'boom'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rest-core
 version: !ruby/object:Gem::Version
-  version: 3.5.7
+  version: 3.5.8
 platform: ruby
 authors:
 - Lin Jen-Shin (godfat)
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-09-10 00:00:00.000000000 Z
+date: 2015-12-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: httpclient
@@ -188,7 +188,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.4.8
+rubygems_version: 2.5.0
 signing_key: 
 specification_version: 4
 summary: Modular Ruby clients interface for REST APIs.