multiblock 0.1.0 → 0.2.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: b9d60eb3f2db6d5129cf689c5eba26bf3affc540
+  data.tar.gz: 3efa1d6b3e9c47f26a96acbd41b6a8b5ce217c13
+SHA512:
+  metadata.gz: 0dc718f167a7ab6a37434fcad69b0585612a81542451980ade57f62ba16bbc2b7674944d7d803dead950091fe61437dc1e3df320a66e5c92a8da1bbda6f44fe4
+  data.tar.gz: f7b4ade589df0f43bb8814a1c96c1ccf318ba96e72c7c4c07022d683ef7592cb23ad7159162a6e05d0d7a694aa5492831bfb3c4726c0c3a0a25932855ebd0aa3

data/.travis.yml

@@ -6,3 +6,4 @@ rvm:
   - 1.9.2
   - 1.8.7
   - ree
+  - jruby

data/README.md

@@ -20,29 +20,36 @@ Or install it yourself as:
 
 ## Usage
 
-Register blocks simply by calling methods on a multiblock instance and passing actual Ruby callable objects (procs, lamdas, etc.) along:
+Obtain multiblock wrapper instance
 
-    multiblock = Multiblock.new
-    multiblock.foo { "foo" }
-    multiblock.bar { |arg| "bar with #{arg}"}
+    wrapper = Multiblock::Wrapper.new
+
+    # or via shortcut
+    wrapper = Multiblock.wrapper
+
+Register blocks simply by calling methods on a multiblock wrapper instance and passing actual Ruby callable objects (procs, lamdas, etc.) along:
+
+    wrapper = Multiblock.wrapper
+    wrapper.foo { "foo" }
+    wrapper.bar { |arg| "bar with #{arg}"}
 
 Then call registered blocks:
 
-    multiblock.call(:foo)
+    wrapper.call(:foo)
     # => "foo"
 
-    multiblock.call(:bar, "argument")
+    wrapper.call(:bar, "argument")
     # => "bar with argument"
 
 When calling a block under unregistered name `nil` is returned by default:
 
-    multiblock.call(:bar)
+    wrapper.call(:bar)
     # => nil
 
 But you can supply a block that will be called by default in place of unregistered one:
 
-    multiblock = Multiblock.new { "default" }
-    multiblock.call(:bar)
+    wrapper = Multiblock.wrapper { "default" }
+    wrapper.call(:bar)
     # => "default"
 
 ## Real world example
@@ -59,28 +66,28 @@ Since Ruby methods accepts only one block at a time, we simulate passing multipl
 To make it work, let's define `process` method in following way:
 
     def process(message)
-      multiblock = Multiblock.new
+      wrapper = Multiblock.wrapper
 
       # wrap blocks
-      yield(multiblock)
+      yield(wrapper)
 
       # do actual processing...
 
       if result == "success"
-        multiblock.call(:success)
+        wrapper.call(:success)
       else
-        multiblock.call(:failure)
+        wrapper.call(:failure)
       end
     end
 
 Another example which kinda resembles `respond_with` feature from Ruby on Rails `ActionController`:
 
     def respond_with(object)
-      multiblock = Multiblock.new
-      yield(multiblock)
+      wrapper = Multiblock.new
+      yield(wrapper)
 
       # assume that request.format returns either 'json' or 'xml'
-      multiblock.call(request.format, object)
+      wrapper.call(request.format, object)
     end
 
     respond_with(object) do |format|

data/lib/multiblock/version.rb

@@ -0,0 +1,3 @@
+module Multiblock
+  VERSION = "0.2.0"
+end

data/lib/multiblock/wrapper.rb

@@ -0,0 +1,23 @@
+module Multiblock
+  class Wrapper < BasicObject
+    def initialize(&default)
+      default ||= ::Kernel.lambda { |*args| nil }
+
+      @blocks = ::Hash.new(default)
+    end
+
+    def method_missing(name, *args, &blk)
+      ::Kernel.raise ::ArgumentError.new("No block given when registering '#{name}' block.") if blk.nil?
+      @blocks[name.to_s] = blk
+    end
+
+    def call(name, *args)
+      @blocks[name.to_s].call(*args)
+    end
+
+    def inspect
+      "#<Multiblock::Wrapper @blocks=#{@blocks.inspect}>"
+    end
+  end
+end
+

data/lib/multiblock.rb

