interceptor 0.0.1

data/Gemfile

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

data/MIT-LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2010 Ryan Allen, Envato Pty Ltd
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,54 @@
+# Interceptor
+
+Mad Max had one, and he was freaking awesome.
+
+## Overview:
+
+Interceptor allows you to wrap other objects, and intercept method calls, without changing the target objects code, or performing any hairy metaprogramming. You may use this library to perform these kinds of tasks:
+
+* Modifying method arguments as they come in.
+* Modify return values as they go out.
+* Perform other tasks (such as logging) without sprinkling the code throughout the objects (typically unrelated) implementation.
+* Call completely different methods depending on anything you want, I suppose.
+
+You can think of this as a more explicit form of AOP, but unlike AOP, instead of being picked off by a sniper from 3000m away (and being very surprised about the whole thing), it's like the sniper has arrived at your house with your birthday cake and birthday present in order to convey his birthday wishes.
+
+## Example:
+
+Let's say as a Ruby programmer you picked up some Lua and decided that Lua's idea of starting an Array at 1 is _way_ better than starting an Array at 0, in a fit of blinding genius you decide to make a Ruby Array behave like a Lua one.
+
+    lucky_numbers = [42, 666, 2012]
+    
+    lucky_numbers[0] # => 42
+    lucky_numbers[1] # => 666
+    lucky_numbers[2] # => 2012
+    
+    even_luckier_numbers = Interceptor.new(lucky_numbers)
+    
+    # intercept the [] method, and take 1 off the index passed in
+    # so that our arrays become like lua arrays, kinda
+    even_luckier_numbers.intercept(:[]) do |receiver, target, index|
+      receiver[index-1]
+    end
+    
+    even_luckier_numbers[1] # => 42
+    even_luckier_numbers[2] # => 666
+    even_luckier_numbers[3] # => 2012
+    
+The first two arguments to the block is a reference to the object passed to the Interceptor (in this case, a reference to ``lucky_numbers``), the second is a symbol of the method call (in this case, it is ``:[]``), and the remaining arguments are the arguments passed to the method call (in this case, ``1`` and ``2`` and ``3``).
+
+## Patches:
+
+What the hell is a patch?
+
+## RubyGem?
+
+Nope, how do you make those? I asked this guy called John and he told me to 'google it' or something.
+
+## Mad Max:
+
+Is freaking awesome, [here's proof](http://www.youtube.com/watch?v=nLCmcV4gC_0).
+
+## Other Questions?
+
+If you have any questions, shoot me a message on the github-o-sphere. I likely have no idea what you're talking about as I have no idea what I'm talking about most of the time.

data/interceptor.gemspec

@@ -0,0 +1,18 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require 'interceptor'
+
+Gem::Specification.new do |s|
+  s.name        = 'interceptor'
+  s.version     = Interceptor::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ['Ryan Allen']
+  s.email       = ['ryan@ryanface.com']
+  s.homepage    = 'https://github.com/ryan-allen/interceptor'
+  s.summary     = %q{Mad Max had one, and he was freaking awesome.}
+  s.description = %q{Interceptor is a library for modifying calls to objects. You can change things as they come in or as they go out.}
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.require_paths = ['lib']
+end

data/lib/interceptor.rb

@@ -0,0 +1,20 @@
+class Interceptor
+  VERSION = '0.0.1'
+
+  def initialize(receiver)
+    @receiver = receiver
+    @interceptions = {}
+  end
+
+  def intercept(*targets, &block)
+    targets.each { |target| @interceptions[target] = block }
+  end
+
+  def method_missing(target, *args, &block)
+    if @interceptions[target]
+      @interceptions[target].call(@receiver, target, *args, &block)
+    else
+      @receiver.send(target, *args, &block)
+    end
+  end
+end

data/rakefile.rb

@@ -0,0 +1,11 @@
+require 'bundler'
+
+Bundler::GemHelper.install_tasks
+
+task :default do
+  Rake::Task['run_tests'].invoke
+end
+
+task :run_tests do 
+  require 'test/interceptor_test'
+end

data/test/interceptor_test.rb

@@ -0,0 +1,45 @@
+require 'test/unit'
+require 'interceptor'
+
+class InterceptorTest < Test::Unit::TestCase
+  def setup
+    @object = [1,3,2,5,4]
+    @wrapper = Interceptor.new(@object)
+  end
+
+  def test_sort_works_as_we_expect_before_intercept
+    assert_equal [1,2,3,4,5], @wrapper.sort
+  end
+
+  def test_our_sort_intercept_reverses_the_sort
+    @wrapper.intercept(:sort) { |r, t, *a| r.sort.reverse }
+    assert_equal [5,4,3,2,1], @wrapper.sort
+  end
+
+  def test_we_are_passed_the_receiver
+    @wrapper.intercept(:[]) { |r, t, *a| r }
+    assert_equal @object, @wrapper[0]
+  end
+
+  def test_we_are_passed_the_target
+    @wrapper.intercept(:[]) { |r, t, *a| t }
+    assert_equal :[], @wrapper[0]
+  end
+
+  def test_we_are_passed_the_args
+    @wrapper.intercept(:[]) { |r, t, *a| a }
+    assert_equal [0], @wrapper[0]
+  end
+
+  def test_that_the_block_is_like_totally_a_closure_and_shit!
+    @wrapper.intercept(:[]) { |r, t, *a| self.class }
+    assert_equal InterceptorTest, @wrapper[0]
+  end
+
+  def test_can_wrap_more_than_one_method_in_a_single_call_and_can_differentiate_the_target_in_the_interception_phew_that_is_a_mouthful
+    @wrapper.intercept(:[], :sort, :reverse) { |r, t, *a| t }
+    assert_equal :[], @wrapper[0]
+    assert_equal :sort, @wrapper.sort
+    assert_equal :reverse, @wrapper.reverse
+  end
+end

metadata

@@ -0,0 +1,74 @@
+--- !ruby/object:Gem::Specification 
+name: interceptor
+version: !ruby/object:Gem::Version 
+  hash: 29
+  prerelease: false
+  segments: 
+  - 0
+  - 0
+  - 1
+  version: 0.0.1
+platform: ruby
+authors: 
+- Ryan Allen
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-04-14 00:00:00 +10:00
+default_executable: 
+dependencies: []
+
+description: Interceptor is a library for modifying calls to objects. You can change things as they come in or as they go out.
+email: 
+- ryan@ryanface.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- Gemfile
+- MIT-LICENSE
+- README.md
+- interceptor.gemspec
+- lib/interceptor.rb
+- rakefile.rb
+- test/interceptor_test.rb
+has_rdoc: true
+homepage: https://github.com/ryan-allen/interceptor
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: Mad Max had one, and he was freaking awesome.
+test_files: 
+- test/interceptor_test.rb