veritas-sql-generator 0.0.3

data/spec/unit/veritas/sql/generator/relation/unary/visit_veritas_relation_operation_order_spec.rb

@@ -0,0 +1,136 @@
+# encoding: utf-8
+
+require 'spec_helper'
+
+describe SQL::Generator::Relation::Unary, '#visit_veritas_relation_operation_order' do
+  subject { object.visit_veritas_relation_operation_order(order) }
+
+  let(:relation_name) { 'users'                                          }
+  let(:id)            { Attribute::Integer.new(:id)                      }
+  let(:name)          { Attribute::String.new(:name)                     }
+  let(:age)           { Attribute::Integer.new(:age, :required => false) }
+  let(:header)        { [ id, name, age ]                                }
+  let(:body)          { [ [ 1, 'Dan Kubb', 35 ] ].each                   }
+  let(:base_relation) { BaseRelation.new(relation_name, header, body)    }
+  let(:order)         { operand.order                                    }
+  let(:object)        { described_class.new                              }
+
+  context 'when the operand is a base relation' do
+    let(:operand) { base_relation }
+
+    it_should_behave_like 'a generated SQL SELECT query'
+
+    its(:to_s)        { should eql('SELECT "id", "name", "age" FROM "users" ORDER BY "id", "name", "age"') }
+    its(:to_subquery) { should eql('SELECT * FROM "users" ORDER BY "id", "name", "age"')                   }
+  end
+
+  context 'when the operand is a projection' do
+    context 'when the projection contains the base_relation' do
+      let(:operand) { base_relation.project([ :id, :name ]) }
+
+      it_should_behave_like 'a generated SQL SELECT query'
+
+      its(:to_s)        { should eql('SELECT DISTINCT "id", "name" FROM "users" ORDER BY "id", "name"') }
+      its(:to_subquery) { should eql('SELECT DISTINCT "id", "name" FROM "users" ORDER BY "id", "name"') }
+    end
+
+    context 'when the projection contains an order' do
+      let(:operand) { base_relation.order.project([ :id, :name ]) }
+
+      it_should_behave_like 'a generated SQL SELECT query'
+
+      its(:to_s)        { should eql('SELECT DISTINCT "id", "name" FROM (SELECT * FROM "users" ORDER BY "id", "name", "age") AS "users" ORDER BY "id", "name"') }
+      its(:to_subquery) { should eql('SELECT DISTINCT "id", "name" FROM (SELECT * FROM "users" ORDER BY "id", "name", "age") AS "users" ORDER BY "id", "name"') }
+    end
+  end
+
+  context 'when the operand is a rename' do
+    let(:operand) { base_relation.rename(:id => :user_id) }
+
+    it_should_behave_like 'a generated SQL SELECT query'
+
+    its(:to_s)        { should eql('SELECT "id" AS "user_id", "name", "age" FROM "users" ORDER BY "user_id", "name", "age"') }
+    its(:to_subquery) { should eql('SELECT "id" AS "user_id", "name", "age" FROM "users" ORDER BY "user_id", "name", "age"') }
+  end
+
+  context 'when the operand is a restriction' do
+    let(:operand) { base_relation.restrict { |r| r[:id].eq(1) } }
+
+    it_should_behave_like 'a generated SQL SELECT query'
+
+    its(:to_s)        { should eql('SELECT "id", "name", "age" FROM "users" WHERE "id" = 1 ORDER BY "id", "name", "age"') }
+    its(:to_subquery) { should eql('SELECT * FROM "users" WHERE "id" = 1 ORDER BY "id", "name", "age"')                   }
+  end
+
+  context 'when the operand is ordered' do
+    let(:operand) { base_relation.order }
+
+    it_should_behave_like 'a generated SQL SELECT query'
+
+    its(:to_s)        { should eql('SELECT "id", "name", "age" FROM "users" ORDER BY "id", "name", "age"') }
+    its(:to_subquery) { should eql('SELECT * FROM "users" ORDER BY "id", "name", "age"')                   }
+  end
+
+  context 'when the operand is reversed' do
+    let(:operand) { base_relation.order.reverse }
+
+    it_should_behave_like 'a generated SQL SELECT query'
+
+    its(:to_s)        { should eql('SELECT "id", "name", "age" FROM "users" ORDER BY "id", "name", "age"') }
+    its(:to_subquery) { should eql('SELECT * FROM "users" ORDER BY "id", "name", "age"')                   }
+  end
+
+  context 'when the operand is limited' do
+    let(:operand) { base_relation.order([ id.desc, name.desc, age.desc ]).take(1) }
+
+    it_should_behave_like 'a generated SQL SELECT query'
+
+    its(:to_s)        { should eql('SELECT "id", "name", "age" FROM (SELECT * FROM "users" ORDER BY "id" DESC, "name" DESC, "age" DESC LIMIT 1) AS "users" ORDER BY "id", "name", "age"') }
+    its(:to_subquery) { should eql('SELECT * FROM (SELECT * FROM "users" ORDER BY "id" DESC, "name" DESC, "age" DESC LIMIT 1) AS "users" ORDER BY "id", "name", "age"')                   }
+  end
+
+  context 'when the operand is an offset' do
+    let(:operand) { base_relation.order([ id.desc, name.desc, age.desc ]).drop(1) }
+
+    it_should_behave_like 'a generated SQL SELECT query'
+
+    its(:to_s)        { should eql('SELECT "id", "name", "age" FROM (SELECT * FROM "users" ORDER BY "id" DESC, "name" DESC, "age" DESC OFFSET 1) AS "users" ORDER BY "id", "name", "age"') }
+    its(:to_subquery) { should eql('SELECT * FROM (SELECT * FROM "users" ORDER BY "id" DESC, "name" DESC, "age" DESC OFFSET 1) AS "users" ORDER BY "id", "name", "age"')                   }
+  end
+
+  context 'when the operand is a difference' do
+    let(:operand) { base_relation.difference(base_relation) }
+
+    it_should_behave_like 'a generated SQL SELECT query'
+
+    its(:to_s)        { should eql('SELECT "id", "name", "age" FROM ((SELECT * FROM "users") EXCEPT (SELECT * FROM "users")) AS "users" ORDER BY "id", "name", "age"') }
+    its(:to_subquery) { should eql('SELECT * FROM ((SELECT * FROM "users") EXCEPT (SELECT * FROM "users")) AS "users" ORDER BY "id", "name", "age"')                   }
+  end
+
+  context 'when the operand is an intersection' do
+    let(:operand) { base_relation.intersect(base_relation) }
+
+    it_should_behave_like 'a generated SQL SELECT query'
+
+    its(:to_s)        { should eql('SELECT "id", "name", "age" FROM ((SELECT * FROM "users") INTERSECT (SELECT * FROM "users")) AS "users" ORDER BY "id", "name", "age"') }
+    its(:to_subquery) { should eql('SELECT * FROM ((SELECT * FROM "users") INTERSECT (SELECT * FROM "users")) AS "users" ORDER BY "id", "name", "age"')                   }
+  end
+
+  context 'when the operand is a union' do
+    let(:operand) { base_relation.union(base_relation) }
+
+    it_should_behave_like 'a generated SQL SELECT query'
+
+    its(:to_s)        { should eql('SELECT "id", "name", "age" FROM ((SELECT * FROM "users") UNION (SELECT * FROM "users")) AS "users" ORDER BY "id", "name", "age"') }
+    its(:to_subquery) { should eql('SELECT * FROM ((SELECT * FROM "users") UNION (SELECT * FROM "users")) AS "users" ORDER BY "id", "name", "age"')                   }
+  end
+
+  context 'when the operand is a join' do
+    let(:operand) { base_relation.join(base_relation) }
+
+    it_should_behave_like 'a generated SQL SELECT query'
+
+    its(:to_s)        { should eql('SELECT "id", "name", "age" FROM (SELECT * FROM "users" NATURAL JOIN "users") AS "users" ORDER BY "id", "name", "age"') }
+    its(:to_subquery) { should eql('SELECT * FROM (SELECT * FROM "users" NATURAL JOIN "users") AS "users" ORDER BY "id", "name", "age"')                   }
+  end
+end

