matthewrudy-aspicious 0.1.1

data/README

@@ -0,0 +1,54 @@
+Aspicious
+=====================================================
+
+Aspicious is a lightweight, simple, implementation of Aspects into Ruby.
+For a more heavy handed approach see AspectR and Aquarium.
+
+Aspicious is based on the founding principle that "aspects" is like "suspects"
+and "aspicious" is like "suspicious". So it doesnt mean anything, but nevertheless is a name.
+
+Example
+=====================================================
+  require 'rubygems'
+  require 'aspicious'
+
+  class Turtle < ActiveRecord::Base
+    def lay_some_eggs
+      puts "laying these eggs good"
+    end
+  end
+
+  class EggThief < Aspicious::Watcher
+    watch Turtle
+    after :lay_some_eggs, :try_to_steal_the_eggs
+
+    def try_to_steal_the_eggs
+      if watchee.is_weak?
+        puts "I stole the eggs"
+      else
+        puts "I didnt manage to steal the eggs. Nature is safe!"
+      end
+    end
+  end
+
+but you can also "watch" multiple classes, and specify an :only option
+
+  class Chicken
+    def lay_some_eggs
+      puts "chickens lay eggs for everybody to eat"
+    end
+  end
+
+  class CorporateEggFarmer < Aspicious::Watcher
+    watch Turtle, Chicken
+    before :lay_some_eggs, :advertise_the_eggs, :only => Chicken
+
+    def advertise_the_eggs
+      puts "even though #{watchee.name}'s eggs aren't out yet, I'll start advertising them on TV. If Kerry Katona is advertising them on ITV they will surely sell?"
+    end
+  end
+
+BOOM!!!
+Most of the power of Aspect Oriented Programming for 1% of the price
+
+Copyright (c) 2008 [Matthew Rudy Jacobs], released under the MIT license

data/Rakefile

@@ -0,0 +1,22 @@
+require 'rake'
+require 'rake/testtask'
+require 'rake/rdoctask'
+
+desc 'Default: run unit tests.'
+task :default => :test
+
+desc 'Test Aspicious.'
+Rake::TestTask.new(:test) do |t|
+  t.libs << 'lib'
+  t.pattern = 'test/**/*_test.rb'
+  t.verbose = true
+end
+
+desc 'Generate documentation for Aspicious.'
+Rake::RDocTask.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title    = 'Aspicious'
+  rdoc.options << '--line-numbers' << '--inline-source'
+  rdoc.rdoc_files.include('README')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/examples/burgerking.rb

@@ -0,0 +1,59 @@
+require File.dirname(__FILE__) + '/../lib/aspicious'
+class Tourist
+  def initialize(name)
+    @name = name
+  end
+  attr_reader :name
+  
+  def take_a_picture
+    puts "*FLASH*"
+  end
+  
+  def enjoy!
+    puts "enjoyed that!"
+  end
+end
+
+class BurgerKing
+  def enjoy!
+    puts "enjoy your burger"
+  end
+end
+
+puts "before any Aspiciousness"
+tommy = Tourist.new("Tommy")
+tommy.take_a_picture
+
+class Beggar < Aspicious::Watcher
+  watch Tourist
+  after(:take_a_picture, :ask_for_money)
+  
+  def ask_for_money
+    puts "you take picture, #{watchee.name}, you give me $1"
+  end
+end
+
+puts "\n\nwith a Beggar"
+tommy.take_a_picture
+
+puts "\n\nbefore the Spoilter"
+burger = BurgerKing.new
+burger.enjoy!
+
+class Spoiler < Aspicious::Watcher
+  watch Tourist, BurgerKing
+  before(:enjoy!, :spoil_it!)
+  after :enjoy!, :spoil_it!, :only => Tourist
+  after :enjoy!, :boil_it,   :only => BurgerKing
+  def spoil_it!
+    puts "I always spoil everything"
+  end
+  
+  def boil_it
+    puts "I always boil everything"
+  end
+end
+
+puts "\n\nafter the Spoiler"
+burger.enjoy!
+tommy.enjoy!

data/lib/aspicious.rb

@@ -0,0 +1 @@
+require File.dirname(__FILE__) + "/aspicious/watcher"

data/lib/aspicious/watcher.rb

@@ -0,0 +1,68 @@
+module Aspicious
+  class Watcher
+    def initialize(watchee)
+      @watchee = watchee
+    end
+    attr_reader :watchee
+  
+    class << self
+      def watch(*klasses)
+        @watching ||= []
+        klasses.each do |klass|
+          @watching << klass
+          klass.class_eval <<-RUBY, __FILE__, __LINE__
+            unless self.instance_methods.include?('watchers')
+              attr_accessor :watchers
+              def watcher_for(klass)
+                self.watchers ||= []
+                unless watcher = self.watchers.detect{|w| w.is_a?(klass)}
+                  watcher = klass.new(self)
+                  self.watchers << watcher
+                end
+                return watcher
+              end
+            end
+          RUBY
+        end
+      end
+    
+      def before(method_to_watch, callback, options={})
+        do_watch(method_to_watch, callback, options, :before)
+      end
+      
+      def after(method_to_watch, callback, options={})
+        do_watch(method_to_watch, callback, options, :after)
+      end
+      
+      private
+      
+      def do_watch(watch, callback, options, position)
+        with_method    = depunctuate("#{watch}_with_watcher_executing_#{callback}_#{position}")
+        without_method = depunctuate("#{watch}_without_watcher_executing_#{callback}_#{position}")
+        call_watcher = "self.watcher_for(#{self}).#{callback}"
+        
+        klasses = options[:only] || @watching
+        Array(klasses).each do |klass|
+          klass.class_eval <<-RUBY, __FILE__, __LINE__
+            def #{with_method}(*args, &block)
+              #{call_watcher if position == :before}
+              rtn = #{without_method}(*args, &block)
+              #{call_watcher if position == :after}
+              return rtn
+            end
+            alias :#{without_method} :#{watch}
+            alias :#{watch} :#{with_method} 
+          RUBY
+        end
+      end
+      
+      def depunctuate(method_name)
+        method_name = method_name.to_s.dup
+        [['?', '_question'], ['!', '_bang'], ['=', '_equals']].each do |punctuation, replacement|
+          method_name.gsub!(punctuation, replacement)
+        end
+        return method_name
+      end
+    end
+  end
+end

metadata

@@ -0,0 +1,58 @@
+--- !ruby/object:Gem::Specification 
+name: matthewrudy-aspicious
+version: !ruby/object:Gem::Version 
+  version: 0.1.1
+platform: ruby
+authors: 
+- Matthew Rudy Jacobs
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2008-12-06 00:00:00 -08:00
+default_executable: 
+dependencies: []
+
+description: Aspects applied to Ruby with an air of super-simplicity
+email: MatthewRudyJacobs@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README
+files: 
+- README
+- Rakefile
+- lib/aspicious.rb
+- lib/aspicious/watcher.rb
+- examples/burgerking.rb
+has_rdoc: true
+homepage: http://github.com/matthewrudy/aspicious
+post_install_message: 
+rdoc_options: 
+- --main
+- README
+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: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.2.0
+signing_key: 
+specification_version: 2
+summary: Super-simple Aspects in Ruby
+test_files: []
+