concurrent-ruby-ext 0.1.0.pre1-x86-mingw32 → 0.8.0.pre2-x86-mingw32

checksums.yaml

@@ -1,15 +1,15 @@
 ---
 !binary "U0hBMQ==":
   metadata.gz: !binary |-
-    ZDkyZGNhOGQxOGM0MGE0M2JiMzM5NTEyMGNlZTFlYjQyMDZjNTM3NA==
+    YzJiY2IxMzYxZDg0NTcwM2M3Y2NmMTQyNjUxMzkyYTYzNGNkOTY0NQ==
   data.tar.gz: !binary |-
-    ZGYwNzA3NGIyMTY5YTdjNGJiYmU5NWMyNTVmNjE0MjE3ZWRjYTIyYw==
+    YzRkYWU3NjBkNzliNjU1OTViNzQ2NDA3YTFmMTg1NzVkMTJkOTUyYw==
 SHA512:
   metadata.gz: !binary |-
-    YTlkNTk4MmI0ZThmMmVhNzIxZTY4YzNmMTA2NWE5ODA4ZjBkMDExMzBlNDJj
-    Mzc4YTM2ZDBjNTQ3OTg3NTg4MzQ5MGFkZTBmMjRhNTg2ODcxNzc4ZTE0Zjdm
-    YjIwNTRjZDQwMWIxYTllOGNmNGYwZjZkOWEyMGJjMjdlNzlmZGY=
+    YjhkMWEyMWQ1MGE2ZjQ0YWUyMTcxM2E1YjQ5MmZhNzg4ZjQyNTFjMDBlZmZj
+    YzlhYjkzMDc0ZDg1MTg1YzY5MDY0YmU1MTlhZTE1ZGMxMGY2MDc4ZDgzMGZk
+    ZGRkYzM5OTM0ZGU5NTViYjZjN2UxMjA1NjQyZmUxZmQ1YTZjZjY=
   data.tar.gz: !binary |-
-    YzVlMWEyN2MxY2E3NmRhNGJhYWE0MjkxNDY3NDk0NDY5MjE3ZGZlYjZkZmEw
-    ZGUzZWVjNmE4OGNkNmI1YThkZDZjMDVkMmRiZGExNmM5MzI4YjIwMjE2Zjcz
-    Yjg3Y2MwYWIwZWY4NDJlZDMxNzc4YTE2ZWY5MjVkNzRhYzg4ODY=
+    MjVjZTE3OTRiNWNkYTQ0ZmU2MWE4MGNmMDRhMGQ4NzYwYTExMzk4YmZiMTdl
+    MzIyMWU4NjkyN2U4NzU1MmE4ZWY1ZjhkYjVkNTc0OTE3MDc5ZTNkOWY5YWMy
+    YmM4ZTJjOTllYjRiOGVmMWU3MDIyZTg4NzhmMWViMjZiYjMxNTQ=

data/CHANGELOG.md

@@ -1,5 +1,6 @@
 ### Next Release v0.7.2 (TBD)
 
+* 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
 * Renamed `:overflow_policy` on thread pools to `:fallback_policy`
 * Thread pools still accept the `:overflow_policy` option but display a warning

data/README.md

@@ -37,7 +37,7 @@
 
 ### Supported Ruby versions
 
-MRI 1.9.3, 2.0, 2.1, JRuby (1.9 mode), and Rubinius 2.x are supported.
+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.
 
 ## Features & Documentation
@@ -52,19 +52,19 @@ This library contains a variety of concurrency abstractions at high and low leve
 
 ### High-level, general-purpose asynchronous concurrency abstractions
 
