publisher 1.1.1 → 1.1.2

data/.gitignore

@@ -0,0 +1,12 @@
+pkg
+*.swp
+*.log
+doc
+coverage
+.DS_Store
+.yardoc
+tmp
+tags
+ctags
+.bundle
+*.lock

data/Gemfile

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

data/Manifest.txt

@@ -1,6 +1,6 @@
 History.txt
 Manifest.txt
-README.txt
+README.rdoc
 Rakefile
 lib/publisher.rb
 test/publisher_test.rb

data/{README.txt → README.rdoc}

@@ -2,20 +2,21 @@
 
 * http://atomicobject.github.com/publisher
 * http://github.com/atomicobject/publisher
-* http://gemcutter.com/gems/publisher
+* http://rubygems.org/gems/publisher
+* http://rubydoc.info/gems/publisher/frames
 
-== DESCRIPTION:
+== Description
   
 publisher is a module for extending a class with event subscription and firing capabilities.  This is helpful for implementing objects that participate in the Observer design pattern.
 
-== FEATURES:
+== Features
   
 * Nice syntax for declaring events that can be subscribed for
 * Convenient event firing syntax
 * Subscribe / unsubscribe functionality
 * Several method name aliases give you the flexibility to make your code more readable (eg, *fire*, *notify*, *emit*)
 
-== SYNOPSIS:
+== Synopsis
 
   require 'rubygems'
   require 'publisher'
@@ -47,15 +48,15 @@ publisher is a module for extending a class with event subscription and firing c
   holder.add_customer("Matt")
   holder.clear_list
 
-== INSTALL:
+== Install
 
-* sudo gem install publisher
+* gem install publisher
 
-== LICENSE:
+== License
 
 (The MIT License)
 
-Copyright (c) 2007 Atomic Object
+Copyright (c) 2011 Atomic Object
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the

data/Rakefile

@@ -1,7 +1,5 @@
-require 'rubygems'
-require 'hoe'
-require './lib/publisher.rb'
-require 'rake'
+require "bundler/gem_tasks"
+
 require 'rake/testtask'
 
 task :default => [ :test ]
@@ -13,19 +11,7 @@ Rake::TestTask.new("test") { |t|
   t.verbose = true
 }
 
-#
-# Hoe stuff: rubyforge project release
-#
-Hoe.new('publisher', Publisher::VERSION) do |p|
-  p.rubyforge_name = 'atomicobjectrb'
-  p.author = 'Atomic Object'
-  p.email = 'dev@atomicobject.com'
-  p.summary = 'Event subscription and firing mechanism'
-  p.description = p.paragraphs_of('README.txt', 2..5).join("\n\n")
-  p.url = p.paragraphs_of('README.txt', 1).first.gsub(/\* /,'').split(/\n/)
-  p.changes = p.paragraphs_of('History.txt', 0..1).join("\n\n")
-end
-
+# See crosby or fletcher about these tasks
 if File.exists?("../tools/")
   load "../tools/tasks/homepage.rake"
   load "../tools/tasks/release_tagging.rake"

data/Rakefile.old

@@ -0,0 +1,37 @@
+require 'rubygems'
+require 'hoe'
+require './lib/publisher.rb'
+require 'rake'
+require 'rake/testtask'
+
+task :default => [ :test ]
+
+desc "Run the unit tests in test"
+Rake::TestTask.new("test") { |t|
+  t.libs << "test"
+  t.pattern = 'test/**/*_test.rb'
+  t.verbose = true
+}
+
+#
+# Hoe stuff: rubyforge project release
+#
+Hoe.new('publisher', Publisher::VERSION) do |p|
+  p.rubyforge_name = 'atomicobjectrb'
+  p.author = 'Atomic Object'
+  p.email = 'dev@atomicobject.com'
+  p.summary = 'Event subscription and firing mechanism'
+  p.description = 'publisher is a module for extending a class with event subscription and firing capabilities.  This is helpful for implementing objects that participate in the Observer design pattern.'
+  p.url = 'http://atomicobject.github.com/publisher'
+
+  p.changes = p.paragraphs_of('History.txt', 0..1).join("\n\n")
+end
+
+if File.exists?("../tools/")
+  load "../tools/tasks/homepage.rake"
+  load "../tools/tasks/release_tagging.rake"
+  ReleaseTagging.new do |t|
+    t.package = "publisher"
+    t.version = Publisher::VERSION
+  end
+end

