tern 0.6.0

data/spec/projects/irreversible_alterations/definitions/sequence.yml

@@ -0,0 +1,18 @@
+# Put the relative path to your definition files in the sequence they should run.
+#
+# Most definitions should go in the default list. These will be dropped and
+# recreated every migration.
+#
+# Definitions that should not automatically be dropped and created can be put in
+# different lists. This is useful for definitions that make take prohibitively
+# to drop and create every migration such as check constraints.
+#
+# Run alternative sequences by specifying sequences in order to migrate command.
+# Example: rake migrate sequences=expensive,default
+#
+# default:
+#   - ultimate_answer.sql
+# expensive:
+#   - super_slow_check_constraint.sql
+
+default: []

data/spec/projects/irreversible_alterations/definitions/ultimate_answer.sql.example

@@ -0,0 +1,7 @@
+CREATE FUNCTION ultimate_answer() RETURNS integer AS $$
+  SELECT 42;
+$$ LANGUAGE SQL;
+
+---- CREATE above / DROP below ----
+
+DROP FUNCTION ultimate_answer();

data/spec/projects/missing_alteration/alterations/001_create_people.sql

@@ -0,0 +1,8 @@
+CREATE TABLE people(
+  id serial PRIMARY KEY,
+  name varchar NOT NULL
+);
+
+---- CREATE above / DROP below ----
+
+DROP TABLE people;

data/spec/projects/missing_alteration/alterations/003_create_plants.sql

@@ -0,0 +1,8 @@
+CREATE TABLE plants(
+  id serial PRIMARY KEY,
+  name varchar NOT NULL
+);
+
+---- CREATE above / DROP below ----
+
+DROP TABLE plants;

data/spec/projects/missing_alteration/config.yml

@@ -0,0 +1,15 @@
+alterations:
+  table: tern_alterations
+  column: version
+definitions:
+  table: tern_definitions
+environments:
+  development:
+    adapter: postgres
+    database: tern_test_development
+  test:
+    adapter: postgres
+    database: tern_test_test
+  production:
+    adapter: postgres
+    database: tern_test_production

data/spec/projects/missing_alteration/definitions/sequence.yml

@@ -0,0 +1,18 @@
+# Put the relative path to your definition files in the sequence they should run.
+#
+# Most definitions should go in the default list. These will be dropped and
+# recreated every migration.
+#
+# Definitions that should not automatically be dropped and created can be put in
+# different lists. This is useful for definitions that make take prohibitively
+# to drop and create every migration such as check constraints.
+#
+# Run alternative sequences by specifying sequences in order to migrate command.
+# Example: rake migrate sequences=expensive,default
+#
+# default:
+#   - ultimate_answer.sql
+# expensive:
+#   - super_slow_check_constraint.sql
+
+default: []

data/spec/projects/missing_alteration/definitions/ultimate_answer.sql.example

@@ -0,0 +1,7 @@
+CREATE FUNCTION ultimate_answer() RETURNS integer AS $$
+  SELECT 42;
+$$ LANGUAGE SQL;
+
+---- CREATE above / DROP below ----
+
+DROP FUNCTION ultimate_answer();

data/spec/projects/multiple_sequences/alterations/001_create_people.sql.example

@@ -0,0 +1,16 @@
+Sequel.migration do
+  up do
+    run <<-END_SQL
+      CREATE TABLE people(
+        id serial PRIMARY KEY,
+        name varchar NOT NULL
+      );
+    END_SQL
+  end
+
+  down do
+    run <<-END_SQL
+      DROP TABLE people;
+    END_SQL
+  end
+end

data/spec/projects/multiple_sequences/config.yml

@@ -0,0 +1,15 @@
+alterations:
+  table: tern_alterations
+  column: version
+definitions:
+  table: tern_definitions
+environments:
+  development:
+    adapter: postgres
+    database: tern_test_development
+  test:
+    adapter: postgres
+    database: tern_test_test
+  production:
+    adapter: postgres
+    database: tern_test_production

data/spec/projects/multiple_sequences/definitions/create_view_a.sql

@@ -0,0 +1,5 @@
+CREATE VIEW  a AS SELECT 42;
+
+---- CREATE above / DROP below ----
+
+DROP VIEW a;

data/spec/projects/multiple_sequences/definitions/create_view_b.sql