@@ -1,18 +1,28 @@
-require "blankslate"
+require "multiblock/version"
 
-class Multiblock < BlankSlate
-  def initialize(&default)
-    default ||= lambda { |*args| nil }
+module Multiblock
+  if defined?(BasicObject)
+    BasicObject = ::BasicObject
+  elsif defined?(BlankSlate)
+    BasicObject = ::BlankSlate
+  else
 
-    @blocks = Hash.new(default)
+    # If neither BasicObject (Ruby 1.9) nor BlankSlate (typically provided by Builder)
+    # are present, define our simple implementation
+    class BasicObject
+      instance_methods.each do |meth|
+        unless meth =~ /\A__/ || %w[ instance_exec instance_eval == equal? object_id ! != ].include?(meth)
+          undef_method(meth)
+        end
+      end
+    end
   end
 
-  def method_missing(name, *args, &blk)
-    raise ArgumentError.new("No block given when registering '#{name}' block.") unless block_given?
-    @blocks[name.to_s] = blk
-  end
-
-  def call(name, *args)
-    @blocks[name.to_s].call(*args)
+  class << self
+    def wrapper(*args)
+      Wrapper.new(*args)
+    end
   end
 end
+
+require "multiblock/wrapper"

data/multiblock.gemspec

@@ -1,10 +1,11 @@
 # coding: utf-8
 lib = File.expand_path('../lib', __FILE__)
 $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require "multiblock/version"
 
 Gem::Specification.new do |spec|
   spec.name          = "multiblock"
-  spec.version       = "0.1.0"
+  spec.version       = Multiblock::VERSION
   spec.authors       = ["Michał Szajbe"]
   spec.email         = ["michal.szajbe@gmail.com"]
   spec.description   = %q{Ruby methods can accept only one block at a time. Multiblock helps to build multiple-block wrappers that can be passed to Ruby methods in pleasant way.}
@@ -17,7 +18,6 @@ Gem::Specification.new do |spec|
   spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
   spec.require_paths = ["lib"]
 
-  spec.add_dependency "blankslate"
   spec.add_development_dependency "bundler", "~> 1.3"
   spec.add_development_dependency "rake"
   spec.add_development_dependency "rspec"

data/spec/multiblock/wrapper_spec.rb

@@ -0,0 +1,47 @@
+require "spec_helper"
+
+describe Multiblock::Wrapper do
+
+  let(:wrapper) {
+    described_class.new
+  }
+
+  it "should register block" do
+    wrapper.foo { "foo" }
+    wrapper.call(:foo).should == "foo"
+  end
+
+  it "should call registered block by String" do
+    wrapper.foo { "foo" }
+    wrapper.call("foo").should == "foo"
+  end
+
+  it "should return nil when calling unregistered block" do
+    wrapper.call(:foo).should be_nil
+  end
+
+  it "should return nil when calling unregistered block with arguments" do
+    wrapper.call(:foo).should be_nil
+  end
+
+  it "should pass arguments to called block" do
+    wrapper.foo { |arg| arg }
+    wrapper.call(:foo, "foo").should == "foo"
+  end
+
+  it "should raise ArgumentError exception when registering without block" do
+    lambda {
+      wrapper.foo
+    }.should raise_exception(ArgumentError, "No block given when registering 'foo' block.")
+  end
+
+  context "with custom default block" do
+    let(:wrapper) {
+      described_class.new { "default" }
+    }
+
+    it "should call custom default block when calling unregistered block" do
+      wrapper.call(:foo).should == "default"
+    end
+  end
+end

data/spec/multiblock_spec.rb

@@ -1,47 +1,7 @@
 require "spec_helper"
 
 describe Multiblock do
-
-  let(:multiblock) {
-    Multiblock.new
-  }
-
-  it "should register block" do
-    multiblock.foo { "foo" }
-    multiblock.call(:foo).should == "foo"
-  end
-
-  it "should call registered block by String" do
-    multiblock.foo { "foo" }
-    multiblock.call("foo").should == "foo"
-  end
-
-  it "should return nil when calling unregistered block" do
-    multiblock.call(:foo).should be_nil
-  end
-
-  it "should return nil when calling unregistered block with arguments" do
-    multiblock.call(:foo).should be_nil
-  end
-
-  it "should pass arguments to called block" do
-    multiblock.foo { |arg| arg }
-    multiblock.call(:foo, "foo").should == "foo"
-  end
-
-  it "should raise ArgumentError exception when registering without block" do
-    lambda {
-      multiblock.foo
-    }.should raise_exception(ArgumentError, "No block given when registering 'foo' block.")
-  end
-
-  context "with custom default block" do
-    let(:multiblock) {
-      Multiblock.new { "default" }
-    }
-
-    it "should call custom default block when calling unregistered block" do
-      multiblock.call(:foo).should == "default"
-    end
+  it "should construct wrapper" do
+    described_class.wrapper.inspect.should =~ /Multiblock::Wrapper/
   end
 end