data/lib/publisher.rb

@@ -1,7 +1,5 @@
-# See README.txt for synopsis 
+# See README.rdoc for synopsis 
 module Publisher
-  VERSION = "1.1.1" #:nodoc:#
-
 	# Use this method (or one of the aliases) to declare which events you support
 	# Once invoked, your class will have the neccessary supporting methods for subscribing and firing.
 	def has_events(*args)
@@ -42,12 +40,16 @@ module Publisher
 		# Sign up a code block to be executed when an event is fired.
 		# It's important to know the signature of the event, as your proc needs 
 		# to accept incoming parameters accordingly.
-		def subscribe(event, &block)
+		def subscribe(event, target=nil, callback=nil, &block)
 		  ensure_valid event
 			@subscriptions ||= {}
 			listeners = @subscriptions[event]
 			listeners ||= []
-			listeners << block
+      if target && callback
+        listeners << [target, callback]
+      else
+        listeners << block
+      end
 			@subscriptions[event] = listeners
 		end
 		alias :when :subscribe
@@ -59,8 +61,12 @@ module Publisher
     def unsubscribe(event, listener)
 		  ensure_valid event
       if @subscriptions && @subscriptions[event]
-        @subscriptions[event].delete_if do |block|
-          eval('self',block.binding).equal?(listener)
+        @subscriptions[event].delete_if do |block_or_target|
+          if block_or_target.is_a? Proc
+            eval('self',block_or_target.binding).equal?(listener)
+          else
+            block_or_target[0] == listener
+          end
         end
       end
     end
@@ -70,7 +76,13 @@ module Publisher
 		def fire(event, *args) #:nod
 			ensure_valid event
 			listeners = @subscriptions[event] if @subscriptions
-			listeners.each do |l| l.call(*args) end if listeners
+			listeners.each do |l| 
+        if l.is_a? Array
+          l[0].send(l[1],*args)
+        else
+          l.call(*args) 
+        end
+      end if listeners
 		end
 		alias :emit :fire
 		alias :notify :fire

data/lib/publisher/version.rb

@@ -0,0 +1,3 @@
+module Publisher
+  VERSION = "1.1.2"
+end

data/publisher.gemspec

@@ -0,0 +1,24 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "publisher/version"
+
+Gem::Specification.new do |s|
+  s.rubyforge_project = "publisher"
+  s.name        = "publisher"
+  s.version     = Publisher::VERSION
+  s.authors     = ["Atomic Object"]
+  s.email       = ["dev@atomicobject.com"]
+  s.homepage = 'http://atomicobject.github.com/publisher'
+
+  s.summary = 'Event subscription and firing mechanism'
+  s.description = 'publisher is a module for extending a class with event subscription and firing capabilities.  This is helpful for implementing objects that participate in the Observer design pattern.'
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  # specify any dependencies here; for example:
+  # s.add_development_dependency "rspec"
+  # s.add_runtime_dependency "rest-client"
+end

data/sample_code/synopsis.rb

@@ -0,0 +1,30 @@
+require 'rubygems'
+require 'publisher'
+
+class CustomerListHolder
+  extend Publisher
+  can_fire :customer_added, :list_cleared
+
+  def add_customer(cust)
+    (@list ||= []) << cust
+    fire :customer_added, cust
+  end
+
+  def clear_list
+    @list.clear
+    fire :list_cleared
+  end
+end
+
+holder = CustomerListHolder.new
+holder.when :customer_added do |cust|
+  puts "Customer added! #{cust}"
+end
+holder.when :list_cleared do
+  puts "All gone."
+end
+
+holder.add_customer("Croz")
+holder.add_customer("Matt")
+holder.clear_list
+

