concurrent-ruby 0.8.0.pre2 → 0.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: f7918a0f32c1369463e3045101a1a3b1629d501a
-  data.tar.gz: c97009756916b18836a277c4d62df2f57c02b797
+  metadata.gz: c1cb9ee067ce09d0d58e0dbf2b704e9f05f3f23c
+  data.tar.gz: f70953ed219fd7da3f2011f426ed889e0293e65f
 SHA512:
-  metadata.gz: 48a95b84f0d4f4545e0e962031d74e608ac922d7f99177fb98186ba3d6a4bc86e7f49033dae64afccdbb3c7a4730544826f91a362300548eb0519d145150fbbd
-  data.tar.gz: 4624b6a91696efe3d365091171f6e03c9de2a764d8d1791892d0ae43293a05e08d740536914f9ef57b3e10f7f8ba1ee766f1e0bda322f24e53a2565038d47af0
+  metadata.gz: 23d3c454c1a17957ddb8c51320ca9ea0f365e8fb2e828b5a27e2db18d42d144679047198fcdb0dc5393349cfbfa84ba801baf5474b009634739a25e8585fb8d8
+  data.tar.gz: 45ba36f7d1aaba1dd7e5fc7a10a6922a5327c8f975bd4f5cabb2162b2b76b293884688f9bb8cbcfe8b23d61bb8cd4fd7b504b80360a3c28e204935169a67d167

data/CHANGELOG.md

