immutable-ruby 0.0.1 → 0.1.0

data/spec/lib/immutable/list/join_spec.rb

@@ -1,63 +0,0 @@
-require "spec_helper"
-
-describe Immutable::List do
-  describe "#join" do
-    context "on a really big list" do
-      it "doesn't run out of stack" do
-        -> { Immutable.interval(0, STACK_OVERFLOW_DEPTH).join }.should_not raise_error
-      end
-    end
-
-    context "with a separator" do
-      [
-        [[], ""],
-        [["A"], "A"],
-        [%w[A B C], "A|B|C"]
-      ].each do |values, expected|
-        context "on #{values.inspect}" do
-          let(:list) { L[*values] }
-
-          it "preserves the original" do
-            list.join("|")
-            list.should eql(L[*values])
-          end
-
-          it "returns #{expected.inspect}" do
-            list.join("|").should == expected
-          end
-        end
-      end
-    end
-
-    context "without a separator" do
-      [
-        [[], ""],
-        [["A"], "A"],
-        [%w[A B C], "ABC"]
-      ].each do |values, expected|
-        context "on #{values.inspect}" do
-          let(:list) { L[*values] }
-
-          it "preserves the original" do
-            list.join
-            list.should eql(L[*values])
-          end
-
-          it "returns #{expected.inspect}" do
-            list.join.should == expected
-          end
-        end
-      end
-    end
-
-    context "without a separator (with global default separator set)" do
-      before { $, = '**' }
-      let(:list) { L["A", "B", "C"] }
-      after  { $, = nil }
-
-      it "uses the default global separator" do
-        list.join.should == "A**B**C"
-      end
-    end
-  end
-end

data/spec/lib/immutable/list/last_spec.rb

@@ -1,23 +0,0 @@
-require "spec_helper"
-
-describe Immutable::List do
-  describe "#last" do
-    context "on a really big list" do
-      it "doesn't run out of stack" do
-        -> { Immutable.interval(0, STACK_OVERFLOW_DEPTH).last }.should_not raise_error
-      end
-    end
-
-    [
-      [[], nil],
-      [["A"], "A"],
-      [%w[A B C], "C"],
-    ].each do |values, expected|
-      context "on #{values.inspect}" do
-        it "returns #{expected.inspect}" do
-          L[*values].last.should == expected
-        end
-      end
-    end
-  end
-end

data/spec/lib/immutable/list/ltlt_spec.rb

@@ -1,19 +0,0 @@
-require "spec_helper"
-
-describe Immutable::List do
-  describe "#<<" do
-    it "adds an item onto the end of a list" do
-      list = L["a", "b"]
-      (list << "c").should eql(L["a", "b", "c"])
-      list.should eql(L["a", "b"])
-    end
-
-    context "on an empty list" do
-      it "returns a list with one item" do
-        list = L.empty
-        (list << "c").should eql(L["c"])
-        list.should eql(L.empty)
-      end
-    end
-  end
-end

data/spec/lib/immutable/list/map_spec.rb

@@ -1,45 +0,0 @@
-require "spec_helper"
-
-describe Immutable::List do
-  [:map, :collect].each do |method|
-    describe "##{method}" do
-      it "is lazy" do
-        -> { Immutable.stream { fail }.map { |item| item } }.should_not raise_error
-      end
-
-      [
-        [[], []],
-        [["A"], ["a"]],
-        [%w[A B C], %w[a b c]],
-      ].each do |values, expected|
-        context "on #{values.inspect}" do
-          let(:list) { L[*values] }
-
-          context "with a block" do
-            it "preserves the original" do
-              list.send(method, &:downcase)
-              list.should eql(L[*values])
-            end
-
-            it "returns #{expected.inspect}" do
-              list.send(method, &:downcase).should eql(L[*expected])
-            end
-
-            it "is lazy" do
-              count = 0
-              list.send(method) { |item| count += 1 }
-              count.should <= 1
-            end
-          end
-
-          context "without a block" do
-            it "returns an Enumerator" do
-              list.send(method).class.should be(Enumerator)
-              list.send(method).each(&:downcase).should eql(L[*expected])
-            end
-          end
-        end
-      end
-    end
-  end
-end