data/spec/unit/veritas/sql/generator/relation/unary/visit_veritas_relation_operation_reverse_spec.rb

@@ -0,0 +1,125 @@
+# encoding: utf-8
+
+require 'spec_helper'
+
+describe SQL::Generator::Relation::Unary, '#visit_veritas_relation_operation_reverse' do
+  subject { object.visit_veritas_relation_operation_reverse(order) }
+
+  let(:relation_name) { 'users'                                          }
+  let(:id)            { Attribute::Integer.new(:id)                      }
+  let(:name)          { Attribute::String.new(:name)                     }
+  let(:age)           { Attribute::Integer.new(:age, :required => false) }
+  let(:header)        { [ id, name, age ]                                }
+  let(:body)          { [ [ 1, 'Dan Kubb', 35 ] ].each                   }
+  let(:base_relation) { BaseRelation.new(relation_name, header, body)    }
+  let(:order)         { operand.reverse                                  }
+  let(:object)        { described_class.new                              }
+
+  context 'when the operand is a base relation' do
+    let(:operand) { base_relation.order }
+
+    it_should_behave_like 'a generated SQL SELECT query'
+
+    its(:to_s)        { should eql('SELECT "id", "name", "age" FROM "users" ORDER BY "id" DESC, "name" DESC, "age" DESC') }
+    its(:to_subquery) { should eql('SELECT * FROM "users" ORDER BY "id" DESC, "name" DESC, "age" DESC')                   }
+  end
+
+  context 'when the operand is a projection' do
+    let(:operand) { base_relation.project([ :id, :name ]).order }
+
+    it_should_behave_like 'a generated SQL SELECT query'
+
+    its(:to_s)        { should eql('SELECT DISTINCT "id", "name" FROM "users" ORDER BY "id" DESC, "name" DESC') }
+    its(:to_subquery) { should eql('SELECT DISTINCT "id", "name" FROM "users" ORDER BY "id" DESC, "name" DESC') }
+  end
+
+  context 'when the operand is a rename' do
+    let(:operand) { base_relation.order.rename(:id => :user_id) }
+
+    it_should_behave_like 'a generated SQL SELECT query'
+
+    its(:to_s)        { should eql('SELECT "id" AS "user_id", "name", "age" FROM "users" ORDER BY "user_id" DESC, "name" DESC, "age" DESC') }
+    its(:to_subquery) { should eql('SELECT "id" AS "user_id", "name", "age" FROM "users" ORDER BY "user_id" DESC, "name" DESC, "age" DESC') }
+  end
+
+  context 'when the operand is a restriction' do
+    let(:operand) { base_relation.order.restrict { |r| r[:id].eq(1) } }
+
+    it_should_behave_like 'a generated SQL SELECT query'
+
+    its(:to_s)        { should eql('SELECT "id", "name", "age" FROM "users" WHERE "id" = 1 ORDER BY "id" DESC, "name" DESC, "age" DESC') }
+    its(:to_subquery) { should eql('SELECT * FROM "users" WHERE "id" = 1 ORDER BY "id" DESC, "name" DESC, "age" DESC')                   }
+  end
+
+  context 'when the operand is ordered' do
+    let(:operand) { base_relation.order }
+
+    it_should_behave_like 'a generated SQL SELECT query'
+
+    its(:to_s)        { should eql('SELECT "id", "name", "age" FROM "users" ORDER BY "id" DESC, "name" DESC, "age" DESC') }
+    its(:to_subquery) { should eql('SELECT * FROM "users" ORDER BY "id" DESC, "name" DESC, "age" DESC')                   }
+  end
+
+  context 'when the operand is reversed' do
+    let(:operand) { base_relation.order.reverse }
+
+    it_should_behave_like 'a generated SQL SELECT query'
+
+    its(:to_s)        { should eql('SELECT "id", "name", "age" FROM "users" ORDER BY "id", "name", "age"') }
+    its(:to_subquery) { should eql('SELECT * FROM "users" ORDER BY "id", "name", "age"')                   }
+  end
+
+  context 'when the operand is limited' do
+    let(:operand) { base_relation.order.take(1) }
+
+    it_should_behave_like 'a generated SQL SELECT query'
+
+    its(:to_s)        { should eql('SELECT "id", "name", "age" FROM (SELECT * FROM "users" ORDER BY "id", "name", "age" LIMIT 1) AS "users" ORDER BY "id" DESC, "name" DESC, "age" DESC') }
+    its(:to_subquery) { should eql('SELECT * FROM (SELECT * FROM "users" ORDER BY "id", "name", "age" LIMIT 1) AS "users" ORDER BY "id" DESC, "name" DESC, "age" DESC')                   }
+  end
+
+  context 'when the operand is an offset' do
+    let(:operand) { base_relation.order.drop(1) }
+
+    it_should_behave_like 'a generated SQL SELECT query'
+
+    its(:to_s)        { should eql('SELECT "id", "name", "age" FROM (SELECT * FROM "users" ORDER BY "id", "name", "age" OFFSET 1) AS "users" ORDER BY "id" DESC, "name" DESC, "age" DESC') }
+    its(:to_subquery) { should eql('SELECT * FROM (SELECT * FROM "users" ORDER BY "id", "name", "age" OFFSET 1) AS "users" ORDER BY "id" DESC, "name" DESC, "age" DESC')                   }
+  end
+
+  context 'when the operand is a difference' do
+    let(:operand) { base_relation.difference(base_relation).order }
+
+    it_should_behave_like 'a generated SQL SELECT query'
+
+    its(:to_s)        { should eql('SELECT "id", "name", "age" FROM ((SELECT * FROM "users") EXCEPT (SELECT * FROM "users")) AS "users" ORDER BY "id" DESC, "name" DESC, "age" DESC') }
+    its(:to_subquery) { should eql('SELECT * FROM ((SELECT * FROM "users") EXCEPT (SELECT * FROM "users")) AS "users" ORDER BY "id" DESC, "name" DESC, "age" DESC')                   }
+  end
+
+  context 'when the operand is an intersection' do
+    let(:operand) { base_relation.intersect(base_relation).order }
+
+    it_should_behave_like 'a generated SQL SELECT query'
+
+    its(:to_s)        { should eql('SELECT "id", "name", "age" FROM ((SELECT * FROM "users") INTERSECT (SELECT * FROM "users")) AS "users" ORDER BY "id" DESC, "name" DESC, "age" DESC') }
+    its(:to_subquery) { should eql('SELECT * FROM ((SELECT * FROM "users") INTERSECT (SELECT * FROM "users")) AS "users" ORDER BY "id" DESC, "name" DESC, "age" DESC')                   }
+  end
+
+  context 'when the operand is a union' do
+    let(:operand) { base_relation.union(base_relation).order }
+
+    it_should_behave_like 'a generated SQL SELECT query'
+
+    its(:to_s)        { should eql('SELECT "id", "name", "age" FROM ((SELECT * FROM "users") UNION (SELECT * FROM "users")) AS "users" ORDER BY "id" DESC, "name" DESC, "age" DESC') }
+    its(:to_subquery) { should eql('SELECT * FROM ((SELECT * FROM "users") UNION (SELECT * FROM "users")) AS "users" ORDER BY "id" DESC, "name" DESC, "age" DESC')                   }
+  end
+
+  context 'when the operand is a join' do
+    let(:operand) { base_relation.join(base_relation).order }
+
+    it_should_behave_like 'a generated SQL SELECT query'
+
+    its(:to_s)        { should eql('SELECT "id", "name", "age" FROM (SELECT * FROM "users" NATURAL JOIN "users") AS "users" ORDER BY "id" DESC, "name" DESC, "age" DESC') }
+    its(:to_subquery) { should eql('SELECT * FROM (SELECT * FROM "users" NATURAL JOIN "users") AS "users" ORDER BY "id" DESC, "name" DESC, "age" DESC')                   }
+  end
+end

