hamster 1.0.1.pre.rc2 → 1.0.1.pre.rc3

data/spec/lib/hamster/list/rotate_spec.rb

@@ -0,0 +1,37 @@
+require "spec_helper"
+require "hamster/list"
+
+describe Hamster::List do
+  describe "#rotate" do
+    let(:list) { Hamster.list(1,2,3,4,5) }
+
+    context "when passed no argument" do
+      it "returns a new list with the first element moved to the end" do
+        list.rotate.should eql(Hamster.list(2,3,4,5,1))
+      end
+    end
+
+    context "with an integral argument n" do
+      it "returns a new list with the first (n % size) elements moved to the end" do
+        list.rotate(2).should eql(Hamster.list(3,4,5,1,2))
+        list.rotate(3).should eql(Hamster.list(4,5,1,2,3))
+        list.rotate(4).should eql(Hamster.list(5,1,2,3,4))
+        list.rotate(5).should eql(Hamster.list(1,2,3,4,5))
+        list.rotate(-1).should eql(Hamster.list(5,1,2,3,4))
+      end
+    end
+
+    context "with a non-numeric argument" do
+      it "raises a TypeError" do
+        -> { list.rotate('hello') }.should raise_error(TypeError)
+      end
+    end
+
+    context "with an argument of zero (or one evenly divisible by list length)" do
+      it "it returns self" do
+        list.rotate(0).should be(list)
+        list.rotate(5).should be(list)
+      end
+    end
+  end
+end

data/spec/lib/hamster/list/sample_spec.rb

@@ -0,0 +1,14 @@
+require "spec_helper"
+require "hamster/list"
+
+describe Hamster::List do
+  describe "#sample" do
+    let(:list) { Hamster.list(*(1..10)) }
+
+    it "returns a randomly chosen item" do
+      chosen = 100.times.map { list.sample }
+      chosen.each { |item| list.include?(item).should == true }
+      list.each { |item| chosen.include?(item).should == true }
+    end
+  end
+end

data/spec/{hamster → lib/hamster}/list/select_spec.rb

@@ -26,8 +26,9 @@ describe Hamster::List do
       context "without a block" do
         let(:select) { list.select }
 
-        it "returns itself" do
-          expect(select).to eq(list)
+        it "returns an Enumerator" do
+          expect(select.class).to be(Enumerator)
+          expect(select.each { |item| item == item.upcase }).to eq(selected_list)
         end
       end
     end

data/spec/{hamster → lib/hamster}/list/size_spec.rb

@@ -4,13 +4,9 @@ require "hamster/list"
 describe Hamster::List do
   [:size, :length].each do |method|
     describe "##{method}" do
-      describe "on a really big list" do
-        before do
-          @list = Hamster.interval(0, STACK_OVERFLOW_DEPTH)
-        end
-
+      context "on a really big list" do
         it "doesn't run out of stack" do
-          -> { @list.size }.should_not raise_error
+          -> { Hamster.interval(0, STACK_OVERFLOW_DEPTH).size }.should_not raise_error
         end
       end
 
@@ -19,14 +15,9 @@ describe Hamster::List do
         [["A"], 1],
         [%w[A B C], 3],
       ].each do |values, expected|
-
-        describe "on #{values.inspect}" do
-          before do
-            @list = Hamster.list(*values)
-          end
-
+        context "on #{values.inspect}" do
           it "returns #{expected.inspect}" do
-            @list.send(method).should == expected
+            Hamster.list(*values).send(method).should == expected
           end
         end
       end

data/spec/lib/hamster/list/slice_spec.rb