@@ -0,0 +1,5 @@
+CREATE VIEW  b AS SELECT * FROM a;
+
+---- CREATE above / DROP below ----
+
+DROP VIEW b;

data/spec/projects/multiple_sequences/definitions/sequence.yml

@@ -0,0 +1,21 @@
+# Put the relative path to your definition files in the sequence they should run.
+#
+# Most definitions should go in the default list. These will be dropped and
+# recreated every migration.
+#
+# Definitions that should not automatically be dropped and created can be put in
+# different lists. This is useful for definitions that make take prohibitively
+# to drop and create every migration such as check constraints.
+#
+# Run alternative sequences by specifying sequences in order to migrate command.
+# Example: rake migrate sequences=expensive,default
+#
+# default:
+#   - ultimate_answer.sql
+# expensive:
+#   - super_slow_check_constraint.sql
+
+default:
+  - create_view_b.sql
+expensive:
+  - create_view_a.sql

data/spec/projects/multiple_sequences/definitions/ultimate_answer.sql.example

@@ -0,0 +1,7 @@
+CREATE FUNCTION ultimate_answer() RETURNS integer AS $$
+  SELECT 42;
+$$ LANGUAGE SQL;
+
+---- CREATE above / DROP below ----
+
+DROP FUNCTION ultimate_answer();

data/spec/projects/new/alterations/001_create_people.sql.example

@@ -0,0 +1,16 @@
+Sequel.migration do
+  up do
+    run <<-END_SQL
+      CREATE TABLE people(
+        id serial PRIMARY KEY,
+        name varchar NOT NULL
+      );
+    END_SQL
+  end
+
+  down do
+    run <<-END_SQL
+      DROP TABLE people;
+    END_SQL
+  end
+end

data/spec/projects/new/config.yml

@@ -0,0 +1,15 @@
+alterations:
+  table: tern_alterations
+  column: version
+definitions:
+  table: tern_definitions
+environments:
+  development:
+    adapter: postgres
+    database: tern_test_development
+  test:
+    adapter: postgres
+    database: tern_test_test
+  production:
+    adapter: postgres
+    database: tern_test_production

data/spec/projects/new/definitions/sequence.yml

@@ -0,0 +1,18 @@
+# Put the relative path to your definition files in the sequence they should run.
+#
+# Most definitions should go in the default list. These will be dropped and
+# recreated every migration.
+#
+# Definitions that should not automatically be dropped and created can be put in
+# different lists. This is useful for definitions that make take prohibitively
+# to drop and create every migration such as check constraints.
+#
+# Run alternative sequences by specifying sequences in order to migrate command.
+# Example: rake migrate sequences=expensive,default
+#
+# default:
+#   - ultimate_answer.sql
+# expensive:
+#   - super_slow_check_constraint.sql
+
+default: []

data/spec/projects/new/definitions/ultimate_answer.sql.example

@@ -0,0 +1,7 @@
+CREATE FUNCTION ultimate_answer() RETURNS integer AS $$
+  SELECT 42;
+$$ LANGUAGE SQL;
+
+---- CREATE above / DROP below ----
+
+DROP FUNCTION ultimate_answer();

data/spec/projects/no_alterations/alterations/001_create_people.sql.example

@@ -0,0 +1,16 @@
+Sequel.migration do
+  up do
+    run <<-END_SQL
+      CREATE TABLE people(
+        id serial PRIMARY KEY,
+        name varchar NOT NULL
+      );
+    END_SQL
+  end
+
+  down do
+    run <<-END_SQL
+      DROP TABLE people;
+    END_SQL
+  end
+end

data/spec/projects/no_alterations/config.yml

@@ -0,0 +1,15 @@
+alterations:
+  table: tern_alterations
+  column: version
+definitions:
+  table: tern_definitions
+environments:
+  development:
+    adapter: postgres
+    database: tern_test_development
+  test:
+    adapter: postgres
+    database: tern_test_test
+  production:
+    adapter: postgres
+    database: tern_test_production

data/spec/projects/no_alterations/definitions/sequence.yml

@@ -0,0 +1,18 @@
+# Put the relative path to your definition files in the sequence they should run.
+#
+# Most definitions should go in the default list. These will be dropped and
+# recreated every migration.
+#
+# Definitions that should not automatically be dropped and created can be put in
+# different lists. This is useful for definitions that make take prohibitively
+# to drop and create every migration such as check constraints.
+#
+# Run alternative sequences by specifying sequences in order to migrate command.
+# Example: rake migrate sequences=expensive,default
+#
+# default:
+#   - ultimate_answer.sql
+# expensive:
+#   - super_slow_check_constraint.sql
+
+default: []