data/spec/unit/veritas/sql/generator/relation/visit_spec.rb

@@ -0,0 +1,54 @@
+# encoding: utf-8
+
+require 'spec_helper'
+
+describe SQL::Generator::Relation, '#visit' do
+  subject { object.visit(visitable) }
+
+  let(:described_class) { Class.new(SQL::Generator::Relation) }
+  let(:object)          { described_class.new                 }
+
+  context 'with a handled object' do
+    let(:visitable) { mock('Visitable') }
+
+    before do
+      described_class.class_eval do
+        def visit_spec_mocks_mock(mock)
+          mock
+        end
+      end
+    end
+
+    it_should_behave_like 'a command method'
+
+    specify { expect { subject }.to change(object, :frozen?).from(false).to(true) }
+  end
+
+  context 'with a handled object more than once' do
+    let(:visitable) { mock('Visitable') }
+
+    before do
+      described_class.class_eval do
+        def visit_spec_mocks_mock(mock)
+          mock
+        end
+      end
+    end
+
+    before do
+      object.visit(visitable)
+    end
+
+    if RUBY_VERSION >= '1.9'
+      specify { expect { subject }.to raise_error(RuntimeError) }
+    else
+      specify { expect { subject }.to raise_error(TypeError) }
+    end
+  end
+
+  context 'with an unhandled object' do
+    let(:visitable) { mock('Not Handled') }
+
+    specify { expect { subject }.to raise_error(SQL::Generator::Visitor::UnknownObject, "No handler for #{visitable.class} in #{object.class}") }
+  end
+end

