random-accessible 0.1.4 → 0.2.0

data/lib/random-writable.rb

@@ -171,6 +171,7 @@ module RandomWritable
   # if the class provides no size-provider.
   def clear
     shrink(size)
+    return self
   end
 
   # Same as Array's.
@@ -184,6 +185,7 @@ module RandomWritable
       replace_at(i, el)
       i += 1
     end
+    return self
   end
 
   # Same as Array's.
@@ -228,6 +230,8 @@ module RandomWritable
         end
       end
     end
+
+    return self
   end
 
   # Same as Array's.
@@ -241,6 +245,7 @@ module RandomWritable
         insert_at(nth, el)
       end
     end
+    return self
   end
 
   # Remove specified number of elements from the last of this object.
@@ -266,6 +271,7 @@ module RandomWritable
     obj.each do |el|
       replace_at(size, el)
     end
+    return self
   end
 
   # Same as Array's.
@@ -284,6 +290,7 @@ module RandomWritable
   # Same as Array's.
   # This method raises NotImplementedError
   # if the class provides no delete-accessor.
+  # This method ALWAYS RETURNS NULL.
   def shift(*args)
     if args.size > 1
       raise ArgumentError, "wrong number of arguments(#{args.size})"

data/test/test-random-accessible.rb

@@ -91,9 +91,7 @@ class TestRandomAccesible < Test::Unit::TestCase
   def test_collect!
     FULL_IMPLS.each do |klass|
       impl = klass.new([1, 2, 3])
-      impl.collect! do |el|
-        el * 3
-      end
+      assert_same(impl, impl.collect! { |el| el * 3 })
       assert_equal([3, 6, 9], impl)
       assert_equal(3, impl.size)
 
@@ -205,31 +203,6 @@ class TestRandomAccesible < Test::Unit::TestCase
     end
   end
 
-  # TODO: Delete me.
-  def test_fill_start_length
-    FULL_IMPLS.each do |klass|
-      impl = klass.new([0, 1, 2, 3 ,4])
-      impl.fill(-1, 0, 3)
-      assert_equal([-1, -1, -1, 3, 4], impl)
-      assert_equal(5, impl.size)
-
-      impl = klass.new([0, 1, 2, 3 ,4])
-      impl.fill(-1, 2, 3)
-      assert_equal([0, 1, -1, -1, -1], impl)
-      assert_equal(5, impl.size)
-
-      impl = klass.new([0, 1, 2, 3 ,4])
-      impl.fill(-1, 2, 5)
-      assert_equal([0, 1, -1, -1, -1, -1, -1], impl)
-      assert_equal(7, impl.size)
-
-      impl = klass.new([0, 1, 2, 3 ,4])
-      impl.fill(-1, 7, 3)
-      assert_equal([0, 1, 2, 3, 4, nil, nil, -1, -1, -1], impl)
-      assert_equal(10, impl.size)
-    end
-  end
-
   def test_flatten!
     FULL_IMPLS.each do |klass|
       impl = klass.new([1, [2, 3, [4], 5]])

data/test/test-random-writable.rb

@@ -211,15 +211,9 @@ class TestRandomWritable < Test::Unit::TestCase
   end
 
   def test_clear
-    FULL_IMPLS.each do |klass|
-      impl = klass.new((1..100).to_a)
-      impl.clear
-      assert_equal([], impl.to_ary)
-      assert_equal(0, impl.size)
-    end
-    NODELETE_IMPLS.each do |klass|
+    (FULL_IMPLS + NODELETE_IMPLS).each do |klass|
       impl = klass.new((1..100).to_a)
-      impl.clear
+      assert_same(impl, impl.clear)
       assert_equal([], impl.to_ary)
       assert_equal(0, impl.size)
     end
@@ -232,7 +226,7 @@ class TestRandomWritable < Test::Unit::TestCase
   def test_concat
     (FULL_IMPLS + NODELETE_IMPLS).each do |klass|
       impl = klass.new([1, 2, 3])
-      impl.concat([4, 5])
+      assert_same(impl, impl.concat([4, 5]))
       assert_equal([1, 2, 3, 4, 5], impl.to_ary)
       assert_equal(5, impl.size)
     end
@@ -314,11 +308,11 @@ class TestRandomWritable < Test::Unit::TestCase
   def test_fill_val
     (FULL_IMPLS + NODELETE_IMPLS).each do |klass|
       impl = klass.new([1, 2, 3, 4])
-      impl.fill(10)
+      assert_same(impl, impl.fill(10))
       assert_equal([10, 10, 10, 10], impl.to_ary)
 
       impl = klass.new([1, 2, 3])