data/spec/lib/immutable/list/maximum_spec.rb

@@ -1,39 +0,0 @@
-require "spec_helper"
-
-describe Immutable::List do
-  describe "#max" do
-    context "on a really big list" do
-      it "doesn't run out of stack" do
-        -> { Immutable.interval(0, STACK_OVERFLOW_DEPTH).max }.should_not raise_error
-      end
-    end
-
-    context "with a block" do
-      [
-        [[], nil],
-        [["A"], "A"],
-        [%w[Ichi Ni San], "Ichi"],
-      ].each do |values, expected|
-        context "on #{values.inspect}" do
-          it "returns #{expected.inspect}" do
-            L[*values].max { |maximum, item| maximum.length <=> item.length }.should == expected
-          end
-        end
-      end
-    end
-
-    context "without a block" do
-      [
-        [[], nil],
-        [["A"], "A"],
-        [%w[Ichi Ni San], "San"],
-      ].each do |values, expected|
-        context "on #{values.inspect}" do
-          it "returns #{expected.inspect}" do
-            L[*values].max.should == expected
-          end
-        end
-      end
-    end
-  end
-end

data/spec/lib/immutable/list/merge_by_spec.rb

@@ -1,51 +0,0 @@
-require "spec_helper"
-
-describe Immutable::List do
-  context "without a comparator" do
-    context "on an empty list" do
-      it "returns an empty list" do
-        L.empty.merge_by.should be_empty
-      end
-    end
-
-    context "on a single list" do
-      let(:list) { L[1, 2, 3] }
-
-      it "returns the list" do
-        L[list].merge_by.should eql(list)
-      end
-    end
-
-    context "with multiple lists" do
-      subject { L[L[3, 6, 7, 8], L[1, 2, 4, 5, 9]] }
-
-      it "merges the lists based on natural sort order" do
-        subject.merge_by.should == L[1, 2, 3, 4, 5, 6, 7, 8, 9]
-      end
-    end
-  end
-
-  context "with a comparator" do
-    context "on an empty list" do
-      it "returns an empty list" do
-        L.empty.merge_by { |item| fail("should never be called") }.should be_empty
-      end
-    end
-
-    context "on a single list" do
-      let(:list) { L[1, 2, 3] }
-
-      it "returns the list" do
-        L[list].merge_by { |item| -item }.should == L[1, 2, 3]
-      end
-    end
-
-    context "with multiple lists" do
-      subject { L[L[8, 7, 6, 3], L[9, 5, 4, 2, 1]] }
-
-      it "merges the lists based on the specified transformer" do
-        subject.merge_by { |item| -item }.should == L[9, 8, 7, 6, 5, 4, 3, 2, 1]
-      end
-    end
-  end
-end

data/spec/lib/immutable/list/merge_spec.rb

@@ -1,59 +0,0 @@
-require "spec_helper"
-
-describe Immutable::List do
-  context "without a comparator" do
-    context "on an empty list" do
-      subject { L.empty }
-
-      it "returns an empty list" do
-        subject.merge.should be_empty
-      end
-    end
-
-    context "on a single list" do
-      let(:list) { L[1, 2, 3] }
-
-      subject { L[list] }
-
-      it "returns the list" do
-        subject.merge.should == list
-      end
-    end
-
-    context "with multiple lists" do
-      subject { L[L[3, 6, 7, 8], L[1, 2, 4, 5, 9]] }
-
-      it "merges the lists based on natural sort order" do
-        subject.merge.should == L[1, 2, 3, 4, 5, 6, 7, 8, 9]
-      end
-    end
-  end
-
-  context "with a comparator" do
-    context "on an empty list" do
-      subject { L.empty }
-
-      it "returns an empty list" do
-        subject.merge { |a, b| fail("should never be called") }.should be_empty
-      end
-    end
-
-    context "on a single list" do
-      let(:list) { L[1, 2, 3] }
-
-      subject { L[list] }
-
-      it "returns the list" do
-        subject.merge { |a, b| fail("should never be called") }.should == list
-      end
-    end
-
-    context "with multiple lists" do
-      subject { L[L[8, 7, 6, 3], L[9, 5, 4, 2, 1]] }
-
-      it "merges the lists based on the specified comparator" do
-        subject.merge { |a, b| b <=> a }.should == L[9, 8, 7, 6, 5, 4, 3, 2, 1]
-      end
-    end
-  end
-end