@@ -0,0 +1,230 @@
+require "spec_helper"
+require "hamster/list"
+
+describe Hamster::List do
+  let(:list) { Hamster.list(1,2,3,4) }
+  let(:big)  { Hamster.list(*1..10000) }
+
+  [:slice, :[]].each do |method|
+    describe "##{method}" do
+      context "when passed a positive integral index" do
+        it "returns the element at that index" do
+          list.send(method, 0).should be(1)
+          list.send(method, 1).should be(2)
+          list.send(method, 2).should be(3)
+          list.send(method, 3).should be(4)
+          list.send(method, 4).should be(nil)
+          list.send(method, 10).should be(nil)
+
+          big.send(method, 0).should be(1)
+          big.send(method, 9999).should be(10000)
+        end
+
+        it "leaves the original unchanged" do
+          list.should eql(Hamster.list(1,2,3,4))
+        end
+      end
+
+      context "when passed a negative integral index" do
+        it "returns the element which is number (index.abs) counting from the end of the list" do
+          list.send(method, -1).should be(4)
+          list.send(method, -2).should be(3)
+          list.send(method, -3).should be(2)
+          list.send(method, -4).should be(1)
+          list.send(method, -5).should be(nil)
+          list.send(method, -10).should be(nil)
+
+          big.send(method, -1).should be(10000)
+          big.send(method, -10000).should be(1)
+        end
+      end
+
+      context "when passed a positive integral index and count" do
+        it "returns 'count' elements starting from 'index'" do
+          list.send(method, 0, 0).should eql(Hamster.list)
+          list.send(method, 0, 1).should eql(Hamster.list(1))
+          list.send(method, 0, 2).should eql(Hamster.list(1,2))
+          list.send(method, 0, 4).should eql(Hamster.list(1,2,3,4))
+          list.send(method, 0, 6).should eql(Hamster.list(1,2,3,4))
+          list.send(method, 0, -1).should be_nil
+          list.send(method, 0, -2).should be_nil
+          list.send(method, 0, -4).should be_nil
+          list.send(method, 2, 0).should eql(Hamster.list)
+          list.send(method, 2, 1).should eql(Hamster.list(3))
+          list.send(method, 2, 2).should eql(Hamster.list(3,4))
+          list.send(method, 2, 4).should eql(Hamster.list(3,4))
+          list.send(method, 2, -1).should be_nil
+          list.send(method, 4, 0).should eql(Hamster.list)
+          list.send(method, 4, 2).should eql(Hamster.list)
+          list.send(method, 4, -1).should be_nil
+          list.send(method, 5, 0).should be_nil
+          list.send(method, 5, 2).should be_nil
+          list.send(method, 5, -1).should be_nil
+          list.send(method, 6, 0).should be_nil
+          list.send(method, 6, 2).should be_nil
+          list.send(method, 6, -1).should be_nil
+
+          big.send(method, 0, 3).should eql(Hamster.list(1,2,3))
+          big.send(method, 1023, 4).should eql(Hamster.list(1024,1025,1026,1027))
+          big.send(method, 1024, 4).should eql(Hamster.list(1025,1026,1027,1028))
+        end
+
+        it "leaves the original unchanged" do
+          list.should eql(Hamster.list(1,2,3,4))
+        end
+      end
+
+      context "when passed a negative integral index and count" do
+        it "returns 'count' elements, starting from index which is number 'index.abs' counting from the end of the array" do
+          list.send(method, -1, 0).should eql(Hamster.list)
+          list.send(method, -1, 1).should eql(Hamster.list(4))
+          list.send(method, -1, 2).should eql(Hamster.list(4))
+          list.send(method, -1, -1).should be_nil
+          list.send(method, -2, 0).should eql(Hamster.list)
+          list.send(method, -2, 1).should eql(Hamster.list(3))
+          list.send(method, -2, 2).should eql(Hamster.list(3,4))
+          list.send(method, -2, 4).should eql(Hamster.list(3,4))
+          list.send(method, -2, -1).should be_nil
+          list.send(method, -4, 0).should eql(Hamster.list)
+          list.send(method, -4, 1).should eql(Hamster.list(1))
+          list.send(method, -4, 2).should eql(Hamster.list(1,2))
+          list.send(method, -4, 4).should eql(Hamster.list(1,2,3,4))
+          list.send(method, -4, 6).should eql(Hamster.list(1,2,3,4))
+          list.send(method, -4, -1).should be_nil
+          list.send(method, -5, 0).should be_nil
+          list.send(method, -5, 1).should be_nil
+          list.send(method, -5, 10).should be_nil
+          list.send(method, -5, -1).should be_nil
+
+          big.send(method, -1, 1).should eql(Hamster.list(10000))
+          big.send(method, -1, 2).should eql(Hamster.list(10000))
+          big.send(method, -6, 2).should eql(Hamster.list(9995,9996))
+        end
+      end
+
+      context "when passed a Range" do
+        it "returns the elements whose indexes are within the given Range" do
+          list.send(method, 0..-1).should eql(Hamster.list(1,2,3,4))
+          list.send(method, 0..-10).should eql(Hamster.list)
+          list.send(method, 0..0).should eql(Hamster.list(1))
+          list.send(method, 0..1).should eql(Hamster.list(1,2))
+          list.send(method, 0..2).should eql(Hamster.list(1,2,3))
+          list.send(method, 0..3).should eql(Hamster.list(1,2,3,4))
+          list.send(method, 0..4).should eql(Hamster.list(1,2,3,4))
+          list.send(method, 0..10).should eql(Hamster.list(1,2,3,4))
+          list.send(method, 2..-10).should eql(Hamster.list)
+          list.send(method, 2..0).should eql(Hamster.list)
+          list.send(method, 2..2).should eql(Hamster.list(3))
+          list.send(method, 2..3).should eql(Hamster.list(3,4))
+          list.send(method, 2..4).should eql(Hamster.list(3,4))
+          list.send(method, 3..0).should eql(Hamster.list)
+          list.send(method, 3..3).should eql(Hamster.list(4))
+          list.send(method, 3..4).should eql(Hamster.list(4))
+          list.send(method, 4..0).should eql(Hamster.list)
+          list.send(method, 4..4).should eql(Hamster.list)
+          list.send(method, 4..5).should eql(Hamster.list)
+          list.send(method, 5..0).should be_nil
+          list.send(method, 5..5).should be_nil
+          list.send(method, 5..6).should be_nil
+
+          big.send(method, 159..162).should eql(Hamster.list(160,161,162,163))
+          big.send(method, 160..162).should eql(Hamster.list(161,162,163))
+          big.send(method, 161..162).should eql(Hamster.list(162,163))
+          big.send(method, 9999..10100).should eql(Hamster.list(10000))
+          big.send(method, 10000..10100).should eql(Hamster.list)
+          big.send(method, 10001..10100).should be_nil
+
+          list.send(method, 0...-1).should eql(Hamster.list(1,2,3))
+          list.send(method, 0...-10).should eql(Hamster.list)
+          list.send(method, 0...0).should eql(Hamster.list)
+          list.send(method, 0...1).should eql(Hamster.list(1))
+          list.send(method, 0...2).should eql(Hamster.list(1,2))
+          list.send(method, 0...3).should eql(Hamster.list(1,2,3))
+          list.send(method, 0...4).should eql(Hamster.list(1,2,3,4))
+          list.send(method, 0...10).should eql(Hamster.list(1,2,3,4))
+          list.send(method, 2...-10).should eql(Hamster.list)
+          list.send(method, 2...0).should eql(Hamster.list)
+          list.send(method, 2...2).should eql(Hamster.list)
+          list.send(method, 2...3).should eql(Hamster.list(3))
+          list.send(method, 2...4).should eql(Hamster.list(3,4))
+          list.send(method, 3...0).should eql(Hamster.list)
+          list.send(method, 3...3).should eql(Hamster.list)
+          list.send(method, 3...4).should eql(Hamster.list(4))
+          list.send(method, 4...0).should eql(Hamster.list)
+          list.send(method, 4...4).should eql(Hamster.list)
+          list.send(method, 4...5).should eql(Hamster.list)
+          list.send(method, 5...0).should be_nil
+          list.send(method, 5...5).should be_nil
+          list.send(method, 5...6).should be_nil
+
+          big.send(method, 159...162).should eql(Hamster.list(160,161,162))
+          big.send(method, 160...162).should eql(Hamster.list(161,162))
+          big.send(method, 161...162).should eql(Hamster.list(162))
+          big.send(method, 9999...10100).should eql(Hamster.list(10000))
+          big.send(method, 10000...10100).should eql(Hamster.list)
+          big.send(method, 10001...10100).should be_nil
+
+          list.send(method, -1..-1).should eql(Hamster.list(4))
+          list.send(method, -1...-1).should eql(Hamster.list)
+          list.send(method, -1..3).should eql(Hamster.list(4))
+          list.send(method, -1...3).should eql(Hamster.list)
+          list.send(method, -1..4).should eql(Hamster.list(4))
+          list.send(method, -1...4).should eql(Hamster.list(4))
+          list.send(method, -1..10).should eql(Hamster.list(4))
+          list.send(method, -1...10).should eql(Hamster.list(4))
+          list.send(method, -1..0).should eql(Hamster.list)
+          list.send(method, -1..-4).should eql(Hamster.list)
+          list.send(method, -1...-4).should eql(Hamster.list)
+          list.send(method, -1..-6).should eql(Hamster.list)
+          list.send(method, -1...-6).should eql(Hamster.list)
+          list.send(method, -2..-2).should eql(Hamster.list(3))
+          list.send(method, -2...-2).should eql(Hamster.list)
+          list.send(method, -2..-1).should eql(Hamster.list(3,4))
+          list.send(method, -2...-1).should eql(Hamster.list(3))
+          list.send(method, -2..10).should eql(Hamster.list(3,4))
+          list.send(method, -2...10).should eql(Hamster.list(3,4))
+
+          big.send(method, -1..-1).should eql(Hamster.list(10000))
+          big.send(method, -1..9999).should eql(Hamster.list(10000))
+          big.send(method, -1...9999).should eql(Hamster.list)
+          big.send(method, -2...9999).should eql(Hamster.list(9999))
+          big.send(method, -2..-1).should eql(Hamster.list(9999,10000))
+
+          list.send(method, -4..-4).should eql(Hamster.list(1))
+          list.send(method, -4..-2).should eql(Hamster.list(1,2,3))
+          list.send(method, -4...-2).should eql(Hamster.list(1,2))
+          list.send(method, -4..-1).should eql(Hamster.list(1,2,3,4))
+          list.send(method, -4...-1).should eql(Hamster.list(1,2,3))
+          list.send(method, -4..3).should eql(Hamster.list(1,2,3,4))
+          list.send(method, -4...3).should eql(Hamster.list(1,2,3))
+          list.send(method, -4..4).should eql(Hamster.list(1,2,3,4))
+          list.send(method, -4...4).should eql(Hamster.list(1,2,3,4))
+          list.send(method, -4..0).should eql(Hamster.list(1))
+          list.send(method, -4...0).should eql(Hamster.list)
+          list.send(method, -4..1).should eql(Hamster.list(1,2))
+          list.send(method, -4...1).should eql(Hamster.list(1))
+
+          list.send(method, -5..-5).should be_nil
+          list.send(method, -5...-5).should be_nil
+          list.send(method, -5..-4).should be_nil
+          list.send(method, -5..-1).should be_nil
+          list.send(method, -5..10).should be_nil
+
+          big.send(method, -10001..-1).should be_nil
+        end
+
+        it "leaves the original unchanged" do
+          list.should eql(Hamster.list(1,2,3,4))
+        end
+      end
+    end
+
+    context "when passed a subclass of Range" do
+      it "works the same as with a Range" do
+        subclass = Class.new(Range)
+        list.send(method, subclass.new(1,2)).should eql(Hamster.list(2,3))
+        list.send(method, subclass.new(-3,-1,true)).should eql(Hamster.list(2,3))
+      end
+    end
+  end
+end

