concurrent-ruby 0.9.0.pre3 → 0.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: f405da05002f7882b78a16748dba3c9a3439bb8f
-  data.tar.gz: be024ee9c4ecc15d86840b3599158d2312273459
+  metadata.gz: 06e8ac2ad12cfbd2d70c6d8d687b2a9e338a9a31
+  data.tar.gz: 00438fa26d2bd287644b0dccd7b4a31a17e350cd
 SHA512:
-  metadata.gz: a1c334847abed2ba6b9b3dbd290b4aa137ccdad02dd1f11aaa4b5fff6ce64cf37ce197ff2dc6ec5ad580053cf65ce38df7334e69ca54dd26f53dfa782654dacb
-  data.tar.gz: ab7cd113db8ee277fa8fda122cdc6efc74e2c245f4614016e2e3c4fcbd6f4c1ca55dd65adb42fa9cec0d08752971774579af3ffc4758054be12b3e0022a63638
+  metadata.gz: c6f70cef24b30511a49b2e0b348b9b291bc5c53505babfb3665b35f816aec3877fbca1c5e84c5383c78be65c26ae6b99947ea94fcc9e1c88ffebcad6f8f7ec54
+  data.tar.gz: b23f9e760e1d7c079a1e467181d796b65366b6d068cbf797cbec1937f42e8919825f2515d25c23ea04de88750229698019b85c6dc0f204aa3419d3b720f339a8

data/CHANGELOG.md

@@ -1,5 +1,4 @@
-### Next Release v0.9.0 (Target Date: 7 June 2015)
-
+## Current Release v0.9.0 (10 July 2015)
 
 * Updated `AtomicReference`
   - `AtomicReference#try_update` now simply returns instead of raising exception
@@ -98,7 +97,7 @@
 * Removed brute-force killing of threads in tests
 * Fixed a thread pool bug when the operating system cannot allocate more threads
 
-## Current Release v0.8.0 (25 January 2015)
+### 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.

data/README.md

@@ -1,5 +1,5 @@
 # Concurrent Ruby