data/spec/lib/immutable/list/minimum_spec.rb

@@ -1,39 +0,0 @@
-require "spec_helper"
-
-describe Immutable::List do
-  describe "#min" do
-    context "on a really big list" do
-      it "doesn't run out of stack" do
-        -> { Immutable.interval(0, STACK_OVERFLOW_DEPTH).min }.should_not raise_error
-      end
-    end
-
-    context "with a block" do
-      [
-        [[], nil],
-        [["A"], "A"],
-        [%w[Ichi Ni San], "Ni"],
-      ].each do |values, expected|
-        context "on #{values.inspect}" do
-          it "returns #{expected.inspect}" do
-            L[*values].min { |minimum, item| minimum.length <=> item.length }.should == expected
-          end
-        end
-      end
-    end
-
-    context "without a block" do
-      [
-        [[], nil],
-        [["A"], "A"],
-        [%w[Ichi Ni San], "Ichi"],
-      ].each do |values, expected|
-        context "on #{values.inspect}" do
-          it "returns #{expected.inspect}" do
-            L[*values].min.should == expected
-          end
-        end
-      end
-    end
-  end
-end

data/spec/lib/immutable/list/multithreading_spec.rb

@@ -1,47 +0,0 @@
-require "spec_helper"
-require "concurrent/atomics"
-
-describe Immutable::List do
-  it "ensures each node of a lazy list will only be realized on ONE thread, even when accessed by multiple threads" do
-    counter = Concurrent::Atomic.new(0)
-    list = (1..10000).to_list.map { |x| counter.update { |count| count + 1 }; x * 2 }
-
-    threads = 10.times.collect do
-      Thread.new do
-        node = list
-        node = node.tail until node.empty?
-      end
-    end
-    threads.each(&:join)
-
-    counter.get.should == 10000
-    list.sum.should == 100010000
-  end
-
-  it "doesn't go into an infinite loop if lazy list block raises an exception" do
-    list = (1..10).to_list.map { raise "Oops!" }
-
-    threads = 10.times.collect do
-      Thread.new do
-        -> { list.head }.should raise_error(RuntimeError)
-      end
-    end
-    threads.each(&:join)
-  end
-
-  it "doesn't give horrendously bad performance if thread realizing the list sleeps" do
-    start = Time.now
-    list  = (1..100).to_list.map { |x| sleep(0.001); x * 2 }
-
-    threads = 10.times.collect do
-      Thread.new do
-        node = list
-        node = node.tail until node.empty?
-      end
-    end
-    threads.each(&:join)
-
-    elapsed = Time.now - start
-    elapsed.should_not > 0.3
-  end
-end

data/spec/lib/immutable/list/none_spec.rb

@@ -1,47 +0,0 @@
-require "spec_helper"
-
-describe Immutable::List do
-  describe "#none?" do
-    context "on a really big list" do
-      it "doesn't run out of stack" do
-        -> { Immutable.interval(0, STACK_OVERFLOW_DEPTH).none? { false } }.should_not raise_error
-      end
-    end
-
-    context "when empty" do
-      it "with a block returns true" do
-        L.empty.none? {}.should == true
-      end
-
-      it "with no block returns true" do
-        L.empty.none?.should == true
-      end
-    end
-
-    context "when not empty" do
-      context "with a block" do
-        let(:list) { L["A", "B", "C", nil] }
-
-        ["A", "B", "C", nil].each do |value|
-          it "returns false if the block ever returns true (#{value.inspect})" do
-            list.none? { |item| item == value }.should == false
-          end
-        end
-
-        it "returns true if the block always returns false" do
-          list.none? { |item| item == "D" }.should == true
-        end
-      end
-
-      context "with no block" do
-        it "returns false if any value is truthy" do
-          L[nil, false, true, "A"].none?.should == false
-        end
-
-        it "returns true if all values are falsey" do
-          L[nil, false].none?.should == true
-        end
-      end
-    end
-  end
-end

