arel 0.1.0

data/spec/arel/algebra/unit/predicates/equality_spec.rb

@@ -0,0 +1,27 @@
+require File.join(File.dirname(__FILE__), '..', '..', '..', '..', 'spec_helper')
+
+module Arel
+  describe Equality do
+    before do
+      @relation1 = Table.new(:users)
+      @relation2 = Table.new(:photos)
+      @attribute1 = @relation1[:id]
+      @attribute2 = @relation2[:user_id]
+    end
+
+    describe '==' do
+      it "obtains if attribute1 and attribute2 are identical" do
+        Equality.new(@attribute1, @attribute2).should == Equality.new(@attribute1, @attribute2)
+        Equality.new(@attribute1, @attribute2).should_not == Equality.new(@attribute1, @attribute1)
+      end
+
+      it "obtains if the concrete type of the predicates are identical" do
+        Equality.new(@attribute1, @attribute2).should_not == Binary.new(@attribute1, @attribute2)
+      end
+
+      it "is commutative on the attributes" do
+        Equality.new(@attribute1, @attribute2).should == Equality.new(@attribute2, @attribute1)
+      end
+    end
+  end
+end

data/spec/arel/algebra/unit/predicates/in_spec.rb

@@ -0,0 +1,10 @@
+require File.join(File.dirname(__FILE__), '..', '..', '..', '..', 'spec_helper')
+
+module Arel
+  describe In do
+    before do
+      @relation = Table.new(:users)
+      @attribute = @relation[:id]
+    end
+  end
+end

data/spec/arel/algebra/unit/primitives/attribute_spec.rb

@@ -0,0 +1,183 @@
+require File.join(File.dirname(__FILE__), '..', '..', '..', '..', 'spec_helper')
+
+module Arel
+  describe Attribute do
+    before do
+      @relation = Table.new(:users)
+      @attribute = @relation[:id]
+    end
+
+    describe "#inspect" do
+      it "returns a simple, short inspect string" do
+        @attribute.inspect.should == "<Attribute id>"
+      end
+    end
+
+    describe Attribute::Transformations do
+      describe '#as' do
+        it "manufactures an aliased attributed" do
+          @attribute.as(:alias).should == Attribute.new(@relation, @attribute.name, :alias => :alias, :ancestor => @attribute)
+        end
+      end
+
+      describe '#bind' do
+        it "manufactures an attribute with the relation bound and self as an ancestor" do
+          derived_relation = @relation.where(@relation[:id].eq(1))
+          @attribute.bind(derived_relation).should == Attribute.new(derived_relation, @attribute.name, :ancestor => @attribute)
+        end
+
+        it "returns self if the substituting to the same relation" do
+          @attribute.bind(@relation).should == @attribute
+        end
+      end
+
+      describe '#to_attribute' do
+        describe 'when the given relation is the same as the attributes relation' do
+          it "returns self" do
+            @attribute.to_attribute(@relation).should == @attribute
+          end
+        end
+
+        describe 'when the given relation differs from the attributes relation' do
+          it 'binds to the new relation' do
+            @attribute.to_attribute(new_relation = @relation.alias).should == @attribute.bind(new_relation)
+          end
+        end
+      end
+    end
+
+    describe '#column' do
+      it "returns the corresponding column in the relation" do
+        @attribute.column.should == @relation.column_for(@attribute)
+      end
+    end
+
+    describe '#engine' do
+      it "delegates to its relation" do
+        Attribute.new(@relation, :id).engine.should == @relation.engine
+      end
+    end
+
+    describe Attribute::Congruence do
+      describe '/' do
+        before do
+          @aliased_relation = @relation.alias
+          @doubly_aliased_relation = @aliased_relation.alias
+        end
+
+        describe 'when dividing two unrelated attributes' do
+          it "returns 0.0" do
+            (@relation[:id] / @relation[:name]).should == 0.0
+          end
+        end
+
+        describe 'when dividing two matching attributes' do
+          it 'returns a the highest score for the most similar attributes' do
+            (@aliased_relation[:id] / @relation[:id]) \
+              .should == (@aliased_relation[:id] / @relation[:id])
+            (@aliased_relation[:id] / @relation[:id]) \
+              .should < (@aliased_relation[:id] / @aliased_relation[:id])
+          end
+        end
+      end
+    end
+
+    describe Attribute::Predications do
+      before do
+        @attribute = Attribute.new(@relation, :name)
+      end
+
+      describe '#eq' do
+        it "manufactures an equality predicate" do
+          @attribute.eq('name').should == Equality.new(@attribute, 'name')
+        end
+      end
+
+      describe '#lt' do
+        it "manufactures a less-than predicate" do
+          @attribute.lt(10).should == LessThan.new(@attribute, 10)
+        end
+      end
+
+      describe '#lteq' do
+        it "manufactures a less-than or equal-to predicate" do
+          @attribute.lteq(10).should == LessThanOrEqualTo.new(@attribute, 10)
+        end
+      end
+
+      describe '#gt' do
+        it "manufactures a greater-than predicate" do
+          @attribute.gt(10).should == GreaterThan.new(@attribute, 10)
+        end
+      end
+
+      describe '#gteq' do
+        it "manufactures a greater-than or equal-to predicate" do
+          @attribute.gteq(10).should == GreaterThanOrEqualTo.new(@attribute, 10)
+        end
+      end
+
+      describe '#matches' do
+        it "manufactures a match predicate" do
+          @attribute.matches(/.*/).should == Match.new(@attribute, /.*/)
+        end
+      end
+
+      describe '#in' do
+        it "manufactures an in predicate" do
+          @attribute.in(1..30).should == In.new(@attribute, (1..30))
+        end
+      end
+    end
+
+    describe Attribute::Expressions do
+      before do
+        @attribute = Attribute.new(@relation, :name)
+      end
+
+      describe '#count' do
+        it "manufactures a count Expression" do
+          @attribute.count.should == Count.new(@attribute)
+        end
+      end
+
+      describe '#sum' do
+        it "manufactures a sum Expression" do
+          @attribute.sum.should == Sum.new(@attribute)
+        end
+      end
+
+      describe '#maximum' do
+        it "manufactures a maximum Expression" do
+          @attribute.maximum.should == Maximum.new(@attribute)
+        end
+      end
+
+      describe '#minimum' do
+        it "manufactures a minimum Expression" do
+          @attribute.minimum.should == Minimum.new(@attribute)
+        end
+      end
+
+      describe '#average' do
+        it "manufactures an average Expression" do
+          @attribute.average.should == Average.new(@attribute)
+        end
+      end
+    end
+
+    describe Attribute::Orderings do
+      describe '#asc' do
+        it 'manufactures an ascending ordering' do
+          @attribute.asc.should == Ascending.new(@attribute)
+        end
+      end
+
+      describe '#desc' do
+        it 'manufactures a descending ordering' do
+          @attribute.desc.should == Descending.new(@attribute)
+        end
+      end
+    end
+  end
+end