data/spec/{hamster → lib/hamster}/list/sorting_spec.rb

@@ -6,7 +6,6 @@ describe Hamster::List do
     [:sort, ->(left, right) { left.length <=> right.length }],
     [:sort_by, ->(item) { item.length }],
   ].each do |method, comparator|
-
     describe "##{method}" do
       it "is lazy" do
         -> { Hamster.stream { fail }.send(method, &comparator) }.should_not raise_error
@@ -17,37 +16,28 @@ describe Hamster::List do
         [["A"], ["A"]],
         [%w[Ichi Ni San], %w[Ni San Ichi]],
       ].each do |values, expected|
+        context "on #{values.inspect}" do
+          let(:list) { Hamster.list(*values) }
 
-        describe "on #{values.inspect}" do
-          before do
-            @original = Hamster.list(*values)
-          end
-
-          describe "with a block" do
-            before do
-              @result = @original.send(method, &comparator)
-            end
-
+          context "with a block" do
             it "preserves the original" do
-              @original.should == Hamster.list(*values)
+              list.send(method, &comparator)
+              list.should == Hamster.list(*values)
             end
 
             it "returns #{expected.inspect}" do
-              @result.should == Hamster.list(*expected)
+              list.send(method, &comparator).should == Hamster.list(*expected)
             end
           end
 
