lazy_record 0.2.1 → 0.2.2

data/vendor/bundle/gems/concurrent-ruby-1.0.5/lib/concurrent/atom.rb

@@ -1,222 +0,0 @@
-require 'concurrent/atomic/atomic_reference'
-require 'concurrent/collection/copy_on_notify_observer_set'
-require 'concurrent/concern/observable'
-require 'concurrent/synchronization'
-
-# @!macro [new] thread_safe_variable_comparison
-#
-#   ## Thread-safe Variable Classes
-#
-#   Each of the thread-safe variable classes is designed to solve a different
-#   problem. In general:
-#
-#   * *{Concurrent::Agent}:* Shared, mutable variable providing independent,
-#     uncoordinated, *asynchronous* change of individual values. Best used when
-#     the value will undergo frequent, complex updates. Suitable when the result
-#     of an update does not need to be known immediately.
-#   * *{Concurrent::Atom}:* Shared, mutable variable providing independent,
-#     uncoordinated, *synchronous* change of individual values. Best used when
-#     the value will undergo frequent reads but only occasional, though complex,
-#     updates. Suitable when the result of an update must be known immediately.
-#   * *{Concurrent::AtomicReference}:* A simple object reference that can be
-#     atomically. Updates are synchronous but fast. Best used when updates a
-#     simple set operations. Not suitable when updates are complex.
-#     {Concurrent::AtomicBoolean} and {Concurrent::AtomicFixnum} are similar
-#     but optimized for the given data type.
-#   * *{Concurrent::Exchanger}:* Shared, stateless synchronization point. Used
-#     when two or more threads need to exchange data. The threads will pair then
-#     block on each other until the exchange is complete.
-#   * *{Concurrent::MVar}:* Shared synchronization point. Used when one thread
-#     must give a value to another, which must take the value. The threads will
-#     block on each other until the exchange is complete.
-#   * *{Concurrent::ThreadLocalVar}:* Shared, mutable, isolated variable which
-#     holds a different value for each thread which has access. Often used as
-#     an instance variable in objects which must maintain different state
-#     for different threads.
-#   * *{Concurrent::TVar}:* Shared, mutable variables which provide
-#     *coordinated*, *synchronous*, change of *many* stated. Used when multiple
-#     value must change together, in an all-or-nothing transaction.
-
-
-module Concurrent
-
-  # Atoms provide a way to manage shared, synchronous, independent state.
-  #
-  # An atom is initialized with an initial value and an optional validation
-  # proc. At any time the value of the atom can be synchronously and safely
-  # changed. If a validator is given at construction then any new value
-  # will be checked against the validator and will be rejected if the
-  # validator returns false or raises an exception.
-  #
-  # There are two ways to change the value of an atom: {#compare_and_set} and
-  # {#swap}. The former will set the new value if and only if it validates and
-  # the current value matches the new value. The latter will atomically set the
-  # new value to the result of running the given block if and only if that
-  # value validates.
-  #
-  # ## Example
-  #
-  # ```
-  # def next_fibonacci(set = nil)
-  #   return [0, 1] if set.nil?
-  #   set + [set[-2..-1].reduce{|sum,x| sum + x }]
-  # end
-  #
-  # # create an atom with an initial value
-  # atom = Concurrent::Atom.new(next_fibonacci)
-  #
-  # # send a few update requests
-  # 5.times do
-  #   atom.swap{|set| next_fibonacci(set) }
-  # end
-  #
-  # # get the current value
-  # atom.value #=> [0, 1, 1, 2, 3, 5, 8]
-  # ```
-  #
-  # ## Observation
-  #
-  # Atoms support observers through the {Concurrent::Observable} mixin module.
-  # Notification of observers occurs every time the value of the Atom changes.
-  # When notified the observer will receive three arguments: `time`, `old_value`,
-  # and `new_value`. The `time` argument is the time at which the value change
-  # occurred. The `old_value` is the value of the Atom when the change began
-  # The `new_value` is the value to which the Atom was set when the change
-  # completed. Note that `old_value` and `new_value` may be the same. This is
-  # not an error. It simply means that the change operation returned the same
-  # value.
-  #
-  # Unlike in Clojure, `Atom` cannot participate in {Concurrent::TVar} transactions.
-  #
-  # @!macro thread_safe_variable_comparison
-  #
-  # @see http://clojure.org/atoms Clojure Atoms
-  # @see http://clojure.org/state Values and Change - Clojure's approach to Identity and State
-  class Atom < Synchronization::Object
-    include Concern::Observable
-
-    safe_initialization!
-    private(*attr_atomic(:value))
-    public :value
-
-    # Create a new atom with the given initial value.
-    #
-    # @param [Object] value The initial value
-    # @param [Hash] opts The options used to configure the atom
-    # @option opts [Proc] :validator (nil) Optional proc used to validate new
-    #   values. It must accept one and only one argument which will be the
-    #   intended new value. The validator will return true if the new value
-    #   is acceptable else return false (preferrably) or raise an exception.
-    #
-    # @!macro deref_options
-    #
-    # @raise [ArgumentError] if the validator is not a `Proc` (when given)
-    def initialize(value, opts = {})
-      super()
-      @Validator     = opts.fetch(:validator, -> v { true })
-      self.observers = Collection::CopyOnNotifyObserverSet.new
-      self.value     = value
-    end
-
-    # @!method value
-    #   The current value of the atom.
-    #
-    #   @return [Object] The current value.
-
-    alias_method :deref, :value
-
-    # Atomically swaps the value of atom using the given block. The current
-    # value will be passed to the block, as will any arguments passed as
-    # arguments to the function. The new value will be validated against the
-    # (optional) validator proc given at construction. If validation fails the
-    # value will not be changed.
-    #
-    # Internally, {#swap} reads the current value, applies the block to it, and
-    # attempts to compare-and-set it in. Since another thread may have changed
-    # the value in the intervening time, it may have to retry, and does so in a
-    # spin loop. The net effect is that the value will always be the result of
-    # the application of the supplied block to a current value, atomically.
-    # However, because the block might be called multiple times, it must be free
-    # of side effects.
-    #
-    # @note The given block may be called multiple times, and thus should be free
-    #   of side effects.
-    #
-    # @param [Object] args Zero or more arguments passed to the block.
-    #
-    # @yield [value, args] Calculates a new value for the atom based on the
-    #   current value and any supplied arguments.
-    # @yieldparam value [Object] The current value of the atom.
-    # @yieldparam args [Object] All arguments passed to the function, in order.
-    # @yieldreturn [Object] The intended new value of the atom.
-    #
-    # @return [Object] The final value of the atom after all operations and
-    #   validations are complete.
-    #
-    # @raise [ArgumentError] When no block is given.
-    def swap(*args)
-      raise ArgumentError.new('no block given') unless block_given?
-
-      loop do
-        old_value = value
-        new_value = yield(old_value, *args)
-        begin
-          break old_value unless valid?(new_value)
-          break new_value if compare_and_set(old_value, new_value)
-        rescue
-          break old_value
-        end
-      end
-    end
-
-    # Atomically sets the value of atom to the new value if and only if the
-    # current value of the atom is identical to the old value and the new
-    # value successfully validates against the (optional) validator given
-    # at construction.
-    #
-    # @param [Object] old_value The expected current value.
-    # @param [Object] new_value The intended new value.
-    #
-    # @return [Boolean] True if the value is changed else false.
-    def compare_and_set(old_value, new_value)
-      if valid?(new_value) && compare_and_set_value(old_value, new_value)
-        observers.notify_observers(Time.now, old_value, new_value)
-        true
-      else
-        false
-      end
-    end
-
-    # Atomically sets the value of atom to the new value without regard for the
-    # current value so long as the new value successfully validates against the
-    # (optional) validator given at construction.
-    #
-    # @param [Object] new_value The intended new value.
-    #
-    # @return [Object] The final value of the atom after all operations and
-    #   validations are complete.
-    def reset(new_value)
-      old_value = value
-      if valid?(new_value)
-        self.value = new_value
-        observers.notify_observers(Time.now, old_value, new_value)
-        new_value
-      else
-        old_value
-      end
-    end
-
-    private
-
-    # Is the new value valid?
-    #
-    # @param [Object] new_value The intended new value.
-    # @return [Boolean] false if the validator function returns false or raises
-    #   an exception else true
-    def valid?(new_value)
-      @Validator.call(new_value)
-    rescue
-      false
-    end
-  end
-end