data/spec/unit/veritas/sql/generator/relation/visited_spec.rb

@@ -0,0 +1,35 @@
+# encoding: utf-8
+
+require 'spec_helper'
+
+describe SQL::Generator::Relation, '#visited?' do
+  subject { object.visited? }
+
+  let(:id)            { Attribute::Integer.new(:id)                      }
+  let(:name)          { Attribute::String.new(:name)                     }
+  let(:age)           { Attribute::Integer.new(:age, :required => false) }
+  let(:header)        { [ id, name, age ]                                }
+  let(:body)          { [ [ 1, 'Dan Kubb', 35 ] ].each                   }
+  let(:base_relation) { BaseRelation.new('users', header, body)          }
+  let(:object)        { described_class.new                              }
+
+  context 'when name is nil' do
+    it_should_behave_like 'an idempotent method'
+
+    it { should be(false) }
+  end
+
+  context 'when name is set' do
+    let(:name) { 'test' }
+
+    before do
+      # subclasses set @name, but nothing in this class
+      # does does so simulate it being set
+      object.instance_variable_set(:@name, name)
+    end
+
+    it_should_behave_like 'an idempotent method'
+
+    it { should be(true) }
+  end
+end

data/spec/unit/veritas/sql/generator/visitor/class_methods/handler_for_spec.rb