-      impl.fill { |i| -i }
+      assert_same(impl, impl.fill { |i| -i })
       assert_equal([0, -1, -2], impl.to_ary)
     end
     NOSIZE_IMPLS.each do |klass|
@@ -334,92 +328,92 @@ class TestRandomWritable < Test::Unit::TestCase
   def test_fill_start_length
     (FULL_IMPLS + NODELETE_IMPLS).each do |klass|
       impl = klass.new([1, 2, 3, 4])
-      impl.fill(10, 0, 2)
+      assert_same(impl, impl.fill(10, 0, 2))
       assert_equal([10, 10, 3, 4], impl.to_ary)
       assert_equal(4, impl.size)
 
-      impl.fill(-1, 1, 2)
+      assert_same(impl, impl.fill(-1, 1, 2))
       assert_equal([10, -1, -1, 4], impl.to_ary)
       assert_equal(4, impl.size)
 
-      impl.fill(0, 2, 2)
+      assert_same(impl, impl.fill(0, 2, 2))
       assert_equal([10, -1, 0, 0], impl.to_ary)
       assert_equal(4, impl.size)
 
-      impl.fill(1, 3, 3)
+      assert_equal(impl, impl.fill(1, 3, 3))
       assert_equal([10, -1, 0, 1, 1, 1], impl.to_ary)
       assert_equal(6, impl.size)
 
-      impl.fill(2, 6, 1)
+      assert_same(impl, impl.fill(2, 6, 1))
       assert_equal([10, -1, 0, 1, 1, 1, 2], impl.to_ary)
       assert_equal(7, impl.size)
 
-      impl.fill(3, 8, 3)
+      assert_same(impl, impl.fill(3, 8, 3))
       assert_equal([10, -1, 0, 1, 1, 1, 2, nil, 3, 3, 3], impl.to_ary)
       assert_equal(11, impl.size)
 
       impl = klass.new([1, 2, 3, 4])
-      impl.fill(0, 2) { |i| 10 }
+      assert_same(impl, impl.fill(0, 2) { |i| 10 })
       assert_equal([10, 10, 3, 4], impl.to_ary)
       assert_equal(4, impl.size)
 
-      impl.fill(1, 2) { |i| -1 }
+      assert_same(impl, impl.fill(1, 2) { |i| -1 })
       assert_equal([10, -1, -1, 4], impl.to_ary)
       assert_equal(4, impl.size)
 
-      impl.fill(2, 2) { |i| i * 0 }
+      assert_same(impl, impl.fill(2, 2) { |i| i * 0 })
       assert_equal([10, -1, 0, 0], impl.to_ary)
       assert_equal(4, impl.size)
 
-      impl.fill(3, 3) { |i| 1 }
+      assert_same(impl, impl.fill(3, 3) { |i| 1 })
       assert_equal([10, -1, 0, 1, 1, 1], impl.to_ary)
       assert_equal(6, impl.size)
 
-      impl.fill(6, 1) { |i| i - 4 }
+      assert_same(impl, impl.fill(6, 1) { |i| i - 4 })
       assert_equal([10, -1, 0, 1, 1, 1, 2], impl.to_ary)
       assert_equal(7, impl.size)
 
-      impl.fill(8, 3) { |i| i }
+      assert_same(impl, impl.fill(8, 3) { |i| i })
       assert_equal([10, -1, 0, 1, 1, 1, 2, nil, 8, 9, 10], impl.to_ary)
       assert_equal(11, impl.size)
     end
     NOSIZE_IMPLS.each do |klass|
       impl = klass.new([1, 2, 3, 4])
-      impl.fill(10, 0, 2)
+      assert_same(impl, impl.fill(10, 0, 2))
       assert_equal([10, 10, 3, 4], impl.to_ary)
 
-      impl.fill(-1, 1, 2)
+      assert_same(impl, impl.fill(-1, 1, 2))
       assert_equal([10, -1, -1, 4], impl.to_ary)
 
-      impl.fill(0, 2, 2)
+      assert_same(impl, impl.fill(0, 2, 2))
       assert_equal([10, -1, 0, 0], impl.to_ary)
 
-      impl.fill(1, 3, 3)
+      assert_same(impl, impl.fill(1, 3, 3))
       assert_equal([10, -1, 0, 1, 1, 1], impl.to_ary)
 
-      impl.fill(2, 6, 1)
+      assert_same(impl, impl.fill(2, 6, 1))
       assert_equal([10, -1, 0, 1, 1, 1, 2], impl.to_ary)
 
-      impl.fill(3, 8, 3)
+      assert_same(impl, impl.fill(3, 8, 3))
       assert_equal([10, -1, 0, 1, 1, 1, 2, nil, 3, 3, 3], impl.to_ary)
 
       impl = klass.new([1, 2, 3, 4])