data/vendor/bundle/gems/concurrent-ruby-1.0.5/lib/concurrent/atomic/abstract_thread_local_var.rb

@@ -1,66 +0,0 @@
-require 'concurrent/constants'
-
-module Concurrent
-
-  # @!macro thread_local_var
-  # @!macro internal_implementation_note
-  # @!visibility private
-  class AbstractThreadLocalVar
-
-    # @!macro thread_local_var_method_initialize
-    def initialize(default = nil, &default_block)
-      if default && block_given?
-        raise ArgumentError, "Cannot use both value and block as default value"
-      end
-
-      if block_given?
-        @default_block = default_block
-        @default = nil
-      else
-        @default_block = nil
-        @default = default
-      end
-
-      allocate_storage
-    end
-
-    # @!macro thread_local_var_method_get
-    def value
-      raise NotImplementedError
-    end
-
-    # @!macro thread_local_var_method_set
-    def value=(value)
-      raise NotImplementedError
-    end
-
-    # @!macro thread_local_var_method_bind
-    def bind(value, &block)
-      if block_given?
-        old_value = self.value
-        begin
-          self.value = value
-          yield
-        ensure
-          self.value = old_value
-        end
-      end
-    end
-
-    protected
-
-    # @!visibility private
-    def allocate_storage
-      raise NotImplementedError
-    end
-
-    # @!visibility private
-    def default
-      if @default_block
-        self.value = @default_block.call
-      else
-        @default
-      end
-    end
-  end
-end

