triggerful 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: fd53d3d5522d0f26ab9e548d60d8293f7d8436b4
+  data.tar.gz: d12cc610d506493d41beb7af9548849ca3ea199c
+SHA512:
+  metadata.gz: 21bdeba842b1ad98bd72c409023bec9fbde21341606578be81a71a1cee1e56623b49c1a005e73d72b647377bef75ef5289ef0078eeaa9c956e426f9577127dbd
+  data.tar.gz: 8dbb63237849d91e9ab155ae6baae9f6073fb3dcc613494da87d813686e86b5e83c00f300aff2234f6444ae60da970dfca54b5f4e866986173dbc0a31dfc85cd

data/lib/triggerful.rb

@@ -0,0 +1,156 @@
+=begin
+  # USAGE:
+  
+  $foobar = 0
+  
+  def foo
+    $foobar += 1
+  end
+  
+  def bar
+    puts $foobar
+  end
+  
+  # create Trigger and callback, then trigger the Trigger
+  _foo = Trigger.new(:foo, :bar)
+  _foo.trigger
+  
+  # create a method to determine if bar has been called before
+  bar_called? = false
+  def bar_called
+    bar_called = true
+  end
+  
+  # create a callback for the callback
+  _bar = Trigger.new(:bar, :bar_called)
+  
+  # replace old callback with new one (note that no symbol was used for the callback)
+  _foo.remove(:bar)
+  _foo.add(_bar)
+  
+  # methods are not called when added to Trigger callbacks, only when triggered
+  puts bar_called?
+  _foo.trigger
+  puts bar_called?
+=end
+
+class Trigger
+  def initialize event, *callbacks
+    @callbacks = callbacks
+    @event = event
+    
+    if @callbacks[0].is_a? TrueClass
+      @progression = true
+      @callbacks.delete_at(0)
+    elsif @callbacks[0].is_a? FalseClass
+      @progression = false
+      @callbacks.delete_at(0)
+    else
+      @progression = false
+    end
+  end
+  
+  def trigger(*args)
+    case @event.class.to_s
+    when 'Proc'
+      event_data = @event.call
+    when 'Method'
+      event_data = @event.call
+    else
+      event_data = self.method(@event).call(*args)
+    end
+    @callbacks.each do |callback|
+      if callback.instance_of? Trigger
+        if @progression
+          callback.trigger(*args, event_data)
+        else
+          callback.trigger(*args)
+        end
+      else
+        case callback.class.to_s
+        when 'Proc'
+          if @progression
+            callback.call(*args, event_data)
+          else
+            callback.call(*args)
+          end
+        when 'Method'
+          if @progression
+            callback.call(*args, event_data)
+          else
+            callback.call(*args)
+          end
+        else
+          if @progression
+            method(callback).call(*args, event_data)
+          else
+            method(callback).call(*args)
+          end
+        end
+      end
+    end
+  end
+  
+  #triggers the callbacks without executing the original method
+  def silent_trigger(*args)
+    @callbacks.each do |callback|
+      if callback.instance_of? Trigger
+        callback.trigger(*args)
+      else
+        case callback.class.to_s
+        when 'Proc'
+          callback.call
+        else
+          method(callback).call(*args)
+        end
+      end
+    end
+  end
+  
+  # add callback(s) to instance
+  def add(*callbacks)
+    @callbacks.concat callbacks
+  end
+  
+  def insert(index, *callbacks)
+    @callbacks.insert(index, callbacks)
+  end
+  
+  # remove callback(s) from instance
+  def remove(*callbacks)
+    callbacks.each do |callback|
+      @callbacks.delete_at(@callbacks.index(callback) || @callbacks.length)
+    end
+  end
+  
+  def delete_at(index)
+    @callbacks.delete_at(index)
+  end
+  
+  def remove_all
+    @callbacks = []
+  end
+  
+  # fetch info from instance
+  def index(callback)
+    @callbacks.index(callback)
+  end
+  
+  def event_name
+    @event
+  end
+  
+  def list
+    @callbacks
+  end
+end
+
+=begin
+  A short scrib of notes for humans
+    
+    Semantically speaking, caller, event, and trigger are synonymous.
+    The trigger that is triggered is similar to a javascript event
+    that is listened to. The callbacks would be called from the
+    caller, ie the event/trigger.
+    
+=end

metadata

@@ -0,0 +1,45 @@
+--- !ruby/object:Gem::Specification
+name: triggerful
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Andrew Bob Garrett
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-10-07 00:00:00.000000000 Z
+dependencies: []
+description: Create callbacks to methods that you can easily remove. Quite useful
+  for lightweight event based programming. Even the medic agrees.
+email: andrew@cocodesign.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/triggerful.rb
+homepage: http://rubygems.org/gems/
+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.0.6
+signing_key: 
+specification_version: 4
+summary: Triggerful is a gem used for creating modular callbacks.
+test_files: []