-* [Actor](./doc/actor/main.md): Implements the Actor Model, where concurrent actors exchange messages. 
-* [Agent](./doc/agent.md): A single atomic value that represents an identity.
-* [Async](./doc/async.md): A mixin module that provides simple asynchronous behavior to any standard class/object or object.
-* [Future](./doc/future.md): An asynchronous operation that produces a value.
-  * [Dataflow](./doc/dataflow.md): Built on Futures, Dataflow allows you to create a task that will be scheduled when all of its data dependencies are available.
-* [Promise](http://ruby-concurrency.github.io/concurrent-ruby/Concurrent/Promise.html): Similar to Futures, with more features. 
-* [ScheduledTask](./doc/scheduled_task.md): Like a Future scheduled for a specific future time. 
+* [Actor](http://ruby-concurrency.github.io/concurrent-ruby/Concurrent/Actor.html): Implements the Actor Model, where concurrent actors exchange messages.
+* [Agent](http://ruby-concurrency.github.io/concurrent-ruby/Concurrent/Agent.html): A single atomic value that represents an identity.
+* [Async](http://ruby-concurrency.github.io/concurrent-ruby/Concurrent/Async.html): A mixin module that provides simple asynchronous behavior to any standard class/object or object.
+* [Future](http://ruby-concurrency.github.io/concurrent-ruby/Concurrent/Future.html): An asynchronous operation that produces a value.
+  * [Dataflow](http://ruby-concurrency.github.io/concurrent-ruby/Concurrent/Dataflow.html): Built on Futures, Dataflow allows you to create a task that will be scheduled when all of its data dependencies are available.
+* [Promise](http://ruby-concurrency.github.io/concurrent-ruby/Concurrent/Promise.html): Similar to Futures, with more features.
+* [ScheduledTask](http://ruby-concurrency.github.io/concurrent-ruby/Concurrent/ScheduledTask.html): Like a Future scheduled for a specific future time.
 * [TimerTask](http://ruby-concurrency.github.io/concurrent-ruby/Concurrent/TimerTask.html): A Thread that periodically wakes up to perform work at regular intervals. 
 * [Channel](http://ruby-concurrency.github.io/concurrent-ruby/Concurrent/Channel.html): Communicating Sequential Processes (CSP). 
 
 ### Java-inspired ThreadPools and other executors
 
-* See [ThreadPool](./doc/thread_pools.md) overview, which also contains a list of other Executors available.
+* See [ThreadPool](http://ruby-concurrency.github.io/concurrent-ruby/file.thread_pools.html) overview, which also contains a list of other Executors available.
 
 ### Thread-safe Observers
 
@@ -73,6 +73,7 @@ This library contains a variety of concurrency abstractions at high and low leve
 * [CopyOnWriteObserverSet](http://ruby-concurrency.github.io/concurrent-ruby/Concurrent/CopyOnWriteObserverSet.html)
 
 ### Thread synchronization classes and algorithms
+
 Lower-level abstractions mainly used as building blocks. 
 
 * [condition](http://ruby-concurrency.github.io/concurrent-ruby/Concurrent/Condition.html)
@@ -80,10 +81,12 @@ Lower-level abstractions mainly used as building blocks.
 * [cyclic barrier](http://ruby-concurrency.github.io/concurrent-ruby/Concurrent/CyclicBarrier.html)
 * [event](http://ruby-concurrency.github.io/concurrent-ruby/Concurrent/Event.html)
 * [exchanger](http://ruby-concurrency.github.io/concurrent-ruby/Concurrent/Exchanger.html)
+* [semaphore](http://ruby-concurrency.github.io/concurrent-ruby/Concurrent/Semaphore.html)
 * [timeout](http://ruby-concurrency.github.io/concurrent-ruby/Concurrent.html#timeout-class_method)
 * [timer](http://ruby-concurrency.github.io/concurrent-ruby/Concurrent.html#timer-class_method)
 
 ### Thread-safe variables
+
 Lower-level abstractions mainly used as building blocks. 
 
 * [AtomicBoolean](http://ruby-concurrency.github.io/concurrent-ruby/Concurrent/AtomicBoolean.html)
@@ -92,7 +95,7 @@ Lower-level abstractions mainly used as building blocks.
 * [I-Structures](http://ruby-concurrency.github.io/concurrent-ruby/Concurrent/IVar.html) (IVar)
 * [M-Structures](http://ruby-concurrency.github.io/concurrent-ruby/Concurrent/MVar.html) (MVar)
 * [thread-local variables](http://ruby-concurrency.github.io/concurrent-ruby/Concurrent/ThreadLocalVar.html)
-* [software transactional memory](./doc/tvar.md) (TVar)
+* [software transactional memory](http://ruby-concurrency.github.io/concurrent-ruby/Concurrent/TVar.html) (TVar)
 
 ## Usage
 
@@ -153,7 +156,7 @@ To minimize installation errors the C extensions are available in the `concurren
 gem. The extension gem lists `concurrent-ruby` as a dependency so it is not necessary to install both.
 Simply install the extension gen:
 
-```shell
+```ruby
 gem install concurrent-ruby-ext
 ```
 
@@ -167,13 +170,45 @@ and run `bundle install` from your shell.
 
 In code it is only necessary to
 
-```shell
+```ruby
 require 'concurrent'
 ```
 
 The `concurrent-ruby` gem will automatically detect the presence of the `concurrent-ruby-ext` gem
 and load the appropriate C extensions.
 
+#### Note For gem developers
+
+No gems should depend on `concurrent-ruby-ext`. Doing so will force C extensions on your users.
+The best practice is to depend on `concurrent-ruby` and let users to decide if they want C extensions.
+
+### Building
+
+All published versions of this gem (core, extension, and several platform-specific packages) are compiled,
+packaged, tested, and published using an open, [automated process](https://github.com/ruby-concurrency/rake-compiler-dev-box).
+This process can also be used to create pre-compiled binaries of the extension gem for virtally
+any platform. *Documentation is forthcoming...*
+
+```
+*MRI only*
+rake build:native       # Build concurrent-ruby-ext-<version>-<platform>.gem into the pkg directory
+rake compile:extension  # Compile extension
+
+*JRuby only*
+rake build              # Build JRuby-specific core gem (alias for `build:core`)
+rake build:core         # Build concurrent-ruby-<version>-java.gem into the pkg directory
+
+*All except JRuby*
+rake build              # Build core and extension gems
+rake build:core         # Build concurrent-ruby-<version>.gem into the pkg directory
+rake build:ext          # Build concurrent-ruby-ext-<version>.gem into the pkg directory
+
+*All*
+rake clean              # Remove any temporary products
+rake clobber            # Remove any generated file
+rake compile            # Compile all the extensions
+```
+
 ## Maintainers
 
 * [Jerry D'Antonio](https://github.com/jdantonio)

data/ext/{concurrent_ruby_ext → concurrent}/extconf.rb

@@ -1,9 +1,8 @@
 require 'fileutils'
 
-$:.push File.join(File.dirname(__FILE__), '../../lib')
-require 'extension_helper'
+require_relative '../../lib/extension_helper'
 
-EXTENSION_NAME = 'concurrent_ruby_ext'
+EXTENSION_NAME = 'extension'
 
 def create_dummy_makefile
   File.open('Makefile', 'w') do |f|
@@ -50,7 +49,7 @@ else
       }
 CODE
 
-    create_makefile(EXTENSION_NAME)
+    create_makefile('concurrent/' + EXTENSION_NAME)
   rescue
     create_dummy_makefile
     warn 'C optimizations cannot be compiled on this version of Ruby.'

data/ext/{concurrent_ruby_ext → concurrent}/rb_concurrent.c

@@ -11,9 +11,9 @@ static VALUE rb_cAtomic;
 static VALUE rb_cAtomicBoolean;
 static VALUE rb_cAtomicFixnum;
 
-// Init_concurrent_ruby_ext
+// Init_extension
 
-void Init_concurrent_ruby_ext() {
+void Init_extension() {
 
   // define modules and classes
   rb_mConcurrent = rb_define_module("Concurrent");

data/lib/extension_helper.rb

@@ -0,0 +1,37 @@
+module Concurrent
+
+  @@c_ext_loaded ||= false
+  @@java_ext_loaded ||= false
+
+  # @!visibility private
+  def self.allow_c_extensions?
+    defined?(RUBY_ENGINE) && RUBY_ENGINE == 'ruby'
+  end
+
+  # @!visibility private
+  def self.jruby?
+    RUBY_PLATFORM == 'java'
+  end
+
+  if allow_c_extensions? && !@@c_ext_loaded
+    begin
+      require 'concurrent/extension'
+      @@c_ext_loaded = true
+    rescue LoadError
+      # may be a Windows cross-compiled native gem
+      begin
+        require "#{RUBY_VERSION[0..2]}/concurrent/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'
+      end
+    end
+  elsif jruby? && !@@java_ext_loaded
+    begin
+      require 'concurrent_ruby_ext'
+      @@java_ext_loaded = true
+    rescue LoadError
+      warn 'Attempted to load Java extensions on unsupported platform. Continuing with pure-Ruby.'
+    end
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: concurrent-ruby-ext
 version: !ruby/object:Gem::Version
-  version: 0.1.0.pre1
+  version: 0.8.0.pre2
 platform: x86-mingw32
 authors:
 - Jerry D'Antonio
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-12-15 00:00:00.000000000 Z
+date: 2015-01-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: concurrent-ruby
@@ -16,17 +16,16 @@ dependencies:
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: 0.8.0.pre1
+        version: 0.8.0.pre2
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: 0.8.0.pre1
-description: ! "    Modern concurrency tools including agents, futures, promises,
-  thread pools, actors, supervisors, and more.\n    Inspired by Erlang, Clojure, Go,
-  JavaScript, actors, and classic concurrency patterns.\n"
+        version: 0.8.0.pre2
+description: ! "    C extensions to optimize the concurrent-ruby gem when running
+  under MRI.\n    Please see http://concurrent-ruby.com for more information.\n"
 email: jerry.dantonio@gmail.com
 executables: []
 extensions: []
@@ -38,20 +37,21 @@ files:
 - CHANGELOG.md
 - LICENSE.txt
 - README.md
-- ext/concurrent_ruby_ext/atomic_boolean.c
-- ext/concurrent_ruby_ext/atomic_boolean.h
-- ext/concurrent_ruby_ext/atomic_fixnum.c
-- ext/concurrent_ruby_ext/atomic_fixnum.h
-- ext/concurrent_ruby_ext/atomic_reference.c
-- ext/concurrent_ruby_ext/atomic_reference.h
-- ext/concurrent_ruby_ext/extconf.rb
-- ext/concurrent_ruby_ext/rb_concurrent.c
-- ext/concurrent_ruby_ext/ruby_193_compatible.h
-- lib/1.9/concurrent_ruby_ext.so
-- lib/2.0/concurrent_ruby_ext.so
+- ext/concurrent/atomic_boolean.c
+- ext/concurrent/atomic_boolean.h
+- ext/concurrent/atomic_fixnum.c
+- ext/concurrent/atomic_fixnum.h
+- ext/concurrent/atomic_reference.c
+- ext/concurrent/atomic_reference.h
+- ext/concurrent/extconf.rb
+- ext/concurrent/rb_concurrent.c
+- ext/concurrent/ruby_193_compatible.h
+- lib/concurrent/1.9/extension.so
+- lib/concurrent/2.0/extension.so
 - lib/concurrent/atomic_reference/concurrent_update_error.rb
 - lib/concurrent/atomic_reference/direct_update.rb
 - lib/concurrent/atomic_reference/numeric_cas_wrapper.rb
+- lib/extension_helper.rb
 homepage: http://www.concurrent-ruby.com
 licenses:
 - MIT
@@ -60,6 +60,7 @@ post_install_message:
 rdoc_options: []
 require_paths:
 - lib
+- ext
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ! '>='