@@ -0,0 +1,71 @@
+# encoding: utf-8
+
+require 'spec_helper'
+
+describe SQL::Generator::Visitor, '.handler_for' do
+  subject { object.handler_for(visitable_class) }
+
+  let(:object) { Class.new(SQL::Generator::Visitor) }
+
+  before :all do
+    module ::MySpec
+      class Visitable; end
+    end
+  end
+
+  after :all do
+    MySpec.class_eval { remove_const(:Visitable) }
+    Object.class_eval { remove_const(:MySpec)    }
+  end
+
+  context 'with an object handled by a public method' do
+    let(:visitable_class) { MySpec::Visitable }
+
+    before do
+      object.class_eval do
+        remove_instance_variable(:@handlers) if instance_variable_defined?(:@handlers)
+        define_method(:visit_my_spec_visitable) {}
+      end
+    end
+
+    after do
+      object.class_eval do
+        remove_instance_variable(:@handlers)
+        remove_method(:visit_my_spec_visitable)
+      end
+    end
+
+    it_should_behave_like 'an idempotent method'
+
+    it { should == :visit_my_spec_visitable }
+  end
+
+  context 'with an object handled by a private method' do
+    let(:visitable_class) { MySpec::Visitable }
+
+    before do
+      object.class_eval do
+        remove_instance_variable(:@handlers) if instance_variable_defined?(:@handlers)
+        define_method(:visit_my_spec_visitable) {}
+        private :visit_my_spec_visitable
+      end
+    end
+
+    after do
+      object.class_eval do
+        remove_instance_variable(:@handlers)
+        remove_method(:visit_my_spec_visitable)
+      end
+    end
+
+    it_should_behave_like 'an idempotent method'
+
+    it { should == :visit_my_spec_visitable }
+  end
+
+  context 'with an unhandled object' do
+    let(:visitable_class) { Class.new }
+
+    specify { expect { subject }.to raise_error(object::UnknownObject, "No handler for #{visitable_class} in #{object}") }
+  end
+end

data/spec/unit/veritas/sql/generator/visitor/visit_spec.rb

@@ -0,0 +1,12 @@
+# encoding: utf-8
+
+require 'spec_helper'
+
+describe SQL::Generator::Visitor, '#visit' do
+  subject { object.visit(visitable) }
+
+  let(:visitable) { mock('handled object') }
+  let(:object)    { described_class.new    }
+
+  specify { expect { subject }.to raise_error(NotImplementedError, "#{described_class}#visit must be implemented") }
+end

data/spec/unit/veritas/sql/generator/visitor/visited_spec.rb

@@ -0,0 +1,11 @@
+# encoding: utf-8
+
+require 'spec_helper'
+
+describe SQL::Generator::Visitor, '#visited?' do
+  subject { object.visited? }
+
+  let(:object) { described_class.new }
+
+  specify { expect { subject }.to raise_error(NotImplementedError, "#{described_class}#visited? must be implemented") }
+end