data/spec/arel/algebra/unit/primitives/expression_spec.rb

@@ -0,0 +1,45 @@
+require File.join(File.dirname(__FILE__), '..', '..', '..', '..', 'spec_helper')
+
+module Arel
+  describe Expression do
+    before do
+      @relation = Table.new(:users)
+      @attribute = @relation[:id]
+    end
+
+    describe "#inspect" do
+      it "returns a simple, short inspect string" do
+        @attribute.count.inspect.should == "<Arel::Count <Attribute id>>"
+      end
+    end
+
+    describe Expression::Transformations do
+      before do
+        @expression = Count.new(@attribute)
+      end
+
+      describe '#bind' do
+        it "manufactures an attribute with a rebound relation and self as the ancestor" do
+          derived_relation = @relation.where(@relation[:id].eq(1))
+          @expression.bind(derived_relation).should == Count.new(@attribute.bind(derived_relation), nil, @expression)
+        end
+
+        it "returns self if the substituting to the same relation" do
+          @expression.bind(@relation).should == @expression
+        end
+      end
+
+      describe '#as' do
+        it "manufactures an aliased expression" do
+          @expression.as(:alias).should == Expression.new(@attribute, :alias, @expression)
+        end
+      end
+
+      describe '#to_attribute' do
+        it "manufactures an attribute with the expression as an ancestor" do
+          @expression.to_attribute(@relation).should == Attribute.new(@relation, @expression.alias, :ancestor => @expression)
+        end
+      end
+    end
+  end
+end

data/spec/arel/algebra/unit/primitives/value_spec.rb

@@ -0,0 +1,15 @@
+require File.join(File.dirname(__FILE__), '..', '..', '..', '..', 'spec_helper')
+
+module Arel
+  describe Value do
+    before do
+      @relation = Table.new(:users)
+    end
+
+    describe '#bind' do
+      it "manufactures a new value whose relation is the provided relation" do
+        Value.new(1, @relation).bind(another_relation = Table.new(:photos)).should == Value.new(1, another_relation)
+      end
+    end
+  end
+end

data/spec/arel/algebra/unit/relations/alias_spec.rb

