tent 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 17beb0fbd92d9a1a66c936bdcfccf5bd3ea0f3a3
+  data.tar.gz: 61916d558c1534948c0dd59766b77b0d0b2eeaf5
+SHA512:
+  metadata.gz: c98d8e56830c23af52be5c34fda1e265ec75030d61211c5f64af15659b521b03b6fcfe98ba27162f193104c1588b7bbad9909e7aa0e47d44cbf20bb6171cc084
+  data.tar.gz: 0451940ea06ef1f365cf16b88ee757b6576a3b4121eeaa01179b05cbdc451bc9d05e4d09893dac558047d1fcac768624ebefcb520f65ff03be13c01b65564cdd

data/lib/tent.rb

@@ -0,0 +1,86 @@
+require 'monitor'
+
+# Provides a way of deferring method calls to
+# an underlying object.
+class Tent
+  include MonitorMixin
+
+  # Yields a `Tent` over the given `underlying`.
+  # By default, commits to the underlying when
+  # the block closes.
+  def self.cover(underlying, auto_commit = true, &block)
+    new(underlying).tap do |instance|
+      yield instance
+      instance.commit! if auto_commit
+    end
+  end
+
+  def initialize(underlying)
+    # Maintain a reference to the underlying:
+    @underlying = underlying
+    # Collect calls for the underlying:
+    @buffer = []
+    # Allow monitor mixin to initialise:
+    super()
+  end
+
+  # Provide access to the underlying object.
+  def direct
+    @underlying
+  end
+
+  # Clears the buffer. Optionally, only clears
+  # from the buffer.
+  def discard!(*filters)
+    process_buffer(false, filters)
+  end
+
+  # Commits the buffered calls to the underlying.
+  def commit!(*filters)
+    process_buffer(true, filters)
+  end
+
+  private
+
+  # Wrap calls to the underlying.
+  class BufferedCall
+    attr_reader :name, :args, :block
+
+    def initialize(name, *args, &block)
+      @name  = name
+      @args  = args
+      @block = block
+    end
+
+    def apply_to(target)
+      block ? target.send(name, *args, &block) : target.send(name, *args)
+    end
+
+    def matched_by?(filters)
+      0 == filters.length || filters.include?(name)
+    end
+  end
+
+  # Clear from the buffer elements matching any
+  # of the `filters`. Will commit those elements
+  # to the underlying if `commit` is true.
+  def process_buffer(commit, filters)
+    synchronize do
+      @buffer.reject! do |call|
+        if call.matched_by?(filters)
+          call.apply_to(direct) if commit
+          true # Remove from buffer
+        end
+      end
+    end
+  end
+
+  def method_missing(method, *args, &block)
+    return super unless direct.respond_to?(method)
+
+    synchronize do
+      @buffer << BufferedCall.new(method, *args, &block)
+      self # Make buffering chainable.
+    end
+  end
+end

metadata

@@ -0,0 +1,72 @@
+--- !ruby/object:Gem::Specification
+name: tent
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Josh Pencheon
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-09-14 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 5.4.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 5.4.0
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Apply or forget interaction with a wrapped object
+email: 
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/tent.rb
+homepage: http://rubygems.org/gems/tent
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: Conditional object wrapping
+test_files: []