-      impl.fill(0, 2) { |i| 10 }
+      assert_same(impl, impl.fill(0, 2) { |i| 10 })
       assert_equal([10, 10, 3, 4], impl.to_ary)
 
-      impl.fill(1, 2) { |i| -1 }
+      assert_same(impl, impl.fill(1, 2) { |i| -1 })
       assert_equal([10, -1, -1, 4], impl.to_ary)
 
-      impl.fill(2, 2) { |i| i * 0 }
+      assert_same(impl, impl.fill(2, 2) { |i| i * 0 })
       assert_equal([10, -1, 0, 0], impl.to_ary)
 
-      impl.fill(3, 3) { |i| 1 }
+      assert_same(impl, impl.fill(3, 3) { |i| 1 })
       assert_equal([10, -1, 0, 1, 1, 1], impl.to_ary)
 
-      impl.fill(6, 1) { |i| i - 4 }
+      assert_same(impl, impl.fill(6, 1) { |i| i - 4 })
       assert_equal([10, -1, 0, 1, 1, 1, 2], impl.to_ary)
 
-      impl.fill(8, 3) { |i| i }
+      assert_same(impl, impl.fill(8, 3) { |i| i })
       assert_equal([10, -1, 0, 1, 1, 1, 2, nil, 8, 9, 10], impl.to_ary)
     end
   end
@@ -428,12 +422,12 @@ class TestRandomWritable < Test::Unit::TestCase
     FULL_IMPLS.each do |klass|
       msg = "Error in #{klass.name}"
       impl = klass.new([1, 2, 3])
-      impl.insert(2, -1, -2)
+      assert_same(impl, impl.insert(2, -1, -2))
       assert_equal([1, 2, -1, -2, 3], impl.to_ary, msg)
       assert_equal(5, impl.size, msg)
 
       impl = klass.new([1, 2, 3])
-      impl.insert(-2, -1, -2, -3)
+      assert_same(impl, impl.insert(-2, -1, -2, -3))
       assert_equal([1, 2, -1, -2, -3, 3], impl.to_ary, msg)
       assert_equal(6, impl.size, msg)
     end
@@ -446,7 +440,7 @@ class TestRandomWritable < Test::Unit::TestCase
     NOSIZE_IMPLS.each do |klass|
       msg = "Error in #{klass.name}"
       impl = klass.new([1, 2, 3])
-      impl.insert(2, -1, -2)
+      assert_same(impl, impl.insert(2, -1, -2))
       assert_equal([1, 2, -1, -2, 3], impl.to_ary, msg)
 
       impl = klass.new([1, 2, 3])
@@ -490,7 +484,7 @@ class TestRandomWritable < Test::Unit::TestCase
   def test_push
     (FULL_IMPLS + NODELETE_IMPLS).each do |klass|
       impl = klass.new([1])
-      impl.push(2, 3)
+      assert_same(impl, impl.push(2, 3))
       assert_equal([1, 2, 3], impl.to_ary)
       assert_equal(3, impl.size)
     end
@@ -503,17 +497,17 @@ class TestRandomWritable < Test::Unit::TestCase
   def test_replace
     (FULL_IMPLS + NODELETE_IMPLS).each do |klass|
       impl = klass.new([1, 2, 3])
-      impl.replace([4, 5, 6])
+      assert_same(impl, impl.replace([4, 5, 6]))
       assert_equal([4, 5, 6], impl.to_ary)
       assert_equal(3, impl.size)
 
       impl = klass.new([1, 2, 3])
-      impl.replace([4, 5])
+      assert_same(impl, impl.replace([4, 5]))
       assert_equal([4, 5], impl.to_ary)
       assert_equal(2, impl.size)
 
       impl = klass.new([1, 2, 3])
-      impl.replace([4, 5, 6, 7])
+      assert_same(impl, impl.replace([4, 5, 6, 7]))
       assert_equal([4, 5, 6, 7], impl.to_ary)
       assert_equal(4, impl.size)
     end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: random-accessible
 version: !ruby/object:Gem::Version
-  version: 0.1.4
+  version: 0.2.0
   prerelease: 
 platform: ruby
 authors:
@@ -9,13 +9,13 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2011-12-16 00:00:00.000000000 Z
+date: 2011-12-21 00:00:00.000000000 Z
 dependencies: []
 description: ! 'RandomAccessible mixin provides all methods of Array (regard as high-functioning
   edition of Enumerable).
 
   As a class includes Enumerable must provide "each" method, a class includes RandomAccessible
-  must have some methods. (please see the document for detail).
+  must have some methods. Please see the document for detail.
 
 
 '