data/vendor/bundle/gems/concurrent-ruby-1.0.5/lib/concurrent/atomic/atomic_boolean.rb

@@ -1,122 +0,0 @@
-require 'concurrent/atomic/mutex_atomic_boolean'
-require 'concurrent/synchronization'
-
-module Concurrent
-
-  ###################################################################
-
-  # @!macro [new] atomic_boolean_method_initialize
-  #
-  #   Creates a new `AtomicBoolean` with the given initial value.
-  #
-  #   @param [Boolean] initial the initial value
-
-  # @!macro [new] atomic_boolean_method_value_get
-  #
-  #   Retrieves the current `Boolean` value.
-  #
-  #   @return [Boolean] the current value
-
-  # @!macro [new] atomic_boolean_method_value_set
-  #
-  #   Explicitly sets the value.
-  #
-  #   @param [Boolean] value the new value to be set
-  #
-  #   @return [Boolean] the current value
-
-  # @!macro [new] atomic_boolean_method_true_question
-  #
-  #   Is the current value `true`
-  #
-  #   @return [Boolean] true if the current value is `true`, else false
-
-  # @!macro [new] atomic_boolean_method_false_question
-  #
-  #   Is the current value `false`
-  #
-  #   @return [Boolean] true if the current value is `false`, else false
-
-  # @!macro [new] atomic_boolean_method_make_true
-  #
-  #   Explicitly sets the value to true.
-  #
-  #   @return [Boolean] true is value has changed, otherwise false
-
-  # @!macro [new] atomic_boolean_method_make_false
-  #
-  #   Explicitly sets the value to false.
-  #
-  #   @return [Boolean] true is value has changed, otherwise false
-
-  ###################################################################
-
-  # @!macro [new] atomic_boolean_public_api
-  #
-  #   @!method initialize(initial = false)
-  #     @!macro  atomic_boolean_method_initialize
-  #
-  #   @!method value
-  #     @!macro  atomic_boolean_method_value_get
-  #
-  #   @!method value=(value)
-  #     @!macro  atomic_boolean_method_value_set
-  #
-  #   @!method true?
-  #     @!macro  atomic_boolean_method_true_question
-  #
-  #   @!method false?
-  #     @!macro  atomic_boolean_method_false_question
-  #
-  #   @!method make_true
-  #     @!macro  atomic_boolean_method_make_true
-  #
-  #   @!method make_false
-  #     @!macro  atomic_boolean_method_make_false
-
-  ###################################################################
-
-  # @!visibility private
-  # @!macro internal_implementation_note
-  AtomicBooleanImplementation = case
-                                when defined?(JavaAtomicBoolean)
-                                  JavaAtomicBoolean
-                                when defined?(CAtomicBoolean)
-                                  CAtomicBoolean
-                                else
-                                  MutexAtomicBoolean
-                                end
-  private_constant :AtomicBooleanImplementation
-
-  # @!macro [attach] atomic_boolean
-  #
-  #   A boolean value that can be updated atomically. Reads and writes to an atomic
-  #   boolean and thread-safe and guaranteed to succeed. Reads and writes may block
-  #   briefly but no explicit locking is required.
-  #
-  #   @!macro thread_safe_variable_comparison
-  #
-  #       Testing with ruby 2.1.2
-  #       Testing with Concurrent::MutexAtomicBoolean...
-  #         2.790000   0.000000   2.790000 (  2.791454)
-  #       Testing with Concurrent::CAtomicBoolean...
-  #         0.740000   0.000000   0.740000 (  0.740206)
-  #
-  #       Testing with jruby 1.9.3
-  #       Testing with Concurrent::MutexAtomicBoolean...
-  #         5.240000   2.520000   7.760000 (  3.683000)
-  #       Testing with Concurrent::JavaAtomicBoolean...
-  #         3.340000   0.010000   3.350000 (  0.855000)
-  #
-  #   @see http://docs.oracle.com/javase/7/docs/api/java/util/concurrent/atomic/AtomicBoolean.html java.util.concurrent.atomic.AtomicBoolean
-  #
-  # @!macro atomic_boolean_public_api
-  class AtomicBoolean < AtomicBooleanImplementation
-    # @return [String] Short string representation.
-    def to_s
-      format '<#%s:0x%x value:%s>', self.class, object_id << 1, value
-    end
-
-    alias_method :inspect, :to_s
-  end
-end

