on 0.0.1

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/.travis.yml

@@ -0,0 +1,14 @@
+language: ruby
+rvm:
+  - ree
+  - "1.8.7"
+  - "1.9.2"
+  - "1.9.3"
+  - jruby-18mode
+  - jruby-19mode
+  - rbx-18mode
+  - rbx-19mode
+  - ruby-head
+branches:
+  only:
+    - master

data/Gemfile

@@ -0,0 +1,3 @@
+source 'https://rubygems.org'
+
+gemspec

data/README.rdoc

@@ -0,0 +1,76 @@
+= On {<img src="https://secure.travis-ci.org/neopoly/on.png?branch=master" alt="Build Status" />}[https://travis-ci.org/neopoly/on]
+
+Dynamic callbacks for Ruby blocks.
+
+Gem[https://rubygems.org/gems/on] |
+Source[https://github.com/neopoly/on] |
+Documentation[http://rubydoc.info/github/neopoly/on/master/file/README.rdoc]
+
+Inspired by http://www.mattsears.com/articles/2011/11/27/ruby-blocks-as-dynamic-callbacks
+
+== Usage
+
+Basic usage.
+
+  require 'on'
+
+  def tweet(message, &block)
+    callback = On.new(:success, :failure, &block)
+    callback.call :success
+  rescue => e
+    callback.call :failure, e.message
+  end
+
+  tweet "hello world" do |callback|
+    callback.on :success do
+      # handle success
+    end
+    callback.on :failure do |error_message|
+      # handle error message
+    end
+  end
+
+
+== Usage with proc
+
+Syntatic sugar for creating an +on+ callback from Proc.
+
+  require 'on/proc'
+
+  def tweet(message, &block)
+    callback = block.on(:success, :failure)
+    callback.call :success
+  rescue => e
+    callback.call :failure, e.message
+  end
+
+  tweet "hello world" do |callback|
+    callback.on :success do
+      # handle success
+    end
+    callback.on :failure do |error_message|
+      # handle error message
+    end
+  end
+
+== Installation
+
+Add this line to your application's Gemfile:
+
+  gem 'on'
+
+And then execute:
+
+  $ bundle
+
+Or install it yourself as:
+
+  $ gem install on
+
+== 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

data/Rakefile

@@ -0,0 +1,21 @@
+require 'bundler/setup'
+require 'bundler/gem_tasks'
+
+require 'rake/testtask'
+
+task :default => :test
+
+Rake::TestTask.new do |t|
+  t.libs << "test"
+  t.test_files = FileList['test/**/*_test.rb']
+  t.verbose = true
+end
+
+# RDoc
+require 'rdoc/task'
+RDoc::Task.new do |rdoc|
+  rdoc.title    = "On"
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.main     = 'README.rdoc'
+  rdoc.rdoc_files.include('README.rdoc', 'lib/**/*.rb')
+end

data/lib/on/proc.rb

@@ -0,0 +1,26 @@
+# Syntatic sugar for creating an +on+ callback from Proc.
+#
+# = Example
+#
+#   require 'on/proc'
+# 
+#   def tweet(message, &block)
+#     callback = block.on(:success, :failure)
+#     callback.call :success
+#   rescue => e
+#     callback.call :failure, e.message
+#   end
+# 
+#   tweet "hello world" do |callback|
+#     callback.on :success do
+#       # handle success
+#     end
+#     callback.on :failure do |error_message|
+#       # handle error message
+#     end
+#   end
+class Proc
+  def on(*callbacks)
+    On.new(*callbacks, &self)
+  end
+end

data/lib/on/version.rb

@@ -0,0 +1,3 @@
+class On
+  VERSION = "0.0.1"
+end

data/lib/on.rb

@@ -0,0 +1,63 @@
+require 'on/version'
+require 'set'
+
+# Dynamic callbacks for Ruby blocks.
+#
+# = Example
+#
+#  require 'on'
+#
+#  def tweet(message, &block)
+#    callback = On.new(:success, :failure, &block)
+#    callback.call :success
+#  rescue => e
+#    callback.call :failure, e.message
+#  end
+#
+#  tweet "hello world" do |callback|
+#    callback.on :success do
+#      # handle success
+#    end
+#    callback.on :failure do |error_message|
+#      # handle error message
+#    end
+#  end
+class On
+  def initialize(*callbacks, &block)
+    raise ArgumentError, "please provide at least one callback" if callbacks.empty?
+    raise ArgumentError, "please provide a block" unless block
+    @callbacks  = Set.new(callbacks)
+    @block      = block
+  end
+
+  # Dispatch callback.
+  def call(name, *args)
+    validate_callback!(name)
+    @callback = Callback.new(name, args)
+    @block.call(self)
+  end
+
+  # Handle a callback.
+  def on(name, &block)
+    validate_callback!(name)
+    if @callback && @callback.name == name
+      block.call(*@callback.args)
+    end
+  end
+
+  Callback = Struct.new(:name, :args)
+
+  class InvalidCallback < StandardError # :nodoc:
+    def initialize(name)
+      super("Invalid callback #{name.inspect}")
+    end
+  end
+
+  private
+
+  def validate_callback!(name)
+    unless @callbacks.include?(name)
+      raise InvalidCallback, name
+    end
+  end
+end

data/on.gemspec

@@ -0,0 +1,25 @@
+# -*- encoding: utf-8 -*-
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'on/version'
+
+Gem::Specification.new do |gem|
+  gem.name          = "on"
+  gem.version       = On::VERSION
+  gem.authors       = ["Peter Suschlik"]
+  gem.email         = ["ps@neopoly.de"]
+  gem.description   = %q{Dynamic callbacks with Ruby blocks.}
+  gem.summary       = %q{Inspired by http://www.mattsears.com/articles/2011/11/27/ruby-blocks-as-dynamic-callbacks}
+  gem.homepage      = "https://github.com/neopoly/on"
+
+  gem.files         = `git ls-files`.split($/)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.require_paths = ["lib"]
+
+  gem.add_development_dependency 'rake'
+  gem.add_development_dependency 'rdoc'
+
+  gem.add_development_dependency 'minitest'
+  gem.add_development_dependency 'testem'
+end

data/on.rb

@@ -0,0 +1,52 @@
+require 'minitest/autorun'
+require 'testem'
+
+class On
+  def initialize *callbacks
+    @callbacks = callbacks
+  end
+
+  def callback(*args)
+    @current = args
+    self
+  end
+
+  def method_missing method, *args, &block
+    if @callbacks.empty? || @callbacks.include?(method)
+      if @current[0] == method
+        yield *@current[1]
+      end
+    else
+      super
+    end
+  end
+end
+
+def tweet(ok, &block)
+  block.callbacks :success, :failure
+  if ok
+    block.callback :success, 23
+  else
+    block.callback :failure, 25
+  end
+end
+
+class Proc
+  def callbacks(*names)
+    @on = On.new(*names)
+  end
+
+  def callback(*args)
+    @on ||= On.new
+    call @on.callback(*args)
+  end
+end
+
+tweet([true, false].sample) do |on|
+  on.success do |number|
+    p :success => number
+  end
+  on.failure do |number|
+    p :fail => number
+  end
+end

data/test/helper.rb

@@ -0,0 +1,4 @@
+require 'minitest/autorun'
+require 'testem'
+
+require 'on'

data/test/integration_test.rb

@@ -0,0 +1,81 @@
+require 'helper'
+
+class IntegrationTest < Testem
+
+  def tweet(message, &block)
+    callback = On.new(:success, :failure, &block)
+    case message
+    when NilClass
+      callback.call :failure, "blank"
+    when /^Sir,.*/
+      callback.call :success, message
+    end
+  end
+
+  let(:called) { [] }
+
+  before do
+    called.clear
+  end
+
+  test "it calls success" do
+    tweet "Sir, hello world" do |callback|
+      called! :method
+      callback.on :success do |message|
+        called! :success, message
+      end
+      callback.on :failure do |message|
+        called! :failure, message
+      end
+    end
+
+    assert_called [ :method ], [ :success, "Sir, hello world" ]
+  end
+
+  test "it calls failure" do
+    tweet nil do |callback|
+      called! :method
+      callback.on :success do |message|
+        called! :success, message
+      end
+      callback.on :failure do |message|
+        called! :failure, message
+      end
+    end
+
+    assert_called [ :method ], [ :failure, "blank" ]
+  end
+
+  test "no callback called" do
+    tweet "you're such a fool" do |callback|
+      called! :method
+    end
+
+    assert_called
+  end
+
+  test "invalid callback name" do
+    e = assert_raises On::InvalidCallback do
+      tweet "Sir, hi" do |callback|
+        called! :method
+
+        callback.on :invalid do
+          called! :invalid
+        end
+      end
+    end
+    assert_equal "Invalid callback :invalid", e.message
+
+    assert_called [:method]
+  end
+
+  private
+
+  def assert_called(*args)
+    assert_equal called, args
+  end
+
+  def called!(*args)
+    called << args
+  end
+end

data/test/on_proc_test.rb

@@ -0,0 +1,49 @@
+require 'helper'
+
+require 'on/proc'
+
+class OnProcTest < Testem
+  def oddeven(number, &block)
+    callback = block.on(:odd, :even)
+    if number % 2 == 0
+      callback.call :even
+    else
+      callback.call :odd
+    end
+  end
+
+  def verify(number)
+    oddeven(number) do |callback|
+      called! :block, number
+      callback.on :odd do
+        called! :odd
+      end
+      callback.on :even do
+        called! :even
+      end
+    end
+  end
+
+  let(:called) { [] }
+
+  before do
+    called.clear
+  end
+
+  test "call proc" do
+    verify(1)
+    verify(2)
+
+    assert_called [ :block, 1 ], [ :odd ], [ :block, 2 ], [ :even ]
+  end
+
+  private
+
+  def assert_called(*args)
+    assert_equal called, args
+  end
+
+  def called!(*args)
+    called << args
+  end
+end

data/test/on_test.rb

@@ -0,0 +1,96 @@
+require 'helper'
+
+class OnTest < Testem
+  let(:called) { [] }
+
+  context "initialize" do
+    test "at least one callback" do
+      e = assert_raises ArgumentError do
+        On.new
+      end
+      assert_equal "please provide at least one callback", e.message
+    end
+
+    test "block missing" do
+      e = assert_raises ArgumentError do
+        On.new :success
+      end
+      assert_equal "please provide a block", e.message
+    end
+  end
+
+  context "with an instance" do
+    before do
+      called.clear
+    end
+
+    test "calls callback w/o args" do
+      on = On.new(:success) do |callback|
+        called! :block
+        callback.on :success do |*args|
+          called! :success, *args
+        end
+      end
+      on.call :success
+
+      assert_called [ :block ], [ :success ]
+    end
+
+    test "calls callback with args" do
+      on = On.new(:success) do |callback|
+        called! :block
+        callback.on :success do |*args|
+          called! :success, *args
+        end
+      end
+      on.call :success, :foo, :bar
+
+      assert_called [ :block ], [ :success, :foo, :bar ]
+    end
+
+    test "calls invalid callback" do
+      on = On.new(:correct) {}
+      e = assert_raises On::InvalidCallback do
+        on.call :wrong
+      end
+
+      assert_equal "Invalid callback :wrong", e.message
+    end
+
+    test "handles invalid callback" do
+      on = On.new(:correct) do |callback|
+        called! :block
+        callback.on :wrong
+      end
+      e = assert_raises On::InvalidCallback do
+        on.call :correct
+      end
+
+      assert_equal "Invalid callback :wrong", e.message
+      assert_called [ :block ]
+    end
+
+    test "does not explode when nothing called" do
+      on = On.new(:something) do
+        called! :block
+      end
+      on.on :something do
+        called! :something
+      end
+
+      assert_nothing_called
+    end
+  end
+
+  def called!(*args)
+    called << args
+  end
+
+  def assert_called(*args)
+    assert_equal called, args
+  end
+
+  def assert_nothing_called
+    assert_called
+  end
+end

metadata

@@ -0,0 +1,133 @@
+--- !ruby/object:Gem::Specification
+name: 'on'
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Peter Suschlik
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-11-21 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rdoc
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: testem
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Dynamic callbacks with Ruby blocks.
+email:
+- ps@neopoly.de
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .travis.yml
+- Gemfile
+- README.rdoc
+- Rakefile
+- lib/on.rb
+- lib/on/proc.rb
+- lib/on/version.rb
+- on.gemspec
+- on.rb
+- test/helper.rb
+- test/integration_test.rb
+- test/on_proc_test.rb
+- test/on_test.rb
+homepage: https://github.com/neopoly/on
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: 4033254695859622643
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: 4033254695859622643
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.24
+signing_key: 
+specification_version: 3
+summary: Inspired by http://www.mattsears.com/articles/2011/11/27/ruby-blocks-as-dynamic-callbacks
+test_files:
+- test/helper.rb
+- test/integration_test.rb
+- test/on_proc_test.rb
+- test/on_test.rb