@@ -0,0 +1,16 @@
+require File.join(File.dirname(__FILE__), '..', '..', '..', '..', 'spec_helper')
+
+module Arel
+  describe Alias do
+    before do
+      @relation = Table.new(:users)
+    end
+
+    describe '==' do
+      it "obtains if the objects are the same" do
+        Alias.new(@relation).should_not == Alias.new(@relation)
+        (aliaz = Alias.new(@relation)).should == aliaz
+      end
+    end
+  end
+end

data/spec/arel/algebra/unit/relations/delete_spec.rb

@@ -0,0 +1,9 @@
+require File.join(File.dirname(__FILE__), '..', '..', '..', '..', 'spec_helper')
+
+module Arel
+  describe Deletion do
+    before do
+      @relation = Table.new(:users)
+    end
+  end
+end

data/spec/arel/algebra/unit/relations/group_spec.rb

@@ -0,0 +1,10 @@
+require File.join(File.dirname(__FILE__), '..', '..', '..', '..', 'spec_helper')
+
+module Arel
+  describe Group do
+    before do
+      @relation = Table.new(:users)
+      @attribute = @relation[:id]
+    end
+  end
+end

data/spec/arel/algebra/unit/relations/insert_spec.rb

@@ -0,0 +1,9 @@
+require File.join(File.dirname(__FILE__), '..', '..', '..', '..', 'spec_helper')
+
+module Arel
+  describe Insert do
+    before do
+      @relation = Table.new(:users)
+    end
+  end
+end

data/spec/arel/algebra/unit/relations/join_spec.rb

@@ -0,0 +1,26 @@
+require File.join(File.dirname(__FILE__), '..', '..', '..', '..', 'spec_helper')
+
+module Arel
+  describe Join do
+    before do
+      @relation1 = Table.new(:users)
+      @relation2 = Table.new(:photos)
+      @predicate = @relation1[:id].eq(@relation2[:user_id])
+    end
+
+    describe 'hashing' do
+      it 'implements hash equality' do
+        InnerJoin.new(@relation1, @relation2, @predicate) \
+          .should hash_the_same_as(InnerJoin.new(@relation1, @relation2, @predicate))
+      end
+    end
+
+    describe '#attributes' do
+      it 'combines the attributes of the two relations' do
+        join = InnerJoin.new(@relation1, @relation2, @predicate)
+        join.attributes.should ==
+          (@relation1.attributes + @relation2.attributes).collect { |a| a.bind(join) }
+      end
+    end
+  end
+end

data/spec/arel/algebra/unit/relations/order_spec.rb

@@ -0,0 +1,21 @@
+require File.join(File.dirname(__FILE__), '..', '..', '..', '..', 'spec_helper')
+
+module Arel
+  describe Order do
+    before do
+      @relation = Table.new(:users)
+      @attribute = @relation[:id]
+    end
+    
+    describe "#==" do
+      it "returns true when the Orders are for the same attribute and direction" do
+        Ascending.new(@attribute).should == Ascending.new(@attribute)
+      end
+
+      it "returns false when the Orders are for a diferent direction" do
+        Ascending.new(@attribute).should_not == Descending.new(@attribute)
+      end
+    end
+  end
+end
+

data/spec/arel/algebra/unit/relations/project_spec.rb

@@ -0,0 +1,34 @@
+require File.join(File.dirname(__FILE__), '..', '..', '..', '..', 'spec_helper')
+
+module Arel
+  describe Project do
+    before do
+      @relation = Table.new(:users)
+      @attribute = @relation[:id]
+    end
+
+    describe '#attributes' do
+      before do
+        @projection = Project.new(@relation, @attribute)
+      end
+
+      it "manufactures attributes associated with the projection relation" do
+        @projection.attributes.should == [@attribute].collect { |a| a.bind(@projection) }
+      end
+    end
+
+    describe '#externalizable?' do
+      describe 'when the projections are attributes' do
+        it 'returns false' do
+          Project.new(@relation, @attribute).should_not be_externalizable
+        end
+      end
+
+      describe 'when the projections include an aggregation' do
+        it "obtains" do
+          Project.new(@relation, @attribute.sum).should be_externalizable
+        end
+      end
+    end
+  end
+end

data/spec/arel/algebra/unit/relations/relation_spec.rb

