blox 1.0.0

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in ..gemspec
+gemspec

data/LICENSE

@@ -0,0 +1,21 @@
+Copyright 2012 Kim Burgestrand. All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification, are
+permitted provided that the following conditions are met:
+
+   1. Redistributions of source code must retain the above copyright notice, this list of
+      conditions and the following disclaimer.
+
+   2. Redistributions in binary form must reproduce the above copyright notice, this list
+      of conditions and the following disclaimer in the documentation and/or other materials
+      provided with the distribution.
+
+THIS SOFTWARE IS PROVIDED BY KIM BURGESTRAND ``AS IS'' AND ANY EXPRESS OR IMPLIED
+WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
+FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL KIM BURGESTRAND OR
+CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
+ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
+ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

data/README.md

@@ -0,0 +1,46 @@
+# Blox
+
+A tiny Ruby gem to aid you when you wish to pass multiple blocks to any ruby method.
+
+## Examples
+
+### Passing multiple blocks to a method
+
+```ruby
+def accepts_multiple_blocks(is_awesome, &block)
+  if is_awesome
+    block.yield_to(:awesome, "this is awesome!") do
+      puts "You may pass blocks to the blocks, too!"
+    end
+  else
+    block.yield_to(:not_awesome, "bad, this is bad")
+  end
+end
+
+accepts_multiple_blocks(:awesome) do |is|
+  is.awesome do |&block|
+    puts "Very awesome!"
+    block.call
+  end
+
+  is.not_awesome do
+    puts "Not so awesome"
+  end
+end
+
+accepts_multiple_blocks(:not_awesome) do |event|
+  if event.not_awesome?
+    puts ":("
+  else
+    puts "\\o/!"
+  end
+end
+```
+
+If you wish to enforce that at least one of the blocks are executed,
+you may use `block.yield\_to!` (with a bang) instead, which will raise
+an exception if no block was executed.
+
+## License
+
+2-clause (simplified) BSD license. See LICENSE for details.

data/Rakefile

@@ -0,0 +1,2 @@
+#!/usr/bin/env rake
+require "bundler/gem_tasks"

data/blox.gemspec

@@ -0,0 +1,14 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |gem|
+  gem.name          = "blox"
+  gem.authors       = ["Kim Burgestrand"]
+  gem.email         = ["kim@burgestrand.se"]
+  gem.summary       = "Blox helps you write Ruby methods that accept multiple blocks"
+  gem.homepage      = "http://github.com/Burgestrand/numerous_blocks"
+
+  gem.files         = `git ls-files`.split($\)
+  gem.test_files    = 'blox.rb'
+  gem.require_paths = ["."]
+  gem.version       = "1.0.0"
+end

data/blox.rb

@@ -0,0 +1,88 @@
+module Blox
+  def yield_to(name, *args, &block)
+    blox_call(name, *args, &block).__result__
+  end
+
+  def yield_to!(name, *args, &block)
+    blox_call(name, *args, &block).__result__!
+  end
+
+  private
+
+  def blox_call(name, *args, &block)
+    blox_block = BasicObject.new
+    (class << blox_block; self; end).instance_eval do
+      define_method(:__result__) do
+        @result
+      end
+
+      define_method(:__result__!) do
+        unless defined?(@result)
+          Kernel.raise LocalJumpError, "no block given for #{name}"
+        end
+
+        @result
+      end
+
+      define_method("#{name}?") do
+        true
+      end
+
+      define_method(:method_missing) do |method_name = :method_missing, &handler|
+        if name == method_name
+          @result = handler.call(*args, &block)
+        end
+      end
+    end
+
+    call(blox_block)
+    blox_block
+  end
+end
+
+Proc.send(:include, Blox)
+
+if $0 == __FILE__
+  require 'minitest/autorun'
+  require 'minitest/spec'
+
+  def handler_block
+    lambda do |on|
+      on.some_event do |*params|
+        [:first, params]
+      end
+
+      on.another_event do |*params|
+        [:second, params]
+      end
+    end
+  end
+
+  describe Proc do
+    describe "#yield_to" do
+      it "yields to the matching handler and returns a result" do
+        result = handler_block.yield_to(:some_event, 1, "two", :three)
+        result.must_equal [:first, [1, "two", :three]]
+        result = handler_block.yield_to(:another_event)
+        result.must_equal [:second, []]
+      end
+
+      it "does nothing if no handler was invoked" do
+        handler_block.yield_to(:nonexistant).must_equal nil
+      end
+
+      it "allows boolean operator for conditional checks" do
+        lambda { |dsl|
+          dsl.some_event?.must_equal true
+          dsl.another_event?.must_be_nil
+        }.yield_to(:some_event)
+      end
+    end
+
+    describe "#yield_to!" do
+      it "raises an error if no handler was invoked" do
+        proc { handler_block.yield_to!(:nonexistant) }.must_raise LocalJumpError
+      end
+    end
+  end
+end

metadata

@@ -0,0 +1,54 @@
+--- !ruby/object:Gem::Specification
+name: blox
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+  prerelease: 
+platform: ruby
+authors:
+- Kim Burgestrand
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-04-15 00:00:00.000000000 Z
+dependencies: []
+description: 
+email:
+- kim@burgestrand.se
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- blox.gemspec
+- blox.rb
+homepage: http://github.com/Burgestrand/numerous_blocks
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- .
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.17
+signing_key: 
+specification_version: 3
+summary: Blox helps you write Ruby methods that accept multiple blocks
+test_files:
+- blox.rb
+has_rdoc: