filtration 0.0.1

data/LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2011 Vertive, Inc.
+
+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.rdoc

@@ -0,0 +1,24 @@
+= Filtration
+Filtration is a clean, lightweight way to filter arguments going into and out of methods.
+
+== Usage
+Example:
+  class Bar
+    def foo(x)
+      x + 2
+    end
+    def foo_too(x)
+      x + 2
+    end
+  end
+  
+  class Foo < Bar
+    prefilter(:foo){|x| x * 2}        # (x * 2) + 2
+    postfilter(:foo_too){|x| x * 2}   # (x + 2) * 2
+  end 
+
+== Requirements
+Filtration stands on its own!
+
+== Development
+RSpec is used for testing.

data/lib/filtration.rb

@@ -0,0 +1,23 @@
+module Filtration
+
+  def prefilter(method,&block)
+    old_method = instance_method(method)
+    raise "Method #{method} takes 0 arguments" if old_method.arity == 0
+    define_method(method) do |*args|
+      old_method.bind(self).call(block.call(*args))
+    end
+  end
+
+  def postfilter(method,&block)
+    old_method = instance_method(method)
+    raise "Method #{method} takes 0 arguments" if old_method.arity == 0
+    define_method(method) do |*args|
+      block.call(old_method.bind(self).call(*args))
+    end
+  end
+
+end
+
+class Object
+  extend Filtration
+end

data/spec/filtration_spec.rb

@@ -0,0 +1,41 @@
+require 'spec_helper'
+
+describe Filtration do
+
+  it 'executes a code block before the specified method' do
+    class Foo1
+      def foo(x)
+        x + 2
+      end
+    end
+    class Test1 < Foo1
+      prefilter(:foo){|x| x * 2}
+    end
+    Test1.new.foo(2).should === 6
+  end
+
+  it 'executes a code block after the specified method' do
+    class Foo2
+      def foo(x)
+        x + 2
+      end
+    end
+    class Test2 < Foo2
+      postfilter(:foo){|x| x * 2}
+    end
+    Test2.new.foo(2).should === 8
+  end
+
+  it 'raises an error if the method has no arguments' do
+    class Foo3
+      def foo
+        2
+      end
+    end
+    class Test3 < Foo3
+      extend RSpec::Matchers
+      lambda { prefilter(:foo){|x| x * 2} }.should raise_error
+    end
+  end
+
+end

data/spec/spec_helper.rb

@@ -0,0 +1,4 @@
+$:.unshift(File.dirname(__FILE__) + '/../lib/')
+
+require 'rspec'
+require 'filtration'

metadata

@@ -0,0 +1,62 @@
+--- !ruby/object:Gem::Specification 
+name: filtration
+version: !ruby/object:Gem::Version 
+  prerelease: 
+  version: 0.0.1
+platform: ruby
+authors: 
+- R. Scott Reis
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-04-12 00:00:00 Z
+dependencies: []
+
+description: 
+email: 
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.rdoc
+files: 
+- LICENSE
+- README.rdoc
+- lib/filtration.rb
+- spec/spec_helper.rb
+- spec/filtration_spec.rb
+homepage: 
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- -m
+- README.rdoc
+- -t
+- Anemone
+require_paths: 
+- lib
+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: 
+rubygems_version: 1.7.2
+signing_key: 
+specification_version: 3
+summary: Filtration pre/post method callback
+test_files: 
+- spec/spec_helper.rb
+- spec/filtration_spec.rb