data/spec/lib/immutable/list/one_spec.rb

@@ -1,49 +0,0 @@
-require "spec_helper"
-
-describe Immutable::List do
-  describe "#one?" do
-    context "on a really big list" do
-      it "doesn't run out of stack" do
-        -> { Immutable.interval(0, STACK_OVERFLOW_DEPTH).one? { false } }.should_not raise_error
-      end
-    end
-
-    context "when empty" do
-      it "with a block returns false" do
-        L.empty.one? {}.should == false
-      end
-
-      it "with no block returns false" do
-        L.empty.one?.should == false
-      end
-    end
-
-    context "when not empty" do
-      context "with a block" do
-        let(:list) { L["A", "B", "C"] }
-
-        it "returns false if the block returns true more than once" do
-          list.one? { |item| true }.should == false
-        end
-
-        it "returns false if the block never returns true" do
-          list.one? { |item| false }.should == false
-        end
-
-        it "returns true if the block only returns true once" do
-          list.one? { |item| item == "A" }.should == true
-        end
-      end
-
-      context "with no block" do
-        it "returns false if more than one value is truthy" do
-          L[nil, true, "A"].one?.should == false
-        end
-
-        it "returns true if only one value is truthy" do
-          L[nil, true, false].one?.should == true
-        end
-      end
-    end
-  end
-end

data/spec/lib/immutable/list/partition_spec.rb

@@ -1,115 +0,0 @@
-require "spec_helper"
-require "thread"
-
-describe Immutable::List do
-  describe "#partition" do
-    it "is lazy" do
-      -> { Immutable.stream { fail }.partition }.should_not raise_error
-    end
-
-    it "calls the passed block only once for each item" do
-      count = 0
-      a,b = L[1, 2, 3].partition { |item| count += 1; item.odd? }
-      (a.size + b.size).should be(3) # force realization of lazy lists
-      count.should be(3)
-    end
-
-    # note: Lists are not as lazy as they could be!
-    # they always realize elements a bit ahead of the current one
-
-    it "returns a lazy list of items for which predicate is true" do
-      count = 0
-      a,b = L[1, 2, 3, 4].partition { |item| count += 1; item.odd? }
-      a.take(1).should == [1]
-      count.should be(3) # would be 1 if lists were lazier
-      a.take(2).should == [1, 3]
-      count.should be(4) # would be 3 if lists were lazier
-    end
-
-    it "returns a lazy list of items for which predicate is false" do
-      count = 0
-      a,b = L[1, 2, 3, 4].partition { |item| count += 1; item.odd? }
-      b.take(1).should == [2]
-      count.should be(4) # would be 2 if lists were lazier
-      b.take(2).should == [2, 4]
-      count.should be(4)
-    end
-
-    it "calls the passed block only once for each item, even with multiple threads" do
-      mutex = Mutex.new
-      yielded = [] # record all the numbers yielded to the block, to make sure each is yielded only once
-      list = Immutable.iterate(0) do |n|
-        sleep(rand / 500) # give another thread a chance to get in
-        mutex.synchronize { yielded << n }
-        sleep(rand / 500)
-        n + 1
-      end
-      left, right = list.partition(&:odd?)
-
-      10.times.collect do |i|
-        Thread.new do
-          # half of the threads will consume the "left" lazy list, while half consume
-          # the "right" lazy list
-          # make sure that only one thread will run the above "iterate" block at a
-          # time, regardless
-          if i % 2 == 0
-            left.take(100).sum.should == 10000
-          else
-            right.take(100).sum.should == 9900
-          end
-        end
-      end.each(&:join)
-
-      # if no threads "stepped on" each other, the following should be true
-      # make some allowance for "lazy" lists which actually realize a little bit ahead:
-      (200..203).include?(yielded.size).should == true
-      yielded.should == (0..(yielded.size-1)).to_a
-    end
-
-    [
-      [[], [], []],
-      [[1], [1], []],
-      [[1, 2], [1], [2]],
-      [[1, 2, 3], [1, 3], [2]],
-      [[1, 2, 3, 4], [1, 3], [2, 4]],
-      [[2, 3, 4], [3], [2, 4]],
-      [[3, 4], [3], [4]],
-      [[4], [], [4]],
-    ].each do |values, expected_matches, expected_remainder|
-      context "on #{values.inspect}" do
-        let(:list) { L[*values] }
-
-        context "with a block" do
-          let(:result)  { list.partition(&:odd?) }
-          let(:matches) { result.first }
-          let(:remainder) { result.last }
-
-          it "preserves the original" do
-            list.should eql(L[*values])
-          end
-
-          it "returns a frozen array with two items" do
-            result.class.should be(Array)
-            result.should be_frozen
-            result.size.should be(2)
-          end
-
-          it "correctly identifies the matches" do
-            matches.should eql(L[*expected_matches])
-          end
-
-          it "correctly identifies the remainder" do
-            remainder.should eql(L[*expected_remainder])
-          end
-        end
-
-        context "without a block" do
-          it "returns an Enumerator" do
-            list.partition.class.should be(Enumerator)
-            list.partition.each(&:odd?).should eql([L[*expected_matches], L[*expected_remainder]])
-          end
-        end
-      end
-    end
-  end
-end