data/spec/projects/no_alterations/definitions/ultimate_answer.sql.example

@@ -0,0 +1,7 @@
+CREATE FUNCTION ultimate_answer() RETURNS integer AS $$
+  SELECT 42;
+$$ LANGUAGE SQL;
+
+---- CREATE above / DROP below ----
+
+DROP FUNCTION ultimate_answer();

data/spec/tern_spec.rb

@@ -0,0 +1,215 @@
+require 'rspec'
+require 'fileutils'
+require 'sequel'
+require 'tern'
+
+$tmpdir = 'spec/tmp/' + Time.now.strftime("%Y-%m-%d-%H-%M-%S")
+FileUtils.mkdir_p $tmpdir
+
+RSpec.configure do |config|
+  def tern(args="")
+    lib = File.expand_path(File.join(File.dirname(__FILE__), '..', 'lib'))
+    bin = File.expand_path(File.join(File.dirname(__FILE__), '..', 'bin', 'tern'))
+    `ruby -I #{lib} #{bin} #{args}`
+  end
+
+  def tern_migrate(path, args="")
+    Dir.chdir(path) do
+      tern "migrate #{args}"
+    end
+  end
+
+  def tern_generate(path, args="")
+    Dir.chdir(path) do
+      tern "generate #{args}"
+    end
+  end
+
+  def tmpdir
+    $tmpdir
+  end
+end
+
+describe "Change" do
+  describe "parse" do
+    it "splits on SPLIT_MARKER" do
+      ::Change.parse("create #{::Change::SPLIT_MARKER} drop").should == ["create ", " drop"]
+    end
+
+    it "returns entire string as create if no SPLIT_MARKER not found" do
+      ::Change.parse("create").should == ["create", nil]
+    end
+  end
+end
+
+describe "tern" do
+  it "displays task list when called without arguments" do
+    tern.should match(/Tasks/)
+  end
+
+  describe "new" do
+    it "creates a new project at path" do
+      Dir.chdir(tmpdir) do
+        tern "new tern_spec"
+        File.exist?("tern_spec").should be_true
+        File.exist?("tern_spec/alterations").should be_true
+        File.exist?("tern_spec/definitions").should be_true
+        File.exist?("tern_spec/config.yml").should be_true
+      end
+    end
+  end
+
+  describe "generate" do
+    before(:each) do |example|
+      @project_path = File.expand_path(File.join(tmpdir, example.object_id.to_s))
+      tern "new #{@project_path}"
+    end
+
+    it "prints an error message if config.yml is not found" do
+      tern_generate("spec/tmp", "alteration create_people").should match(/This directory does not appear to be a Tern project. config.yml not found./)
+    end
+
+    describe "alteration" do
+      it "creates alteration file with next available number prefixing name" do
+        tern_generate(@project_path, "alteration create_widgets")
+        File.exist?(File.join(@project_path, "alterations", "001_create_widgets.sql")).should be_true
+        tern_generate(@project_path, "alteration create_sprockets")
+        File.exist?(File.join(@project_path, "alterations", "002_create_sprockets.sql")).should be_true
+      end
+    end
+    
+    describe "definition" do
+      it "creates definition file" do
+        tern_generate(@project_path, "definition create_a_view")
+        File.exist?(File.join(@project_path, "definitions", "create_a_view.sql")).should be_true
+      end
+    end
+  end
+
+  describe "migrate" do
+    before(:each) do
+      `createdb tern_test_development`
+      @dev_db = Sequel.connect :adapter => :postgres, :database => 'tern_test_development'
+    end
+
+    after(:each) do
+      @dev_db.disconnect
+      `dropdb tern_test_development`
+    end
+
+    it "prints an error message if config.yml is not found" do
+      tern_migrate("spec/tmp").should match(/This directory does not appear to be a Tern project. config.yml not found./)
+    end
+
+    it "works without any alterations" do
+      tern_migrate("spec/projects/no_alterations").should be_empty
+    end
+
+    it "creates definitions table on first run" do
+      tern_migrate "spec/projects/new"
+      @dev_db.tables.should include(:tern_definitions)
+    end
+
+    it "creates alterations table on first run" do
+      tern_migrate "spec/projects/new"
+      @dev_db.tables.should include(:tern_alterations)
+    end
+
+    it "applies alterations" do
+      tern_migrate "spec/projects/alterations"
+      @dev_db.tables.should include(:people, :animals, :plants)
+    end
+
+    it "applies alterations to version n" do
+      tern_migrate "spec/projects/alterations", "-a 1"
+      @dev_db.tables.should include(:people)
+      tern_migrate "spec/projects/alterations", "-a 3"
+      @dev_db.tables.should include(:people, :animals, :plants)
+    end
+
+    it "reverts all alterations" do
+      tern_migrate "spec/projects/alterations"
+      tern_migrate "spec/projects/alterations", "-a 0"
+      @dev_db.tables.should_not include(:people, :animals, :plants)
+    end
+
+    it "reverts alterations to version n" do
+      tern_migrate "spec/projects/alterations"
+      tern_migrate "spec/projects/alterations", "-a 1"
+      @dev_db.tables.should include(:people)
+      @dev_db.tables.should_not include(:animals, :plants)
+    end
+
+    it "prints an error message when attempting to revert an irreversible alteration" do
+      tern_migrate "spec/projects/irreversible_alterations"
+      tern_migrate("spec/projects/irreversible_alterations", "-a 0").should match /Alteration 002 is irreversible/
+    end
+
+    it "prints an error message when missing alteration" do
+      tern_migrate("spec/projects/missing_alteration").should match /Alteration 002 is missing/
+    end
+
+    it "prints an error message when alteration version is duplicated" do
+      tern_migrate("spec/projects/duplicated_alteration").should match /Alteration 002 is duplicated/
+    end
+
+    it "uses environment parameter" do
+      `createdb tern_test_test`
+      test_db = Sequel.connect :adapter => :postgres, :database => 'tern_test_test'
+
+      tern_migrate "spec/projects/new", "-e test"
+      test_db.tables.should include(:tern_definitions)
+      @dev_db.tables.should_not include(:tern_definitions)
+      
+      test_db.disconnect
+      `dropdb tern_test_test`
+    end
+
+    it "creates definitions" do
+      tern_migrate "spec/projects/definitions"
+      @dev_db.get{ultimate_answer{}}.should == 42
+    end
+
+    it "drops definitions" do
+      tern_migrate "spec/projects/definitions"
+      tern_migrate "spec/projects/new"
+      expect { @dev_db.get{ultimate_answer{}} }.to raise_error(Sequel::DatabaseError)
+    end
+
+    it "creates definitions after alterations" do
+      tern_migrate "spec/projects/dependencies_1"
+      @dev_db.tables.should include(:widgets)
+      expect { @dev_db[:widgets_view].all }.to_not raise_error(Sequel::DatabaseError)
+    end
+
+    it "drops existing definitions" do
+      tern_migrate "spec/projects/dependencies_1"
+      tern_migrate "spec/projects/dependencies_2"
+      expect { @dev_db[:widgets_view].all }.to raise_error(Sequel::DatabaseError)
+    end
+
+    context "multiple definition sequences" do
+      it "creates specified definition sequences in order" do
+        tern_migrate "spec/projects/multiple_sequences", "-d expensive default"
+        expect { @dev_db[:a].all }.to_not raise_error(Sequel::DatabaseError)
+        expect { @dev_db[:b].all }.to_not raise_error(Sequel::DatabaseError)
+      end
+
+      it "creates specified definition sequence" do
+        tern_migrate "spec/projects/multiple_sequences", "-d expensive"
+        expect { @dev_db[:a].all }.to_not raise_error(Sequel::DatabaseError)
+      end
+
+      it "ignores unspecified definition sequences" do
+        tern_migrate "spec/projects/multiple_sequences", "-d expensive"
+        expect { @dev_db[:b].all }.to raise_error(Sequel::DatabaseError)
+      end
+
+      it "removes specified definition sequence from database that does not exist in definitions" do
+        tern_migrate "spec/projects/multiple_sequences", "-d expensive"
+        tern_migrate "spec/projects/new", "-d expensive"
+        expect { @dev_db[:a].all }.to raise_error(Sequel::DatabaseError)
+      end
+    end
+  end
+end