@@ -1,4 +1,11 @@
-### Next Release v0.7.2 (TBD)
+### Next Release v0.8.0 (25 January 2015)
+
+* C extension for MRI have been extracted into the `concurrent-ruby-ext` companion gem.
+  Please see the README for more detail.
+* Better variable isolation in `Promise` and `Future` via an `:args` option
+* Continued to update intermittently failing tests
+
+## Current Release v0.7.2 (24 January 2015)
 
 * New `Semaphore` class based on [java.util.concurrent.Semaphore](http://docs.oracle.com/javase/7/docs/api/java/util/concurrent/Semaphore.html)
 * New `Promise.all?` and `Promise.any?` class methods
@@ -6,11 +13,16 @@
 * Thread pools still accept the `:overflow_policy` option but display a warning
 * Thread pools now implement `fallback_policy` behavior when not running (rather than universally rejecting tasks)
 * Fixed minor `set_deref_options` constructor bug in `Promise` class
+* Fixed minor `require` bug in `ThreadLocalVar` class
+* Fixed race condition bug in `TimerSet` class
+* Fixed race condition bug in `TimerSet` class
+* Fixed signal bug in `TimerSet#post` method
 * Numerous non-functional updates to clear warning when running in debug mode
 * Fixed more intermittently failing tests
 * Tests now run on new Travis build environment
+* Multiple documentation updates
 
-## Current Release v0.7.1 (4 December 2014)
+### Release v0.7.1 (4 December 2014)
 
 Please see the [roadmap](https://github.com/ruby-concurrency/concurrent-ruby/issues/142) for more information on the next planned release.
 

data/lib/concurrent/future.rb

@@ -23,6 +23,8 @@ module Concurrent
     #   global task pool (for short-running tasks)
     # @option opts [object] :executor when provided will run all operations on
     #   this executor rather than the global thread pool (overrides :operation)
+    # @option opts [object, Array] :args zero or more arguments to be passed the task block on execution
+    #
     # @option opts [String] :dup_on_deref (false) call `#dup` before returning the data
     # @option opts [String] :freeze_on_deref (false) call `#freeze` before returning the data
     # @option opts [String] :copy_on_deref (nil) call the given `Proc` passing the internal value and
@@ -35,6 +37,7 @@ module Concurrent
       @state = :unscheduled
       @task = block
       @executor = OptionsParser::get_executor_from(opts) || Concurrent.configuration.global_operation_pool
+      @args = OptionsParser::get_arguments_from(opts)
     end
 
     # Execute an `:unscheduled` `Future`. Immediately sets the state to `:pending` and
@@ -52,11 +55,9 @@ module Concurrent
     # @example Instance and execute in one line
     #   future = Concurrent::Future.new{ sleep(1); 42 }.execute
     #   future.state #=> :pending
-    #
-    # @since 0.5.0
     def execute
       if compare_and_set_state(:pending, :unscheduled)
-        @executor.post{ work }
+        @executor.post(@args){ work }
         self
       end
     end
@@ -72,6 +73,8 @@ module Concurrent
     #   global task pool (for short-running tasks)
     # @option opts [object] :executor when provided will run all operations on
     #   this executor rather than the global thread pool (overrides :operation)
+    # @option opts [object, Array] :args zero or more arguments to be passed the task block on execution
+    #
     # @option opts [String] :dup_on_deref (false) call `#dup` before returning the data
     # @option opts [String] :freeze_on_deref (false) call `#freeze` before returning the data
     # @option opts [String] :copy_on_deref (nil) call the given `Proc` passing the internal value and
@@ -84,8 +87,6 @@ module Concurrent
     # @example
     #   future = Concurrent::Future.execute{ sleep(1); 42 }
     #   future.state #=> :pending
-    #
-    # @since 0.5.0
     def self.execute(opts = {}, &block)
       Future.new(opts, &block).execute
     end
@@ -96,7 +97,7 @@ module Concurrent
 
     # @!visibility private
     def work # :nodoc:
-      success, val, reason = SafeTaskExecutor.new(@task).execute
+      success, val, reason = SafeTaskExecutor.new(@task).execute(*@args)
       complete(success, val, reason)
     end
   end

data/lib/concurrent/options_parser.rb

@@ -23,6 +23,10 @@ module Concurrent
       end
     end
 
+    def get_arguments_from(opts = {})
+      [*opts.fetch(:args, [])]
+    end
+
     # Get the requested `Executor` based on the values set in the options hash.
     #
     # @param [Hash] opts the options defining the requested executor

data/lib/concurrent/promise.rb

@@ -172,22 +172,25 @@ module Concurrent
 
     # Initialize a new Promise with the provided options.
     #
-    # @param [Hash] opts the options used to define the behavior at update and deref
+    # @!macro [attach] promise_init_options
     #
-    # @option opts [Promise] :parent the parent `Promise` when building a chain/tree
-    # @option opts [Proc] :on_fulfill fulfillment handler
-    # @option opts [Proc] :on_reject rejection handler
+    #   @param [Hash] opts the options used to define the behavior at update and deref
     #
-    # @option opts [Boolean] :operation (false) when `true` will execute the future on the global
-    #   operation pool (for long-running operations), when `false` will execute the future on the
-    #   global task pool (for short-running tasks)
-    # @option opts [object] :executor when provided will run all operations on
-    #   this executor rather than the global thread pool (overrides :operation)
+    #   @option opts [Promise] :parent the parent `Promise` when building a chain/tree
+    #   @option opts [Proc] :on_fulfill fulfillment handler
+    #   @option opts [Proc] :on_reject rejection handler
     #
-    # @option opts [String] :dup_on_deref (false) call `#dup` before returning the data
-    # @option opts [String] :freeze_on_deref (false) call `#freeze` before returning the data
-    # @option opts [String] :copy_on_deref (nil) call the given `Proc` passing the internal value and
-    #   returning the value returned from the proc
+    #   @option opts [Boolean] :operation (false) when `true` will execute the future on the global
+    #     operation pool (for long-running operations), when `false` will execute the future on the
+    #     global task pool (for short-running tasks)
+    #   @option opts [object] :executor when provided will run all operations on
+    #     this executor rather than the global thread pool (overrides :operation)
+    #   @option opts [object, Array] :args zero or more arguments to be passed the task block on execution
+    #
+    #   @option opts [String] :dup_on_deref (false) call `#dup` before returning the data
+    #   @option opts [String] :freeze_on_deref (false) call `#freeze` before returning the data
+    #   @option opts [String] :copy_on_deref (nil) call the given `Proc` passing the internal value and
+    #     returning the value returned from the proc
     #
     # @see http://wiki.commonjs.org/wiki/Promises/A
     # @see http://promises-aplus.github.io/promises-spec/
@@ -195,6 +198,8 @@ module Concurrent
       opts.delete_if { |k, v| v.nil? }
 
       @executor = OptionsParser::get_executor_from(opts) || Concurrent.configuration.global_operation_pool
+      @args = OptionsParser::get_arguments_from(opts)
+
       @parent = opts.fetch(:parent) { nil }
       @on_fulfill = opts.fetch(:on_fulfill) { Proc.new { |result| result } }
       @on_reject = opts.fetch(:on_reject) { Proc.new { |reason| raise reason } }
@@ -219,7 +224,6 @@ module Concurrent
     end
 
     # @return [Promise]
-    # @since 0.5.0
     def execute
       if root?
         if compare_and_set_state(:pending, :unscheduled)
@@ -232,7 +236,18 @@ module Concurrent
       self
     end
 
-    # @since 0.5.0
+    # Create a new `Promise` object with the given block, execute it, and return the
+    # `:pending` object.
+    #
+    # @!macro promise_init_options
+    #
+    # @return [Promise] the newly created `Promise` in the `:pending` state
+    #
+    # @raise [ArgumentError] if no block is given
+    #
+    # @example
+    #   promise = Concurrent::Promise.execute{ sleep(1); 42 }
+    #   promise.state #=> :pending
     def self.execute(opts = {}, &block)
       new(opts, &block).execute
     end
@@ -389,6 +404,7 @@ module Concurrent
       composite
     end
 
+    # @!visibility private
     def set_pending
       mutex.synchronize do
         @state = :pending
@@ -413,6 +429,7 @@ module Concurrent
       nil
     end
 
+    # @!visibility private
     def notify_child(child)
       if_state(:fulfilled) { child.on_fulfill(apply_deref_options(@value)) }
       if_state(:rejected) { child.on_reject(@reason) }
@@ -421,7 +438,7 @@ module Concurrent
     # @!visibility private
     def realize(task)
       @executor.post do
-        success, value, reason = SafeTaskExecutor.new(task).execute
+        success, value, reason = SafeTaskExecutor.new(task).execute(*@args)
 
         children_to_notify = mutex.synchronize do
           set_state!(success, value, reason)
@@ -432,11 +449,13 @@ module Concurrent
       end
     end
 
+    # @!visibility private
     def set_state!(success, value, reason)
       set_state(success, value, reason)
       event.set
     end
 
+    # @!visibility private
     def synchronized_set_state!(success, value, reason)
       mutex.lock
       set_state!(success, value, reason)

data/lib/concurrent/version.rb

@@ -1,3 +1,3 @@
 module Concurrent
-  VERSION = '0.8.0.pre2'
+  VERSION = '0.8.0'
 end

data/lib/extension_helper.rb

@@ -20,7 +20,7 @@ module Concurrent
     rescue LoadError
       # may be a Windows cross-compiled native gem
       begin
-        require "#{RUBY_VERSION[0..2]}/concurrent/extension"
+        require "concurrent/#{RUBY_VERSION[0..2]}/extension"
         @@c_ext_loaded = true
       rescue LoadError
         warn 'Performance on MRI may be improved with the concurrent-ruby-ext gem. Please see http://concurrent-ruby.com'
@@ -31,7 +31,7 @@ module Concurrent
       require 'concurrent_ruby_ext'
       @@java_ext_loaded = true
     rescue LoadError
-      warn 'Attempted to load Java extensions on unsupported platform. Continuing with pure-Ruby.'
+      warn 'Performance on JRuby may be improved by installing the pre-compiled Java extensions. Please see http://concurrent-ruby.com'
     end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: concurrent-ruby
 version: !ruby/object:Gem::Version
-  version: 0.8.0.pre2
+  version: 0.8.0
 platform: ruby
 authors:
 - Jerry D'Antonio
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-01-15 00:00:00.000000000 Z
+date: 2015-01-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ref
@@ -168,9 +168,9 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: 1.9.3
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">"
+  - - ">="
     - !ruby/object:Gem::Version
-      version: 1.3.1
+      version: '0'
 requirements: []
 rubyforge_project: 
 rubygems_version: 2.4.5