-          describe "without a block" do
-            before do
-              @result = @original.send(method)
-            end
-
+          context "without a block" do
             it "preserves the original" do
-              @original.should == Hamster.list(*values)
+              list.send(method)
+              list.should eql(Hamster.list(*values))
             end
 
             it "returns #{expected.sort.inspect}" do
-              @result.should == Hamster.list(*expected.sort)
+              list.send(method).should == Hamster.list(*expected.sort)
             end
           end
         end

data/spec/lib/hamster/list/span_spec.rb

@@ -0,0 +1,77 @@
+require "spec_helper"
+require "hamster/list"
+
+describe "Hamster.list#span" do
+  it "is lazy" do
+    -> { Hamster.stream { |item| fail }.span { true } }.should_not raise_error
+  end
+
+  describe <<-DESC do
+given a predicate (in the form of a block), splits the list into two lists
+  (returned as an array) such that elements in the first list (the prefix) are
+  taken from the head of the list while the predicate is satisfied, and elements
+  in the second list (the remainder) are the remaining elements from the list
+  once the predicate is not satisfied. For example:
+DESC
+
+    [
+      [[], [], []],
+      [[1], [1], []],
+      [[1, 2], [1, 2], []],
+      [[1, 2, 3], [1, 2], [3]],
+      [[1, 2, 3, 4], [1, 2], [3, 4]],
+      [[2, 3, 4], [2], [3, 4]],
+      [[3, 4], [], [3, 4]],
+      [[4], [], [4]],
+    ].each do |values, expected_prefix, expected_remainder|
+      context "given the list #{values.inspect}" do
+        let(:list) { Hamster.list(*values) }
+
+        context "and a predicate that returns true for values <= 2" do
+          let(:result) { list.span { |item| item <= 2 }}
+          let(:prefix) { result.first }
+          let(:remainder) { result.last }
+
+          it "preserves the original" do
+            result
+            list.should eql(Hamster.list(*values))
+          end
+
+          it "returns the prefix as #{expected_prefix.inspect}" do
+            prefix.should eql(Hamster.list(*expected_prefix))
+          end
+
+          it "returns the remainder as #{expected_remainder.inspect}" do
+            remainder.should eql(Hamster.list(*expected_remainder))
+          end
+
+          it "calls the block only once for each element" do
+            count = 0
+            result = list.span { |item| count += 1; item <= 2 }
+            # force realization of lazy lists
+            result.first.size.should == expected_prefix.size
+            result.last.size.should == expected_remainder.size
+            # it may not need to call the block on every element, just up to the
+            # point where the block first returns a false value
+            count.should <= values.size
+          end
+        end
+
+        context "without a predicate" do
+          it "returns a frozen array" do
+            list.span.class.should be(Array)
+            list.span.should be_frozen
+          end
+
+          it "returns self as the prefix" do
+            list.span.first.should equal(list)
+          end
+
+          it "returns an empty list as the remainder" do
+            list.span.last.should be_empty
+          end
+        end
+      end
+    end
+  end
+end