data/test/publisher_test.rb

@@ -284,11 +284,32 @@ class PublisherTest < Test::Unit::TestCase
 
     assert_equal [ "surprise", "hooray" ], a
   end
+
+  def test_new_subscribe_syntax
+    @args = nil
+    shawn = Shawn.new
+    shawn.when :boom, self, :do_it
+    shawn.go(:a, :b)
+    assert_equal @args, [:a, :b]
+  end
+
+  def test_new_unsubscribe_syntax
+    @args = nil
+    shawn = Shawn.new
+    shawn.when :boom, self, :do_it
+    shawn.unsubscribe :boom, self
+    shawn.go(:a, :b)
+    assert_nil @args
+  end
  
 	#
 	# HELPERS
 	#
 
+  def do_it(*args)
+    @args = args
+  end
+
   class SomethingWatcher
     attr_reader :observations
     def initialize(something)
@@ -425,4 +446,12 @@ class PublisherTest < Test::Unit::TestCase
     end
   end
 
+  class Shawn
+    extend Publisher
+    can_fire :boom
+    def go(*args)
+      fire :boom, *args
+    end
+  end
+
 end

metadata

@@ -1,88 +1,62 @@
---- !ruby/object:Gem::Specification 
+--- !ruby/object:Gem::Specification
 name: publisher
-version: !ruby/object:Gem::Version 
-  version: 1.1.1
+version: !ruby/object:Gem::Version
+  version: 1.1.2
+  prerelease: 
 platform: ruby
-authors: 
+authors:
 - Atomic Object
 autorequire: 
 bindir: bin
 cert_chain: []
-
-date: 2009-11-08 00:00:00 -05:00
-default_executable: 
-dependencies: 
-- !ruby/object:Gem::Dependency 
-  name: hoe
-  type: :development
-  version_requirement: 
-  version_requirements: !ruby/object:Gem::Requirement 
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        version: 2.3.3
-    version: 
-description: |-
-  == DESCRIPTION:
-    
-  publisher is a module for extending a class with event subscription and firing capabilities.  This is helpful for implementing objects that participate in the Observer design pattern.
-  
-  == FEATURES:
-    
-  * Nice syntax for declaring events that can be subscribed for
-  * Convenient event firing syntax
-  * Subscribe / unsubscribe functionality
-  * Several method name aliases give you the flexibility to make your code more readable (eg, *fire*, *notify*, *emit*)
-  
-  == SYNOPSIS:
-  
-    require 'rubygems'
-    require 'publisher'
-email: dev@atomicobject.com
+date: 2011-09-27 00:00:00.000000000Z
+dependencies: []
+description: publisher is a module for extending a class with event subscription and
+  firing capabilities.  This is helpful for implementing objects that participate
+  in the Observer design pattern.
+email:
+- dev@atomicobject.com
 executables: []
-
 extensions: []
-
-extra_rdoc_files: 
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
 - History.txt
 - Manifest.txt
-- README.txt
-files: 
-- History.txt
-- Manifest.txt
-- README.txt
+- README.rdoc
 - Rakefile
+- Rakefile.old
 - lib/publisher.rb
+- lib/publisher/version.rb
+- publisher.gemspec
+- sample_code/synopsis.rb
 - test/publisher_test.rb
 - test/test_helper.rb
-has_rdoc: true
 homepage: http://atomicobject.github.com/publisher
 licenses: []
-
 post_install_message: 
-rdoc_options: 
-- --main
-- README.txt
-require_paths: 
+rdoc_options: []
+require_paths:
 - lib
-required_ruby_version: !ruby/object:Gem::Requirement 
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      version: "0"
-  version: 
-required_rubygems_version: !ruby/object:Gem::Requirement 
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      version: "0"
-  version: 
+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: atomicobjectrb
-rubygems_version: 1.3.5
+rubyforge_project: publisher
+rubygems_version: 1.8.6
 signing_key: 
 specification_version: 3
 summary: Event subscription and firing mechanism
-test_files: 
+test_files:
+- test/publisher_test.rb
 - test/test_helper.rb