metadata

@@ -1,89 +1,65 @@
---- !ruby/object:Gem::Specification 
+--- !ruby/object:Gem::Specification
 name: multiblock
-version: !ruby/object:Gem::Version 
-  hash: 27
-  prerelease: 
-  segments: 
-  - 0
-  - 1
-  - 0
-  version: 0.1.0
+version: !ruby/object:Gem::Version
+  version: 0.2.0
 platform: ruby
-authors: 
-- "Micha\xC5\x82 Szajbe"
+authors:
+- Michał Szajbe
 autorequire: 
 bindir: bin
 cert_chain: []
-
-date: 2013-04-08 00:00:00 Z
-dependencies: 
-- !ruby/object:Gem::Dependency 
-  name: blankslate
-  prerelease: false
-  requirement: &id001 !ruby/object:Gem::Requirement 
-    none: false
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        hash: 3
-        segments: 
-        - 0
-        version: "0"
-  type: :runtime
-  version_requirements: *id001
-- !ruby/object:Gem::Dependency 
+date: 2013-04-22 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
   name: bundler
-  prerelease: false
-  requirement: &id002 !ruby/object:Gem::Requirement 
-    none: false
-    requirements: 
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
     - - ~>
-      - !ruby/object:Gem::Version 
-        hash: 9
-        segments: 
-        - 1
-        - 3
-        version: "1.3"
+      - !ruby/object:Gem::Version
+        version: '1.3'
   type: :development
-  version_requirements: *id002
-- !ruby/object:Gem::Dependency 
-  name: rake
   prerelease: false
-  requirement: &id003 !ruby/object:Gem::Requirement 
-    none: false
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        hash: 3
-        segments: 
-        - 0
-        version: "0"
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
   type: :development
-  version_requirements: *id003
-- !ruby/object:Gem::Dependency 
-  name: rspec
   prerelease: false
-  requirement: &id004 !ruby/object:Gem::Requirement 
-    none: false
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        hash: 3
-        segments: 
-        - 0
-        version: "0"
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
   type: :development
-  version_requirements: *id004
-description: Ruby methods can accept only one block at a time. Multiblock helps to build multiple-block wrappers that can be passed to Ruby methods in pleasant way.
-email: 
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Ruby methods can accept only one block at a time. Multiblock helps to
+  build multiple-block wrappers that can be passed to Ruby methods in pleasant way.
+email:
 - michal.szajbe@gmail.com
 executables: []
-
 extensions: []
-
 extra_rdoc_files: []
-
-files: 
+files:
 - .gitignore
 - .rspec
 - .travis.yml
@@ -92,42 +68,37 @@ files:
 - README.md
 - Rakefile
 - lib/multiblock.rb
+- lib/multiblock/version.rb
+- lib/multiblock/wrapper.rb
 - multiblock.gemspec
+- spec/multiblock/wrapper_spec.rb
 - spec/multiblock_spec.rb
 - spec/spec_helper.rb
 homepage: http://github.com/monterail/multiblock
-licenses: 
+licenses:
 - MIT
+metadata: {}
 post_install_message: 
 rdoc_options: []
-
-require_paths: 
+require_paths:
 - lib
-required_ruby_version: !ruby/object:Gem::Requirement 
-  none: false
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      hash: 3
-      segments: 
-      - 0
-      version: "0"
-required_rubygems_version: !ruby/object:Gem::Requirement 
-  none: false
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      hash: 3
-      segments: 
-      - 0
-      version: "0"
+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: 1.8.15
+rubygems_version: 2.0.0
 signing_key: 
-specification_version: 3
+specification_version: 4
 summary: Pass multiple blocks to Ruby methods with style
-test_files: 
+test_files:
+- spec/multiblock/wrapper_spec.rb
 - spec/multiblock_spec.rb
 - spec/spec_helper.rb