@@ -0,0 +1,188 @@
+require File.join(File.dirname(__FILE__), '..', '..', '..', '..', 'spec_helper')
+
+module Arel
+  describe Relation do
+    before do
+      @relation = Table.new(:users)
+      @attribute1 = @relation[:id]
+      @attribute2 = @relation[:name]
+    end
+
+    describe '[]' do
+      describe 'when given an', Attribute do
+        it "return the attribute congruent to the provided attribute" do
+          @relation[@attribute1].should == @attribute1
+        end
+      end
+
+      describe 'when given a', Symbol, String do
+        it "returns the attribute with the same name, if it exists" do
+          @relation[:id].should == @attribute1
+          @relation['id'].should == @attribute1
+          @relation[:does_not_exist].should be_nil
+        end
+      end
+    end
+
+    describe Relation::Operable do
+      describe 'joins' do
+        before do
+          @predicate = @relation[:id].eq(@relation[:id])
+        end
+
+        describe '#join' do
+          describe 'when given a relation' do
+            it "manufactures an inner join operation between those two relations" do
+              @relation.join(@relation).on(@predicate). \
+                should == InnerJoin.new(@relation, @relation, @predicate)
+            end
+          end
+
+          describe "when given a string" do
+            it "manufactures a join operation with the string passed through" do
+              @relation.join(arbitrary_string = "ASDF").should == StringJoin.new(@relation, arbitrary_string)
+            end
+          end
+
+          describe "when given something blank" do
+            it "returns self" do
+              @relation.join.should == @relation
+            end
+          end
+        end
+
+        describe '#outer_join' do
+          it "manufactures a left outer join operation between those two relations" do
+            @relation.outer_join(@relation).on(@predicate). \
+              should == OuterJoin.new(@relation, @relation, @predicate)
+          end
+        end
+      end
+
+      describe '#project' do
+        it "manufactures a projection relation" do
+          @relation.project(@attribute1, @attribute2). \
+            should == Project.new(@relation, @attribute1, @attribute2)
+        end
+
+        describe "when given blank attributes" do
+          it "returns self" do
+            @relation.project.should == @relation
+          end
+        end
+      end
+
+      describe '#alias' do
+        it "manufactures an alias relation" do
+          @relation.alias.relation.should == Alias.new(@relation).relation
+        end
+      end
+
+      describe '#where' do
+        before do
+          @predicate = Equality.new(@attribute1, @attribute2)
+        end
+
+        it "manufactures a where relation" do
+          @relation.where(@predicate).should == Where.new(@relation, @predicate)
+        end
+
+        it "accepts arbitrary strings" do
+          @relation.where("arbitrary").should == Where.new(@relation, "arbitrary")
+        end
+
+        describe 'when given a blank predicate' do
+          it 'returns self' do
+            @relation.where.should == @relation
+          end
+        end
+      end
+
+      describe '#order' do
+        it "manufactures an order relation" do
+          @relation.order(@attribute1, @attribute2).should == Order.new(@relation, @attribute1, @attribute2)
+        end
+
+        describe 'when given a blank ordering' do
+          it 'returns self' do
+            @relation.order.should == @relation
+          end
+        end
+      end
+
+      describe '#take' do
+        it "manufactures a take relation" do
+          @relation.take(5).should == Take.new(@relation, 5)
+        end
+
+        describe 'when given a blank number of items' do
+          it 'returns self' do
+            @relation.take.should == @relation
+          end
+        end
+      end
+
+      describe '#skip' do
+        it "manufactures a skip relation" do
+          @relation.skip(4).should == Skip.new(@relation, 4)
+        end
+
+        describe 'when given a blank number of items' do
+          it 'returns self' do
+            @relation.skip.should == @relation
+          end
+        end
+      end
+
+      describe '#group' do
+        it 'manufactures a group relation' do
+          @relation.group(@attribute1, @attribute2).should == Group.new(@relation, @attribute1, @attribute2)
+        end
+
+        describe 'when given blank groupings' do
+          it 'returns self' do
+            @relation.group.should == @relation
+          end
+        end
+      end
+
+      describe Relation::Operable::Writable do
+        describe '#delete' do
+          it 'manufactures a deletion relation' do
+            Session.start do
+              mock(Session.new).delete(Deletion.new(@relation))
+              @relation.delete
+            end
+          end
+        end
+
+        describe '#insert' do
+          it 'manufactures an insertion relation' do
+            Session.start do
+              record = { @relation[:name] => 'carl' }
+              mock(Session.new).create(Insert.new(@relation, record))
+              @relation.insert(record)
+            end
+          end
+        end
+
+        describe '#update' do
+          it 'manufactures an update relation' do
+            Session.start do
+              assignments = { @relation[:name] => Value.new('bob', @relation) }
+              mock(Session.new).update(Update.new(@relation, assignments))
+              @relation.update(assignments)
+            end
+          end
+        end
+      end
+    end
+
+    describe Relation::Enumerable do
+      it "implements enumerable" do
+        @relation.collect.should == @relation.session.read(@relation).collect
+        @relation.first.should   == @relation.session.read(@relation).first
+      end
+    end
+  end
+end