wwood-reach 0.1

data/lib/reach.rb

@@ -0,0 +1,57 @@
+#   Copyright (c) 2008 Ben Woodcroft <donttrustben somewhere near gmail.com>
+#
+#   This program is free software.
+#   You can distribute/modify this program under the terms of
+#   the GNU Lesser General Public License version 3.
+
+# The point of this is that the 
+# Bookshelf.all.reach.books.each do {|book| puts book.name}
+# instead of
+# Bookshelf.all.each do |bookshelf|
+# bookshelf.books.each do |book|
+# puts book.name
+# end
+# end
+
+# Bookshelf.all.reach is a ReachableArray
+# the books is an array (bookshelves) of arrays (books)
+class Array
+  def reach
+    ReachingArray.new(self)
+  end
+end
+
+class ReachingArray
+  # The array that this reaching array is extending. This might
+  # be a real Array, or a ReachingArray
+  attr_accessor :retract
+  
+  def initialize(retract)
+    @retract = retract
+  end
+  
+  # When a method is called on an array and that method
+  # isn't defined for an array, then run 
+  # 
+  def method_missing(method, *args, &block)
+    if @retract.respond_to?(method)
+      # If this is an array method, just use that
+      r = @retract.send(method, *args, &block)
+      return r
+    else
+      # If this is an object-specific method, run an each on it.
+      # A simple each won't work because that doesn't modify the
+      # array elements in place as we want, so have to use collect
+      # instead.
+      @retract = @retract.collect do |o|
+        o.send(method, *args, &block)
+      end
+      return self
+    end
+  end
+  
+  # Mainly for testing
+  def ==(another)
+    @retract <=> another.retract
+  end
+end

data/reach.gemspec

@@ -0,0 +1,14 @@
+Gem::Specification.new do |s|
+  s.name     = "reach"
+  s.version  = "0.1"
+  s.date     = "2008-09-05"
+  s.summary  = "Extend the Ruby Array class for less loops and blocks"
+  s.email    = "donttrustben somewhere near gmail.com"
+  s.homepage = "http://github.com/wwood/reach"
+  s.description = "Extend the Ruby Array class for less loops and blocks."
+  s.authors  = ["Ben J Woodcroft"]
+  s.files    = ["reach.gemspec", 
+		"lib/reach.rb"]
+  s.test_files = ["test/test_reach.rb"]
+end
+

data/test/test_reach.rb

@@ -0,0 +1,58 @@
+#   Copyright (c) 2008 Ben Woodcroft <donttrustben somewhere near gmail.com>
+#
+#   This program is free software.
+#   You can distribute/modify this program under the terms of
+#   the GNU Lesser General Public License version 3.
+
+
+$:.unshift File.join(File.dirname(__FILE__),'..','lib')
+
+require 'test/unit'
+require 'reach'
+
+class ReachTest < Test::Unit::TestCase
+  def setup
+    @one_level = %w(a b c)
+    @two_level = [[1,2,3],[5]]
+  end
+  
+  def test_normality
+    # Test arrays seem normal - this is kinda pointless I would say
+    index = 0
+    @one_level.each { |n|
+      assert_equal @one_level[index], n
+      index += 1
+    }
+  end
+  
+  def test_simple_method
+    out = @one_level.reach.succ!
+    assert_kind_of ReachingArray, out
+    assert_equal ReachingArray.new(%w(b c d)), out
+  end
+  
+  def test_scoping_one
+    assert_equal ReachingArray.new(%w(c d e)), @one_level.reach.succ!.succ!
+  end
+  
+  def test_collect
+    assert_equal %w(b c d), @one_level.reach.collect{|c| c.succ}
+  end
+
+  # Catches if the array elements are not modified within the reach
+  def test_double_scope
+    # make sure my assumptions are correct about the
+    # classes being tested
+    assert 1.respond_to?(:zero?)
+    assert_equal false, '1'.respond_to?(:zero?)
+    
+    # make sure that the array elements are being reversed
+    str = ['0','2','3']
+    assert_equal [0,2,3], str.reach.to_i.retract
+    assert_equal [true, false, false], str.reach.to_i.zero?.retract
+  end
+  
+  def test_block_accepted
+    assert_equal %w(d e f), @one_level.reach.succ.collect{|c| c.succ.succ}
+  end
+end

metadata

@@ -0,0 +1,54 @@
+--- !ruby/object:Gem::Specification 
+name: wwood-reach
+version: !ruby/object:Gem::Version 
+  version: "0.1"
+platform: ruby
+authors: 
+- Ben J Woodcroft
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2008-09-05 00:00:00 -07:00
+default_executable: 
+dependencies: []
+
+description: Extend the Ruby Array class for less loops and blocks.
+email: donttrustben somewhere near gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- reach.gemspec
+- lib/reach.rb
+has_rdoc: false
+homepage: http://github.com/wwood/reach
+post_install_message: 
+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: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.2.0
+signing_key: 
+specification_version: 2
+summary: Extend the Ruby Array class for less loops and blocks
+test_files: 
+- test/test_reach.rb