data/spec/lib/immutable/list/permutation_spec.rb

@@ -1,55 +0,0 @@
-require "spec_helper"
-
-describe Immutable::List do
-  describe "#permutation" do
-    let(:list) { L[1,2,3,4] }
-
-    context "with no block" do
-      it "returns an Enumerator" do
-        list.permutation.class.should be(Enumerator)
-        list.permutation.to_a.sort.should == [1,2,3,4].permutation.to_a.sort
-      end
-    end
-
-    context "with no argument" do
-      it "yields all permutations of the list" do
-        perms = list.permutation.to_a
-        perms.size.should be(24)
-        perms.sort.should == [1,2,3,4].permutation.to_a.sort
-        perms.each { |item| item.should be_kind_of(Immutable::List) }
-      end
-    end
-
-    context "with a length argument" do
-      it "yields all N-size permutations of the list" do
-        perms = list.permutation(2).to_a
-        perms.size.should be(12)
-        perms.sort.should == [1,2,3,4].permutation(2).to_a.sort
-        perms.each { |item| item.should be_kind_of(Immutable::List) }
-      end
-    end
-
-    context "with a length argument greater than length of list" do
-      it "yields nothing" do
-        list.permutation(5).to_a.should be_empty
-      end
-    end
-
-    context "with a length argument of 0" do
-      it "yields an empty list" do
-        perms = list.permutation(0).to_a
-        perms.size.should be(1)
-        perms[0].should be_kind_of(Immutable::List)
-        perms[0].should be_empty
-      end
-    end
-
-    context "with a block" do
-      it "returns the original list" do
-        list.permutation(0) {}.should be(list)
-        list.permutation(1) {}.should be(list)
-        list.permutation {}.should be(list)
-      end
-    end
-  end
-end

data/spec/lib/immutable/list/pop_spec.rb

@@ -1,25 +0,0 @@
-require "spec_helper"
-
-describe Immutable::List do
-  let(:list) { L[*values] }
-
-  describe "#pop" do
-    let(:pop) { list.pop }
-
-    context "with an empty list" do
-      let(:values) { [] }
-
-      it "returns an empty list" do
-        expect(pop).to eq(L.empty)
-      end
-    end
-
-    context "with a list with a few items" do
-      let(:values) { %w[a b c] }
-
-      it "removes the last item" do
-        expect(pop).to eq(L["a", "b"])
-      end
-    end
-  end
-end