concurrent-ruby 0.7.0-java

data/LICENSE.txt

@@ -0,0 +1,21 @@
+Copyright (c) Jerry D'Antonio -- released under the MIT license.
+
+http://www.opensource.org/licenses/mit-license.php  
+
+Permission is hereby granted, free of charge, to any person obtaining a copy  
+of this software and associated documentation files (the "Software"), to deal  
+in the Software without restriction, including without limitation the rights  
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell  
+copies of the Software, and to permit persons to whom the Software is  
+furnished to do so, subject to the following conditions:  
+ 
+The above copyright notice and this permission notice shall be included in  
+all copies or substantial portions of the Software.  
+ 
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR  
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,  
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE  
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER  
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,  
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN  
+THE SOFTWARE. 

data/README.md

@@ -0,0 +1,217 @@
+# Concurrent Ruby
+[![Gem Version](https://badge.fury.io/rb/concurrent-ruby.png)](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) [![Coverage Status](https://coveralls.io/repos/ruby-concurrency/concurrent-ruby/badge.png)](https://coveralls.io/r/ruby-concurrency/concurrent-ruby) [![Code Climate](https://codeclimate.com/github/ruby-concurrency/concurrent-ruby.png)](https://codeclimate.com/github/ruby-concurrency/concurrent-ruby) [![Inline docs](http://inch-ci.org/github/ruby-concurrency/concurrent-ruby.png)](http://inch-ci.org/github/ruby-concurrency/concurrent-ruby) [![Dependency Status](https://gemnasium.com/ruby-concurrency/concurrent-ruby.png)](https://gemnasium.com/ruby-concurrency/concurrent-ruby) [![License](http://img.shields.io/license/MIT.png?color=green)](http://opensource.org/licenses/MIT) [![Gitter chat](https://badges.gitter.im/ruby-concurrency/concurrent-ruby.png)](https://gitter.im/ruby-concurrency/concurrent-ruby)
+
+<table>
+  <tr>
+    <td align="left" valign="top">
+      <p>
+        Modern concurrency tools for Ruby. Inspired by
+        <a href="http://www.erlang.org/doc/reference_manual/processes.html">Erlang</a>,
+        <a href="http://clojure.org/concurrent_programming">Clojure</a>,
+        <a href="http://akka.io/">Scala</a>,
+        <a href="http://www.haskell.org/haskellwiki/Applications_and_libraries/Concurrency_and_parallelism#Concurrent_Haskell">Haskell</a>,
+        <a href="http://blogs.msdn.com/b/dsyme/archive/2010/02/15/async-and-parallel-design-patterns-in-f-part-3-agents.aspx">F#</a>,
+        <a href="http://msdn.microsoft.com/en-us/library/vstudio/hh191443.aspx">C#</a>,
+        <a href="http://docs.oracle.com/javase/7/docs/api/java/util/concurrent/package-summary.html">Java</a>,
+        and classic concurrency patterns.
+      </p>
+      <p>
+        The design goals of this gem are:
+        <ul>
+          <li>Be an 'unopinionated' toolbox that provides useful utilities without debating which is better or why</li>
+          <li>Remain free of external gem dependencies</li>
+          <li>Stay true to the spirit of the languages providing inspiration</li>
+          <li>But implement in a way that makes sense for Ruby</li>
+          <li>Keep the semantics as idiomatic Ruby as possible</li>
+          <li>Support features that make sense in Ruby</li>
+          <li>Exclude features that don't make sense in Ruby</li>
+          <li>Be small, lean, and loosely coupled</li>
+        </ul>
+      </p>
+    </td>
+    <td align="right" valign="top">
+      <img src="https://raw.githubusercontent.com/wiki/ruby-concurrency/concurrent-ruby/logo/concurrent-ruby-logo-300x300.png"/>
+    </td>
+  </tr>
+</table>
+
+## Features & Documentation
+
+Please see the [Concurrent Ruby Wiki](https://github.com/ruby-concurrency/concurrent-ruby/wiki)
+or the [API documentation](http://ruby-concurrency.github.io/concurrent-ruby/frames.html)
+for more information or join our [mailing list](http://groups.google.com/group/concurrent-ruby).
+
+There are many concurrency abstractions in this library. These abstractions can be broadly categorized
+into several general groups:
+
+* Asynchronous concurrency abstractions including
+  [Agent](http://ruby-concurrency.github.io/concurrent-ruby/Concurrent/Agent.html),
+  [Async](http://ruby-concurrency.github.io/concurrent-ruby/Concurrent/Async.html),
+  [Future](http://ruby-concurrency.github.io/concurrent-ruby/Concurrent/Future.html),
+  [Promise](http://ruby-concurrency.github.io/concurrent-ruby/Concurrent/Promise.html),
+  [ScheduledTask](http://ruby-concurrency.github.io/concurrent-ruby/Concurrent/ScheduledTask.html),
+  and [TimerTask](http://ruby-concurrency.github.io/concurrent-ruby/Concurrent/TimerTask.html) 
+* Fast, light-weight [Actor model](http://ruby-concurrency.github.io/concurrent-ruby/Concurrent/Actor.html) implementation. 
+* Thread-safe variables including
+  [I-Structures](http://ruby-concurrency.github.io/concurrent-ruby/Concurrent/IVar.html),
+  [M-Structures](http://ruby-concurrency.github.io/concurrent-ruby/Concurrent/MVar.html),
+  [thread-local variables](http://ruby-concurrency.github.io/concurrent-ruby/Concurrent/ThreadLocalVar.html),
+  and [software transactional memory](https://github.com/ruby-concurrency/concurrent-ruby/wiki/TVar-(STM))
+* Thread synchronization classes and algorithms including
+  [condition](http://ruby-concurrency.github.io/concurrent-ruby/Concurrent/Condition.html),
+  [countdown latch](http://ruby-concurrency.github.io/concurrent-ruby/Concurrent/CountDownLatch.html),
+  [dataflow](https://github.com/ruby-concurrency/concurrent-ruby/wiki/Dataflow), 
+  [event](http://ruby-concurrency.github.io/concurrent-ruby/Concurrent/Event.html),
+  [exchanger](http://ruby-concurrency.github.io/concurrent-ruby/Concurrent/Exchanger.html),
+  and [timeout](http://ruby-concurrency.github.io/concurrent-ruby/Concurrent.html#timeout-class_method)
+* Java-inspired [executors](https://github.com/ruby-concurrency/concurrent-ruby/wiki/Thread%20Pools) (thread pools and more)
+* [And many more](http://ruby-concurrency.github.io/concurrent-ruby/index.html)...
+
+### Semantic Versioning
+
+This gem adheres to the rules of [semantic versioning](http://semver.org/).
+
+### Supported Ruby versions
+
+MRI 1.9.3, 2.0, 2.1, JRuby (1.9 mode), and Rubinius 2.x.
+This library is pure Ruby and has no gem dependencies.
+It should be fully compatible with any interpreter that is compliant with Ruby 1.9.3 or newer.
+
+### Examples
+
+Many more code examples can be found in the documentation for each class (linked above).
+
+Future and ScheduledTask:
+
+```ruby    
+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"
+    data = open(uri) {|f| f.collect{|line| line.strip } }
+    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
+```
+
+Actor:
+
+```ruby
+class Counter < Concurrent::Actor::Context
+  # Include context of an actor which gives this class access to reference
+  # and other information about the actor
+
+  # use initialize as you wish
+  def initialize(initial_value)
+    @count = initial_value
+  end
+
+  # override on_message to define actor's behaviour
+  def on_message(message)
+    if Integer === message
+      @count += message
+    end
+  end
+end #
+
+# Create new actor naming the instance 'first'.
+# Return value is a reference to the actor, the actual actor is never returned.
+counter = Counter.spawn(:first, 5)
+
+# Tell a message and forget returning self.
+counter.tell(1)
+counter << 1
+# (First counter now contains 7.)
+
+# Send a messages asking for a result.
+counter.ask(0).class
+counter.ask(0).value
+```
+
+## Installing and Building
+
+This gem includes several platform-specific optimizations. To reduce the possibility of
+compilation errors, we provide pre-compiled gem packages for several platforms as well
+as a pure-Ruby build. Installing the gem should be no different than installing any other
+Rubygems-hosted gem.
+
+### Installing
+
+```shell
+gem install concurrent-ruby
+```
+
+or add the following line to Gemfile:
+
+```ruby
+gem 'concurrent-ruby'
+```
+
+and run `bundle install` from your shell.
+
+### Building
+
+Because we provide pre-compiled gem builds, users should never need to build the gem manually.
+The build process for this gem is completely automated using open source tools. All of
+the automation components are available in the [ruby-concurrency/rake-compiler-dev-box](https://github.com/ruby-concurrency/rake-compiler-dev-box)
+GitHub repository.
+
+This gem will compile native C code under MRI and native Java code under JRuby. It is
+also possible to build a pure-Ruby version. All builds have identical functionality.
+The only difference is performance. Additionally, pure-Ruby classes are always available,
+even when using the native optimizations. Please see the [documentation](http://ruby-concurrency.github.io/concurrent-ruby/)
+for more details.
+
+To build and package the gem using MRI or JRuby, install the necessary build dependencies and run:
+
+```shell
+bundle exec rake compile
+bundle exec rake build
+```
+
+To build and package a pure-Ruby gem, on *any* platform and interpreter
+(including MRI and JRuby), run:
+
+```shell
+BUILD_PURE_RUBY='true' bundle exec rake build
+```
+
+## Maintainers
+
+* [Jerry D'Antonio](https://github.com/jdantonio)
+* [Michele Della Torre](https://github.com/mighe)
+* [Chris Seaton](https://github.com/chrisseaton)
+* [Lucas Allan](https://github.com/lucasallan)
+* [Petr Chalupa](https://github.com/pitr-ch)
+
+### Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request
+
+## License and Copyright
+
+*Concurrent Ruby* is free software released under the [MIT License](http://www.opensource.org/licenses/MIT).
+
+The *Concurrent Ruby* [logo](https://github.com/ruby-concurrency/concurrent-ruby/wiki/Logo)
+was designed by [David Jones](https://twitter.com/zombyboy).
+It is Copyright &copy; 2014 [Jerry D'Antonio](https://twitter.com/jerrydantonio). All Rights Reserved.

data/lib/concurrent.rb

@@ -0,0 +1,45 @@
+require 'concurrent/version'
+
+require 'concurrent/configuration'
+
+require 'concurrent/atomics'
+require 'concurrent/channels'
+require 'concurrent/collections'
+require 'concurrent/executors'
+require 'concurrent/utilities'
+
+require 'concurrent/actor'
+require 'concurrent/atomic'
+require 'concurrent/lazy_register'
+require 'concurrent/agent'
+require 'concurrent/async'
+require 'concurrent/dataflow'
+require 'concurrent/delay'
+require 'concurrent/dereferenceable'
+require 'concurrent/errors'
+require 'concurrent/exchanger'
+require 'concurrent/future'
+require 'concurrent/ivar'
+require 'concurrent/mvar'
+require 'concurrent/obligation'
+require 'concurrent/observable'
+require 'concurrent/options_parser'
+require 'concurrent/promise'
+require 'concurrent/scheduled_task'
+require 'concurrent/timer_task'
+require 'concurrent/tvar'
+
+# Modern concurrency tools for Ruby. Inspired by Erlang, Clojure, Scala, Haskell,
+# F#, C#, Java, and classic concurrency patterns.
+# 
+# The design goals of this gem are:
+# 
+# * Stay true to the spirit of the languages providing inspiration
+# * But implement in a way that makes sense for Ruby
+# * Keep the semantics as idiomatic Ruby as possible
+# * Support features that make sense in Ruby
+# * Exclude features that don't make sense in Ruby
+# * Be small, lean, and loosely coupled
+module Concurrent
+
+end

data/lib/concurrent/actor.rb

@@ -0,0 +1,104 @@
+require 'concurrent/configuration'
+require 'concurrent/executor/serialized_execution'
+require 'concurrent/ivar'
+require 'concurrent/logging'
+require 'concurrent/atomic/synchronization'
+
+module Concurrent
+  # TODO https://github.com/celluloid/celluloid/wiki/Supervision-Groups
+
+  # TODO doc
+  # - what happens if I try to supervise using a normal Context?
+
+
+  # {include:file:doc/actor/main.md}
+  module Actor
+
+    require 'concurrent/actor/type_check'
+    require 'concurrent/actor/errors'
+    require 'concurrent/actor/public_delegations'
+    require 'concurrent/actor/internal_delegations'
+    require 'concurrent/actor/envelope'
+    require 'concurrent/actor/reference'
+    require 'concurrent/actor/core'
+    require 'concurrent/actor/behaviour'
+    require 'concurrent/actor/context'
+
+    require 'concurrent/actor/default_dead_letter_handler'
+    require 'concurrent/actor/root'
+    require 'concurrent/actor/utils'
+
+    # @return [Reference, nil] current executing actor if any
+    def self.current
+      Thread.current[:__current_actor__]
+    end
+
+    @root = Delay.new do
+      Core.new(parent: nil, name: '/', class: Root, initialized: ivar = IVar.new).reference.tap do
+        ivar.no_error!
+      end
+    end
+
+    # A root actor, a default parent of all actors spawned outside an actor
+    def self.root
+      @root.value!
+    end
+
+    # Spawns a new actor.
+    #
+    # @example simple
+    #   Actor.spawn(AdHoc, :ping1) { -> message { message } }
+    #
+    # @example complex
+    #   Actor.spawn name:     :ping3,
+    #                 class:    AdHoc,
+    #                 args:     [1]
+    #                 executor: Concurrent.configuration.global_task_pool do |add|
+    #     lambda { |number| number + add }
+    #   end
+    #
+    # @param block for context_class instantiation
+    # @param args see {.spawn_optionify}
+    # @return [Reference] never the actual actor
+    def self.spawn(*args, &block)
+      experimental_acknowledged? or
+          warn '[EXPERIMENTAL] A full release of `Actor`, is expected in the 0.7.0 release.'
+
+      if Actor.current
+        Core.new(spawn_optionify(*args).merge(parent: Actor.current), &block).reference
+      else
+        root.ask([:spawn, spawn_optionify(*args), block]).value
+      end
+    end
+
+    # as {.spawn} but it'll raise when Actor not initialized properly
+    def self.spawn!(*args, &block)
+      spawn(spawn_optionify(*args).merge(initialized: ivar = IVar.new), &block).tap { ivar.no_error! }
+    end
+
+    # @overload spawn_optionify(context_class, name, *args)
+    #   @param [Context] context_class to be spawned
+    #   @param [String, Symbol] name of the instance, it's used to generate the {Core#path} of the actor
+    #   @param args for context_class instantiation
+    # @overload spawn_optionify(opts)
+    #   see {Core#initialize} opts
+    def self.spawn_optionify(*args)
+      if args.size == 1 && args.first.is_a?(Hash)
+        args.first
+      else
+        { class: args[0],
+          name:  args[1],
+          args:  args[2..-1] }
+      end
+    end
+
+    # call this to disable experimental warning
+    def self.i_know_it_is_experimental!
+      @experimental_acknowledged = true
+    end
+
+    def self.experimental_acknowledged?
+      !!@experimental_acknowledged
+    end
+  end
+end

data/lib/concurrent/actor/behaviour.rb

@@ -0,0 +1,70 @@
+module Concurrent
+  module Actor
+
+    # Actors have modular architecture, which is achieved by combining a light core with chain of
+    # behaviours. Each message or internal event propagates through the chain allowing the
+    # behaviours react based on their responsibility. listing few as an example:
+    #
+    # -   {Behaviour::Linking}:
+    #
+    #     > {include:Actor::Behaviour::Linking}
+    #
+    # -   {Behaviour::Awaits}:
+    #
+    #     > {include:Actor::Behaviour::Awaits}
+    #
+    # See {Behaviour}'s namespace fo other behaviours.
+    # If needed new behaviours can be added, or old one removed to get required behaviour.
+    module Behaviour
+      MESSAGE_PROCESSED = Object.new
+
+      require 'concurrent/actor/behaviour/abstract'
+      require 'concurrent/actor/behaviour/awaits'
+      require 'concurrent/actor/behaviour/buffer'
+      require 'concurrent/actor/behaviour/errors_on_unknown_message'
+      require 'concurrent/actor/behaviour/executes_context'
+      require 'concurrent/actor/behaviour/linking'
+      require 'concurrent/actor/behaviour/pausing'
+      require 'concurrent/actor/behaviour/removes_child'
+      require 'concurrent/actor/behaviour/sets_results'
+      require 'concurrent/actor/behaviour/supervised'
+      require 'concurrent/actor/behaviour/supervising'
+      require 'concurrent/actor/behaviour/termination'
+      require 'concurrent/actor/behaviour/terminates_children'
+
+      def self.basic_behaviour_definition
+        [*base,
+         *user_messages(:terminate!)]
+      end
+
+      def self.restarting_behaviour_definition
+        [*base,
+         *supervised,
+         [Behaviour::Supervising, [:reset!, :one_for_one]],
+         *user_messages(:pause!)]
+      end
+
+      def self.base
+        [[SetResults, [:terminate!]],
+         # has to be before Termination to be able to remove children form terminated actor
+         [RemovesChild, []],
+         [Termination, []],
+         [TerminatesChildren, []],
+         [Linking, []]]
+      end
+
+      def self.supervised
+        [[Supervised, []],
+         [Pausing, []]]
+      end
+
+      def self.user_messages(on_error)
+        [[Buffer, []],
+         [SetResults, [on_error]],
+         [Awaits, []],
+         [ExecutesContext, []],
+         [ErrorsOnUnknownMessage, []]]
+      end
+    end
+  end
+end