-[![Gem Version](https://badge.fury.io/rb/concurrent-ruby.svg)](http://badge.fury.io/rb/concurrent-ruby) [![Build Status](https://travis-ci.org/ruby-concurrency/concurrent-ruby.svg?branch=master)](https://travis-ci.org/ruby-concurrency/concurrent-ruby) [![Code Climate](https://codeclimate.com/github/ruby-concurrency/concurrent-ruby.svg)](https://codeclimate.com/github/ruby-concurrency/concurrent-ruby) [![Inline docs](http://inch-ci.org/github/ruby-concurrency/concurrent-ruby.svg)](http://inch-ci.org/github/ruby-concurrency/concurrent-ruby) [![Dependency Status](https://gemnasium.com/ruby-concurrency/concurrent-ruby.svg)](https://gemnasium.com/ruby-concurrency/concurrent-ruby) [![License](https://img.shields.io/badge/license-MIT-green.svg)](http://opensource.org/licenses/MIT) [![Gitter chat](http://img.shields.io/badge/gitter-join%20chat%20%E2%86%92-brightgreen.svg)](https://gitter.im/ruby-concurrency/concurrent-ruby)
+[![Gem Version](https://badge.fury.io/rb/concurrent-ruby.svg)](http://badge.fury.io/rb/concurrent-ruby) [![Build Status](https://travis-ci.org/ruby-concurrency/concurrent-ruby.svg?branch=master)](https://travis-ci.org/ruby-concurrency/concurrent-ruby) [![Build status](https://ci.appveyor.com/api/projects/status/iq8aboyuu3etad4w?svg=true)](https://ci.appveyor.com/project/rubyconcurrency/concurrent-ruby) [![Code Climate](https://codeclimate.com/github/ruby-concurrency/concurrent-ruby.svg)](https://codeclimate.com/github/ruby-concurrency/concurrent-ruby) [![Inline docs](http://inch-ci.org/github/ruby-concurrency/concurrent-ruby.svg)](http://inch-ci.org/github/ruby-concurrency/concurrent-ruby) [![Dependency Status](https://gemnasium.com/ruby-concurrency/concurrent-ruby.svg)](https://gemnasium.com/ruby-concurrency/concurrent-ruby) [![License](https://img.shields.io/badge/license-MIT-green.svg)](http://opensource.org/licenses/MIT) [![Gitter chat](http://img.shields.io/badge/gitter-join%20chat%20%E2%86%92-brightgreen.svg)](https://gitter.im/ruby-concurrency/concurrent-ruby)
 
 <table>
   <tr>
@@ -39,6 +39,7 @@
 
 MRI 1.9.3, 2.0, 2.1, 2.2, JRuby (1.9 mode), and Rubinius 2.x are supported.
 This gem should be fully compatible with any interpreter that is compliant with Ruby 1.9.3 or newer.
+Java 8 is required for JRuby (Java 7 support is deprecated in version 0.9 and will be removed in 1.0).
 
 ## Features & Documentation
 
@@ -127,14 +128,14 @@ be obeyed though. Features developed in `concurrent-ruby-edge` are expected to m
 
 #### Statuses:
 
-*Why is not in core?*
+*Why are these not in core?*
 
-- **Actor** - partial documentation and tests, stability good. 
-- **Future/Promise Framework** - partial documentation and tests, stability good.
-- **Agent** - incomplete behaviour compared to Clojure's model, stability good.
-- **Channel** - missing documentation, stability good.
-- **Exchanger** - known race issue.
-- **LazyRegister** - missing documentation and tests.   
+- **Actor** - Partial documentation and tests; stability is good. 
+- **Future/Promise Framework** - API changes; partial documentation and tests; stability good.
+- **Agent** - Incomplete behaviour compared to Clojure's models; stability good.
+- **Channel** - Missing documentation; limted features; stability good.
+- **Exchanger** - Known race condition requiring a new implementation.
+- **LazyRegister** - Missing documentation and tests.   
 
 ## Usage
 
@@ -248,10 +249,16 @@ bundle exec rake build              # Build JRuby-specific core gem (alias for `
 bundle exec rake build:core         # Build concurrent-ruby-<version>-java.gem into the pkg directory
 
 *All except JRuby*
-bundle exec rake build              # Build core and extension gems
 bundle exec rake build:core         # Build concurrent-ruby-<version>.gem into the pkg directory
 bundle exec rake build:ext          # Build concurrent-ruby-ext-<version>.gem into the pkg directory
 
+*When Docker IS installed*
+bundle exec rake build:windows      # Build the windows binary <version> gems per rake-compiler-dock
+bundle exec rake build              # Build core, extension, and edge gems, including Windows binaries
+
+*When Docker is NOT installed*
+bundle exec rake build              # Build core, extension, and edge gems (excluding Windows binaries)
+
 *All*
 bundle exec rake clean              # Remove any temporary products
 bundle exec rake clobber            # Remove any generated file
@@ -260,7 +267,7 @@ bundle exec rake compile            # Compile all the extensions
 
 ## Maintainers
 
-* [Jerry D'Antonio](https://github.com/jdantonio)
+* [Jerry D'Antonio](https://github.com/jdantonio) (creator)
 * [Michele Della Torre](https://github.com/mighe)
 * [Chris Seaton](https://github.com/chrisseaton)
 * [Lucas Allan](https://github.com/lucasallan)

data/lib/concurrent/concern/deprecation.rb

@@ -10,18 +10,25 @@ module Concurrent
       include Concern::Logging
 
       def deprecated(message, strip = 2)
-        caller_line = caller(strip).first
-        klass       = if Class === self
+        caller_line = caller(strip).first if strip > 0
+        klass       = if Module === self
                         self
                       else
                         self.class
                       end
-        log WARN, klass.to_s, format("[DEPRECATED] %s\ncalled on: %s", message, caller_line)
+        message     = if strip > 0
+                        format("[DEPRECATED] %s\ncalled on: %s", message, caller_line)
+                      else
+                        format('[DEPRECATED] %s', message)
+                      end
+        log WARN, klass.to_s, message
       end
 
       def deprecated_method(old_name, new_name)
         deprecated "`#{old_name}` is deprecated and it'll removed in next release, use `#{new_name}` instead", 3
       end
+
+      extend self
     end
   end
 end

data/lib/concurrent/concern/logging.rb

@@ -15,6 +15,8 @@ module Concurrent
       # @param [String, nil] message when nil block is used to generate the message
       # @yieldreturn [String] a message
       def log(level, progname, message = nil, &block)
+        #NOTE: Cannot require 'concurrent/configuration' above due to circular references.
+        #      Assume that the gem has been initialized if we've gotten this far.
         (@logger || Concurrent.global_logger).call level, progname, message, &block
       rescue => error
         $stderr.puts "`Concurrent.configuration.logger` failed to log #{[level, progname, message, block]}\n" +

data/lib/concurrent/configuration.rb

@@ -11,37 +11,6 @@ module Concurrent
   extend Concern::Logging
   extend Concern::Deprecation
 
-  # Suppresses all output when used for logging.
-  NULL_LOGGER = lambda { |level, progname, message = nil, &block| }
-
-  # @!visibility private
-  GLOBAL_LOGGER = AtomicReference.new(NULL_LOGGER)
-  private_constant :GLOBAL_LOGGER
-
-  # @!visibility private
-  GLOBAL_FAST_EXECUTOR = Delay.new { Concurrent.new_fast_executor(auto_terminate: true) }
-  private_constant :GLOBAL_FAST_EXECUTOR
-
-  # @!visibility private
-  GLOBAL_IO_EXECUTOR = Delay.new { Concurrent.new_io_executor(auto_terminate: true) }
-  private_constant :GLOBAL_IO_EXECUTOR
-
-  # @!visibility private
-  GLOBAL_TIMER_SET = Delay.new { TimerSet.new(auto_terminate: true) }
-  private_constant :GLOBAL_TIMER_SET
-
-  # @!visibility private
-  GLOBAL_IMMEDIATE_EXECUTOR = ImmediateExecutor.new
-  private_constant :GLOBAL_IMMEDIATE_EXECUTOR
-
-  def self.global_logger
-    GLOBAL_LOGGER.value
-  end
-
-  def self.global_logger=(value)
-    GLOBAL_LOGGER.value = value
-  end
-
   # @return [Logger] Logger with provided level and output.
   def self.create_stdlib_logger(level = Logger::FATAL, output = $stderr)
     logger           = Logger.new(output)
@@ -62,17 +31,48 @@ module Concurrent
              progname,
              formatted_message
     end
-    logger
+
+    lambda do |level, progname, message = nil, &block|
+      logger.add level, message, progname, &block
+    end
   end
 
   # Use logger created by #create_stdlib_logger to log concurrent-ruby messages.
   def self.use_stdlib_logger(level = Logger::FATAL, output = $stderr)
-    logger = create_stdlib_logger level, output
-    Concurrent.global_logger = lambda do |level, progname, message = nil, &block|
-      logger.add level, message, progname, &block
-    end
+    Concurrent.global_logger = create_stdlib_logger level, output
   end
 
+  # Suppresses all output when used for logging.
+  NULL_LOGGER   = lambda { |level, progname, message = nil, &block| }
+
+  # @!visibility private
+  GLOBAL_LOGGER = AtomicReference.new(create_stdlib_logger(Logger::WARN))
+  private_constant :GLOBAL_LOGGER
+
+  def self.global_logger
+    GLOBAL_LOGGER.value
+  end
+
+  def self.global_logger=(value)
+    GLOBAL_LOGGER.value = value
+  end
+
+  # @!visibility private
+  GLOBAL_FAST_EXECUTOR = Delay.new { Concurrent.new_fast_executor(auto_terminate: true) }
+  private_constant :GLOBAL_FAST_EXECUTOR
+
+  # @!visibility private
+  GLOBAL_IO_EXECUTOR = Delay.new { Concurrent.new_io_executor(auto_terminate: true) }
+  private_constant :GLOBAL_IO_EXECUTOR
+
+  # @!visibility private
+  GLOBAL_TIMER_SET = Delay.new { TimerSet.new(auto_terminate: true) }
+  private_constant :GLOBAL_TIMER_SET
+
+  # @!visibility private
+  GLOBAL_IMMEDIATE_EXECUTOR = ImmediateExecutor.new
+  private_constant :GLOBAL_IMMEDIATE_EXECUTOR
+
   # Disables AtExit handlers including pool auto-termination handlers.
   # When disabled it will be the application programmer's responsibility
   # to ensure that the handlers are shutdown properly prior to application
@@ -275,4 +275,18 @@ module Concurrent
   def self.configure
     yield(configuration)
   end
+
+  # for dependency reasons this check cannot be in concurrent/synchronization
+  if Concurrent.on_jruby?
+    require 'java'
+
+    version_string = java.lang.System.getProperties['java.runtime.version']
+    version        = version_string.split('.', 3)[0..1].map(&:to_i)
+    if (version <=> [1, 8]) < 0
+      deprecated <<-TXT.gsub(/^\s*\|/, '').chop, 0
+          |Java 7 is deprecated, please use Java 8.
+          |Java 7 support is only best effort, it may not work. It will be removed in next release (1.0).
+      TXT
+    end
+  end
 end

data/lib/concurrent/scheduled_task.rb

@@ -5,52 +5,54 @@ require 'concurrent/collection/copy_on_notify_observer_set'
 require 'concurrent/executor/executor'
 require 'concurrent/executor/timer_set'
 require 'concurrent/utility/monotonic_time'
+require 'concurrent/concern/deprecation'
 
 module Concurrent
+  include Concern::Deprecation
 
   # `ScheduledTask` is a close relative of `Concurrent::Future` but with one
   # important difference: A `Future` is set to execute as soon as possible
   # whereas a `ScheduledTask` is set to execute after a specified delay. This
   # implementation is loosely based on Java's
-  # [ScheduledExecutorService](http://docs.oracle.com/javase/7/docs/api/java/util/concurrent/ScheduledExecutorService.html). 
+  # [ScheduledExecutorService](http://docs.oracle.com/javase/7/docs/api/java/util/concurrent/ScheduledExecutorService.html).
   # It is a more feature-rich variant of {Concurrent.timer}.
-  # 
+  #
   # The *intended* schedule time of task execution is set on object construction
   # with the `delay` argument. The delay is a numeric (floating point or integer)
   # representing a number of seconds in the future. Any other value or a numeric
   # equal to or less than zero will result in an exception. The *actual* schedule
   # time of task execution is set when the `execute` method is called.
-  #  
+  #
   # The constructor can also be given zero or more processing options. Currently
   # the only supported options are those recognized by the
-  # [Dereferenceable](Dereferenceable) module. 
-  # 
+  # [Dereferenceable](Dereferenceable) module.
+  #
   # The final constructor argument is a block representing the task to be performed.
   # If no block is given an `ArgumentError` will be raised.
-  # 
+  #
   # **States**
-  # 
+  #
   # `ScheduledTask` mixes in the  [Obligation](Obligation) module thus giving it
   # "future" behavior. This includes the expected lifecycle states. `ScheduledTask`
   # has one additional state, however. While the task (block) is being executed the
   # state of the object will be `:processing`. This additional state is necessary
-  # because it has implications for task cancellation. 
-  # 
+  # because it has implications for task cancellation.
+  #
   # **Cancellation**
-  # 
+  #
   # A `:pending` task can be cancelled using the `#cancel` method. A task in any
   # other state, including `:processing`, cannot be cancelled. The `#cancel`
   # method returns a boolean indicating the success of the cancellation attempt.
-  # A cancelled `ScheduledTask` cannot be restarted. It is immutable. 
-  # 
+  # A cancelled `ScheduledTask` cannot be restarted. It is immutable.
+  #
   # **Obligation and Observation**
-  # 
+  #
   # The result of a `ScheduledTask` can be obtained either synchronously or
   # asynchronously. `ScheduledTask` mixes in both the [Obligation](Obligation)
   # module and the
   # [Observable](http://ruby-doc.org/stdlib-2.0/libdoc/observer/rdoc/Observable.html)
   # module from the Ruby standard library. With one exception `ScheduledTask`
-  # behaves identically to [Future](Observable) with regard to these modules. 
+  # behaves identically to [Future](Observable) with regard to these modules.
   #
   # @!macro copy_options
   #
@@ -59,7 +61,7 @@ module Concurrent
   #   require 'concurrent'
   #   require 'thread'   # for Queue
   #   require 'open-uri' # for open(uri)
-  #   
+  #
   #   class Ticker
   #     def get_year_end_closing(symbol, year)
   #       uri = "http://ichart.finance.yahoo.com/table.csv?s=#{symbol}&a=11&b=01&c=#{year}&d=11&e=31&f=#{year}&g=m"
@@ -67,75 +69,75 @@ module Concurrent
   #       data[1].split(',')[4].to_f
   #     end
   #   end
-  #   
+  #
   #   # Future
   #   price = Concurrent::Future.execute{ Ticker.new.get_year_end_closing('TWTR', 2013) }
   #   price.state #=> :pending
   #   sleep(1)    # do other stuff
   #   price.value #=> 63.65
   #   price.state #=> :fulfilled
-  #   
+  #
   #   # ScheduledTask
   #   task = Concurrent::ScheduledTask.execute(2){ Ticker.new.get_year_end_closing('INTC', 2013) }
   #   task.state #=> :pending
   #   sleep(3)   # do other stuff
   #   task.value #=> 25.96
-  # 
+  #
   # @example Successful task execution
-  #   
+  #
   #   task = Concurrent::ScheduledTask.new(2){ 'What does the fox say?' }
   #   task.state         #=> :unscheduled
   #   task.execute
   #   task.state         #=> pending
-  #   
+  #
   #   # wait for it...
   #   sleep(3)
-  #   
+  #
   #   task.unscheduled? #=> false
   #   task.pending?     #=> false
   #   task.fulfilled?   #=> true
   #   task.rejected?    #=> false
   #   task.value        #=> 'What does the fox say?'
-  # 
+  #
   # @example One line creation and execution
-  # 
+  #
   #   task = Concurrent::ScheduledTask.new(2){ 'What does the fox say?' }.execute
   #   task.state         #=> pending
-  # 
+  #
   #   task = Concurrent::ScheduledTask.execute(2){ 'What do you get when you multiply 6 by 9?' }
   #   task.state         #=> pending
-  # 
+  #
   # @example Failed task execution
-  # 
+  #
   #   task = Concurrent::ScheduledTask.execute(2){ raise StandardError.new('Call me maybe?') }
   #   task.pending?      #=> true
-  #   
+  #
   #   # wait for it...
   #   sleep(3)
-  #   
+  #
   #   task.unscheduled? #=> false
   #   task.pending?     #=> false
   #   task.fulfilled?   #=> false
   #   task.rejected?    #=> true
   #   task.value        #=> nil
-  #   task.reason       #=> #<StandardError: Call me maybe?> 
-  # 
+  #   task.reason       #=> #<StandardError: Call me maybe?>
+  #
   # @example Task execution with observation
-  # 
+  #
   #   observer = Class.new{
   #     def update(time, value, reason)
   #       puts "The task completed at #{time} with value '#{value}'"
   #     end
   #   }.new
-  #   
+  #
   #   task = Concurrent::ScheduledTask.new(2){ 'What does the fox say?' }
   #   task.add_observer(observer)
   #   task.execute
   #   task.pending?      #=> true
-  #   
+  #
   #   # wait for it...
   #   sleep(3)
-  #   
+  #
   #   #>> The task completed at 2013-11-07 12:26:09 -0500 with value 'What does the fox say?'
   #
   # @!macro monotonic_clock_warning
@@ -196,12 +198,12 @@ module Concurrent
     #
     # @deprecated use {#initial_delay} instead
     def delay
-      warn '[DEPRECATED] use #initial_delay instead'
+      deprecated_method 'delay', 'initial_delay'
       initial_delay
     end
 
     # The monotonic time at which the the task is scheduled to be executed.
-    # 
+    #
     # @return [Float] the schedule time or nil if `unscheduled`
     def schedule_time
       synchronize { @time }
@@ -234,7 +236,7 @@ module Concurrent
     #
     # @deprecated Use {#processing?} instead.
     def in_progress?
-      warn '[DEPRECATED] use #processing? instead'
+      deprecated_method 'in_progress?', 'processing?'
       processing?
     end
 
@@ -260,7 +262,7 @@ module Concurrent
     #
     # @deprecated Use {#cancel} instead.
     def stop
-      warn '[DEPRECATED] use #cancel instead'
+      deprecated_method 'stop', 'cancel'
       cancel
     end
 
@@ -363,7 +365,7 @@ module Concurrent
     # @!visibility private
     def calculate_delay!(delay)
       if delay.is_a?(Time)
-        warn '[DEPRECATED] Use an interval not a clock time; schedule is now based on a monotonic clock'
+        deprecated 'Use an interval not a clock time; schedule is now based on a monotonic clock'
         now = Time.now
         raise ArgumentError.new('schedule time must be in the future') if delay <= now
         delay.to_f - now.to_f

data/lib/concurrent/synchronization/java_object.rb

@@ -4,7 +4,6 @@ module Concurrent
   module Synchronization
 
     if Concurrent.on_jruby?
-      require 'jruby'
 
       # @!visibility private
       # @!macro internal_implementation_note

data/lib/concurrent/synchronization/monitor_object.rb

@@ -1,3 +1,5 @@
+require 'monitor'
+
 module Concurrent
   module Synchronization
 

data/lib/concurrent/utility/at_exit.rb

@@ -1,4 +1,4 @@
-require 'concurrent/concern/logging'
+require 'logger'
 require 'concurrent/synchronization'
 
 module Concurrent
@@ -8,7 +8,7 @@ module Concurrent
   #
   # @!visibility private
   class AtExitImplementation < Synchronization::Object
-    include Concern::Logging
+    include Logger::Severity
 
     def initialize(*args)
       super()
@@ -46,9 +46,9 @@ module Concurrent
     def install
       synchronize do
         @installed ||= begin
-          at_exit { runner }
-          true
-        end
+                         at_exit { runner }
+                         true
+                       end
         self
       end
     end
@@ -71,7 +71,7 @@ module Concurrent
         begin
           handler.call
         rescue => error
-          log ERROR, error
+          Concurrent.global_logger.call(ERROR, error)
         end
       end
       handlers.keys

data/lib/concurrent/utility/engine.rb

@@ -19,6 +19,10 @@ module Concurrent
         ruby_engine == 'rbx'
       end
 
+      def on_windows?
+        !(RbConfig::CONFIG['host_os'] =~ /mswin|mingw|cygwin/).nil?
+      end
+
       def ruby_engine
         defined?(RUBY_ENGINE) ? RUBY_ENGINE : 'ruby'
       end

data/lib/concurrent/version.rb

@@ -1,4 +1,4 @@
 module Concurrent
-  VERSION      = '0.9.0.pre3'
-  EDGE_VERSION = '0.1.0.pre3'
+  VERSION      = '0.9.0'
+  EDGE_VERSION = '0.1.0'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: concurrent-ruby
 version: !ruby/object:Gem::Version
-  version: 0.9.0.pre3
+  version: 0.9.0
 platform: ruby
 authors:
 - Jerry D'Antonio
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-06-22 00:00:00.000000000 Z
+date: 2015-07-10 00:00:00.000000000 Z
 dependencies: []
 description: |
   Modern concurrency tools including agents, futures, promises, thread pools, actors, supervisors, and more.
@@ -127,9 +127,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.8