pass_nils_to 0.5

data/CHANGELOG

@@ -0,0 +1 @@
+8/15/08 - Initial import [Matthew Bass]

data/MIT-LICENSE

@@ -0,0 +1,16 @@
+Copyright (c) 2007-2008 Matthew Bass (http://matthewbass.com)
+
+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

@@ -0,0 +1,54 @@
+= pass_nils_to
+
+Pass nils to your methods and see if they explode.
+
+== Installation
+
+Install the gem directly:
+
+  gem sources -a http://gems.github.com (you only have to do this once)
+  sudo gem install pelargir-pass_nils_to
+  
+Or install the gem in your Rails project:
+  
+  gem sources -a http://gems.github.com
+  script/plugin install pelargir-pass_nils_to
+
+Or clone the project:
+
+  git clone git://github.com/pelargir/pass_nils_to.git
+
+== Usage
+
+Pass nils to your methods thusly:
+
+  class Parser
+    def parse(arg1, arg2)
+      ...
+    end
+  end
+  
+  parser = Parser.new
+  pass_nils_to(:parse, parser)
+  
+This would pass nils to the #parse method in these combinations:
+
+  parse(nil, "foo")
+  parse("foo", nil)
+  parse(nil, nil)
+  
+An arbitrary number of arguments are supported, so you can try passing
+nils to methods with three arguments, four, five, etc.
+
+== Running Unit Tests
+
+Use the rake command to run the unit tests for the plugin. The tests require
+that the Mocha gem be installed locally:
+
+  sudo gem install mocha
+
+== Resources
+
+Repository: http://github.com/pelargir/pass_nils_to/
+Blog: http://matthewbass.com
+Author: Matthew Bass

data/Rakefile

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

data/init.rb

@@ -0,0 +1 @@
+require 'pass_nils_to'

data/lib/pass_nils_to.rb

@@ -0,0 +1,22 @@
+module PassNils  
+  def pass_nils_to(method_sym, object = self)
+    method = object.method(method_sym.to_s)
+    
+    method.arity.times do |i|
+      nils = Array.new(method.arity) { nil }
+      nils[i] = "foo"
+      method.call(*nils)
+    end
+    
+    if method.arity > 2
+      method.arity.times do |i|
+        nils = Array.new(method.arity) { nil }
+        (method.arity - 1).times { |j| nils[i-j] = "foo" }
+        method.call(*nils)
+      end
+    end
+    
+    nils = Array.new(method.arity) { nil }
+    method.call(*nils)   # Call with all nils
+  end
+end

data/pass_nils_to.gemspec

@@ -0,0 +1,24 @@
+Gem::Specification.new do |s|
+  s.name     = "pass_nils_to"
+  s.version  = "0.5"
+  s.date     = "2008-08-15"
+  s.summary  = "Pass nils to your methods and see if they explode."
+  s.email    = "pelargir@gmail.com"
+  s.homepage = "http://github.com/pelargir/pass_nils_to"
+  s.description = "Pass nils to your methods and see if they explode."
+  s.has_rdoc = true
+  s.authors  = ["Matthew Bass"]
+  s.files    = [
+    "CHANGELOG",
+    "init.rb",
+  	"lib/pass_nils_to.rb",
+    "MIT-LICENSE",
+		"pass_nils_to.gemspec",
+    "Rakefile",
+		"README",
+		"test/pass_nils_to_test.rb",
+		"test/test_helper.rb"
+		]
+  s.rdoc_options = ["--main", "README"]
+  s.extra_rdoc_files = ["README"]
+end

data/test/pass_nils_to_test.rb

@@ -0,0 +1,83 @@
+require File.dirname(__FILE__) + '/test_helper'
+
+class MockObject
+  attr_accessor :spooge_args
+  
+  def initialize
+    @spooge_args = []
+  end
+  
+  def spooge
+    @spooge_args << true
+  end
+  
+  def spooge_with_one_arg(arg)
+    @spooge_args << [arg]
+  end
+  
+  def spooge_with_two_args(arg1, arg2)
+    @spooge_args << [arg1, arg2]
+  end
+  
+  def spooge_with_three_args(arg1, arg2, arg3)
+    @spooge_args << [arg1, arg2, arg3]
+  end
+  
+  def spooge_with_four_args(arg1, arg2, arg3, arg4)
+    @spooge_args << [arg1, arg2, arg3, arg4]
+  end
+end
+
+
+class TestHelperTest < Test::Unit::TestCase
+  include PassNils
+
+  def setup
+    @obj = MockObject.new
+  end
+  
+  def test_pass_nils_to
+    pass_nils_to(:spooge, @obj)
+    assert [true], @obj.spooge_args
+  end
+  
+  def test_pass_nils_to_with_one_arg
+    pass_nils_to(:spooge_with_one_arg, @obj)
+    assert_equal [["foo"], [nil]], @obj.spooge_args
+  end
+  
+  def test_pass_nils_to_with_two_args
+    pass_nils_to(:spooge_with_two_args, @obj)
+    assert_equal [["foo", nil], [nil, "foo"], [nil, nil]], @obj.spooge_args
+  end
+  
+  def test_pass_nils_to_with_three_args
+    pass_nils_to(:spooge_with_three_args, @obj)
+    expected = [
+      ["foo", nil, nil],
+      [nil, "foo", nil],
+      [nil, nil, "foo"],
+      ["foo", nil, "foo"],
+      ["foo", "foo", nil],
+      [nil, "foo", "foo"],
+      [nil, nil, nil]
+    ]
+    assert_equal expected, @obj.spooge_args
+  end
+  
+  def test_pass_nils_to_with_four_args
+    pass_nils_to(:spooge_with_four_args, @obj)
+    expected = [
+      ["foo", nil, nil, nil],
+      [nil, "foo", nil, nil],
+      [nil, nil, "foo", nil],
+      [nil, nil, nil, "foo"],
+      ["foo", nil, "foo", "foo"],
+      ["foo", "foo", nil, "foo"],
+      ["foo", "foo", "foo", nil],
+      [nil, "foo", "foo", "foo"],
+      [nil, nil, nil, nil]
+    ]
+    assert_equal expected, @obj.spooge_args
+  end
+end

data/test/test_helper.rb

@@ -0,0 +1,2 @@
+require 'test/unit'
+require File.dirname(__FILE__) + '/../lib/pass_nils_to'

metadata

@@ -0,0 +1,64 @@
+--- !ruby/object:Gem::Specification 
+name: pass_nils_to
+version: !ruby/object:Gem::Version 
+  version: "0.5"
+platform: ruby
+authors: 
+- Matthew Bass
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2008-08-15 00:00:00 -04:00
+default_executable: 
+dependencies: []
+
+description: Pass nils to your methods and see if they explode.
+email: pelargir@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README
+files: 
+- CHANGELOG
+- init.rb
+- lib/pass_nils_to.rb
+- MIT-LICENSE
+- pass_nils_to.gemspec
+- Rakefile
+- README
+- test/pass_nils_to_test.rb
+- test/test_helper.rb
+has_rdoc: true
+homepage: http://github.com/pelargir/pass_nils_to
+licenses: []
+
+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.3.4
+signing_key: 
+specification_version: 3
+summary: Pass nils to your methods and see if they explode.
+test_files: []
+