data/vendor/bundle/gems/concurrent-ruby-1.0.5/lib/concurrent/atomic/atomic_fixnum.rb

@@ -1,139 +0,0 @@
-require 'concurrent/atomic/mutex_atomic_fixnum'
-require 'concurrent/synchronization'
-
-module Concurrent
-
-  ###################################################################
-
-  # @!macro [new] atomic_fixnum_method_initialize
-  #
-  #   Creates a new `AtomicFixnum` with the given initial value.
-  #
-  #   @param [Fixnum] initial the initial value
-  #   @raise [ArgumentError] if the initial value is not a `Fixnum`
-
-  # @!macro [new] atomic_fixnum_method_value_get
-  #
-  #   Retrieves the current `Fixnum` value.
-  #
-  #   @return [Fixnum] the current value
-
-  # @!macro [new] atomic_fixnum_method_value_set
-  #
-  #   Explicitly sets the value.
-  #
-  #   @param [Fixnum] value the new value to be set
-  #
-  #   @return [Fixnum] the current value
-  #
-  #   @raise [ArgumentError] if the new value is not a `Fixnum`
-
-  # @!macro [new] atomic_fixnum_method_increment
-  #
-  #   Increases the current value by the given amount (defaults to 1).
-  #
-  #   @param [Fixnum] delta the amount by which to increase the current value
-  #
-  #   @return [Fixnum] the current value after incrementation
-
-  # @!macro [new] atomic_fixnum_method_decrement
-  #
-  #   Decreases the current value by the given amount (defaults to 1).
-  #
-  #   @param [Fixnum] delta the amount by which to decrease the current value
-  #
-  #   @return [Fixnum] the current value after decrementation
-
-  # @!macro [new] atomic_fixnum_method_compare_and_set
-  #
-  #   Atomically sets the value to the given updated value if the current
-  #   value == the expected value.
-  #
-  #   @param [Fixnum] expect the expected value
-  #   @param [Fixnum] update the new value
-  #
-  #   @return [Fixnum] true if the value was updated else false
-
-  # @!macro [new] atomic_fixnum_method_update
-  #
-  #   Pass the current value to the given block, replacing it
-  #   with the block's result. May retry if the value changes
-  #   during the block's execution.
-  #
-  #   @yield [Object] Calculate a new value for the atomic reference using
-  #     given (old) value
-  #   @yieldparam [Object] old_value the starting value of the atomic reference
-  #
-  #   @return [Object] the new value
-
-  ###################################################################
-
-  # @!macro [new] atomic_fixnum_public_api
-  #
-  #   @!method initialize(initial = 0)
-  #     @!macro atomic_fixnum_method_initialize
-  #
-  #   @!method value
-  #     @!macro atomic_fixnum_method_value_get
-  #
-  #   @!method value=(value)
-  #     @!macro atomic_fixnum_method_value_set
-  #
-  #   @!method increment
-  #     @!macro atomic_fixnum_method_increment
-  #
-  #   @!method decrement
-  #     @!macro atomic_fixnum_method_decrement
-  #
-  #   @!method compare_and_set(expect, update)
-  #     @!macro atomic_fixnum_method_compare_and_set
-  #
-  #   @!method update
-  #     @!macro atomic_fixnum_method_update
-
-  ###################################################################
-
-  # @!visibility private
-  # @!macro internal_implementation_note
-  AtomicFixnumImplementation = case
-                               when defined?(JavaAtomicFixnum)
-                                 JavaAtomicFixnum
-                               when defined?(CAtomicFixnum)
-                                 CAtomicFixnum
-                               else
-                                 MutexAtomicFixnum
-                               end
-  private_constant :AtomicFixnumImplementation
-
-  # @!macro [attach] atomic_fixnum
-  #
-  #   A numeric value that can be updated atomically. Reads and writes to an atomic
-  #   fixnum and thread-safe and guaranteed to succeed. Reads and writes may block
-  #   briefly but no explicit locking is required.
-  #
-  #   @!macro thread_safe_variable_comparison
-  #
-  #       Testing with ruby 2.1.2
-  #       Testing with Concurrent::MutexAtomicFixnum...
-  #         3.130000   0.000000   3.130000 (  3.136505)
-  #       Testing with Concurrent::CAtomicFixnum...
-  #         0.790000   0.000000   0.790000 (  0.785550)
-  #
-  #       Testing with jruby 1.9.3
-  #       Testing with Concurrent::MutexAtomicFixnum...
-  #         5.460000   2.460000   7.920000 (  3.715000)
-  #       Testing with Concurrent::JavaAtomicFixnum...
-  #         4.520000   0.030000   4.550000 (  1.187000)
-  #
-  #   @see http://docs.oracle.com/javase/7/docs/api/java/util/concurrent/atomic/AtomicLong.html java.util.concurrent.atomic.AtomicLong
-  #
-  # @!macro atomic_fixnum_public_api
-  class AtomicFixnum < AtomicFixnumImplementation
-    # @return [String] Short string representation.
-    def to_s
-      format '<#%s:0x%x value:%s>', self.class, object_id << 1, value
-    end
-
-    alias_method :inspect, :to_s
-  end
-end