bitfluent-vestal_versions 1.1.0

data/test/conditions_test.rb

@@ -0,0 +1,137 @@
+require File.expand_path(File.join(File.dirname(__FILE__), 'test_helper'))
+
+class ConditionsTest < Test::Unit::TestCase
+  context 'Converted :if conditions' do
+    setup do
+      User.class_eval do
+        def true; true; end
+      end
+    end
+
+    should 'be an array' do
+      assert_kind_of Array, User.vestal_versions_options[:if]
+      User.prepare_versioned_options(:if => :true)
+      assert_kind_of Array, User.vestal_versions_options[:if]
+    end
+
+    should 'have proc values' do
+      User.prepare_versioned_options(:if => :true)
+      assert User.vestal_versions_options[:if].all?{|i| i.is_a?(Proc) }
+    end
+
+    teardown do
+      User.prepare_versioned_options(:if => [])
+    end
+  end
+
+  context 'Converted :unless conditions' do
+    setup do
+      User.class_eval do
+        def true; true; end
+      end
+    end
+
+    should 'be an array' do
+      assert_kind_of Array, User.vestal_versions_options[:unless]
+      User.prepare_versioned_options(:unless => :true)
+      assert_kind_of Array, User.vestal_versions_options[:unless]
+    end
+
+    should 'have proc values' do
+      User.prepare_versioned_options(:unless => :true)
+      assert User.vestal_versions_options[:unless].all?{|i| i.is_a?(Proc) }
+    end
+
+    teardown do
+      User.prepare_versioned_options(:unless => [])
+    end
+  end
+
+  context 'A new version' do
+    setup do
+      User.class_eval do
+        def true; true; end
+        def false; false; end
+      end
+
+      @user = User.create(:name => 'Steve Richert')
+      @count = @user.versions.count
+    end
+
+    context 'with :if conditions' do
+      context 'that pass' do
+        setup do
+          User.prepare_versioned_options(:if => [:true])
+          @user.update_attribute(:last_name, 'Jobs')
+        end
+
+        should 'be created' do
+          assert_equal @count + 1, @user.versions.count
+        end
+      end
+
+      context 'that fail' do
+        setup do
+          User.prepare_versioned_options(:if => [:false])
+          @user.update_attribute(:last_name, 'Jobs')
+        end
+
+        should 'not be created' do
+          assert_equal @count, @user.versions.count
+        end
+      end
+    end
+
+    context 'with :unless conditions' do
+      context 'that pass' do
+        setup do
+          User.prepare_versioned_options(:unless => [:true])
+          @user.update_attribute(:last_name, 'Jobs')
+        end
+
+        should 'not be created' do
+          assert_equal @count, @user.versions.count
+        end
+      end
+
+      context 'that fail' do
+        setup do
+          User.prepare_versioned_options(:unless => [:false])
+          @user.update_attribute(:last_name, 'Jobs')
+        end
+
+        should 'not be created' do
+          assert_equal @count + 1, @user.versions.count
+        end
+      end
+    end
+
+    context 'with :if and :unless conditions' do
+      context 'that pass' do
+        setup do
+          User.prepare_versioned_options(:if => [:true], :unless => [:true])
+          @user.update_attribute(:last_name, 'Jobs')
+        end
+
+        should 'not be created' do
+          assert_equal @count, @user.versions.count
+        end
+      end
+
+      context 'that fail' do
+        setup do
+          User.prepare_versioned_options(:if => [:false], :unless => [:false])
+          @user.update_attribute(:last_name, 'Jobs')
+        end
+
+        should 'not be created' do
+          assert_equal @count, @user.versions.count
+        end
+      end
+    end
+
+    teardown do
+      User.prepare_versioned_options(:if => [], :unless => [])
+    end
+  end
+end

data/test/configuration_test.rb

@@ -0,0 +1,39 @@
+require File.expand_path(File.join(File.dirname(__FILE__), 'test_helper'))
+
+class ConfigurationTest < Test::Unit::TestCase
+  context 'Global configuration options' do
+    setup do
+      module Extension; end
+      
+      @options = {
+        'class_name' => 'CustomVersion',
+        :extend => Extension,
+        :as => :parent
+      }
+      
+      VestalVersions.configure do |config|
+        @options.each do |key, value|
+          config.send("#{key}=", value)
+        end
+      end
+
+      @configuration = VestalVersions::Configuration.options
+    end
+
+    should 'should be a hash' do
+      assert_kind_of Hash, @configuration
+    end
+
+    should 'have symbol keys' do
+      assert @configuration.keys.all?{|k| k.is_a?(Symbol) }
+    end
+
+    should 'store values identical to those given' do
+      assert_equal @options.symbolize_keys, @configuration
+    end
+
+    teardown do
+      VestalVersions::Configuration.options.clear
+    end
+  end
+end

data/test/control_test.rb

@@ -0,0 +1,152 @@
+require File.expand_path(File.join(File.dirname(__FILE__), 'test_helper'))
+
+class ControlTest < Test::Unit::TestCase
+  context 'Within a skip_version block,' do
+    setup do
+      @user = User.create(:name => 'Steve Richert')
+      @count = @user.versions.count
+    end
+
+    context 'a model update' do
+      setup do
+        @user.skip_version do
+          @user.update_attribute(:last_name, 'Jobs')
+        end
+      end
+
+      should 'not create a version' do
+        assert_equal @count, @user.versions.count
+      end
+    end
+
+    context 'multiple model updates' do
+      setup do
+        @user.skip_version do
+          @user.update_attribute(:first_name, 'Stephen')
+          @user.update_attribute(:last_name, 'Jobs')
+          @user.update_attribute(:first_name, 'Steve')
+        end
+      end
+
+      should 'not create a version' do
+        assert_equal @count, @user.versions.count
+      end
+    end
+  end
+
+  context 'Within a merge_version block,' do
+    setup do
+      @user = User.create(:name => 'Steve Richert')
+      @count = @user.versions.count
+    end
+
+    context 'a model update' do
+      setup do
+        @user.merge_version do
+          @user.update_attribute(:last_name, 'Jobs')
+        end
+      end
+
+      should 'create a version' do
+        assert_equal @count + 1, @user.versions.count
+      end
+    end
+
+    context 'multiple model updates' do
+      setup do
+        @user.merge_version do
+          @user.update_attribute(:first_name, 'Stephen')
+          @user.update_attribute(:last_name, 'Jobs')
+          @user.update_attribute(:first_name, 'Steve')
+        end
+      end
+
+      should 'create a version' do
+        assert_equal @count + 1, @user.versions.count
+      end
+    end
+  end
+
+  context 'Within a append_version block' do
+    context '(when no versions exist),' do
+      setup do
+        @user = User.create(:name => 'Steve Richert')
+        @count = @user.versions.count
+      end
+
+      context 'a model update' do
+        setup do
+          @user.append_version do
+            @user.update_attribute(:last_name, 'Jobs')
+          end
+        end
+
+        should 'create a version' do
+          assert_equal @count + 1, @user.versions.count
+        end
+      end
+
+      context 'multiple model updates' do
+        setup do
+          @user.append_version do
+            @user.update_attribute(:first_name, 'Stephen')
+            @user.update_attribute(:last_name, 'Jobs')
+            @user.update_attribute(:first_name, 'Steve')
+          end
+        end
+
+        should 'create a version' do
+          assert_equal @count + 1, @user.versions.count
+        end
+      end
+    end
+
+    context '(when versions exist),' do
+      setup do
+        @user = User.create(:name => 'Steve Richert')
+        @user.update_attribute(:last_name, 'Jobs')
+        @user.update_attribute(:last_name, 'Richert')
+        @last_version = @user.versions.last
+        @count = @user.versions.count
+      end
+
+      context 'a model update' do
+        setup do
+          @user.append_version do
+            @user.update_attribute(:last_name, 'Jobs')
+          end
+        end
+
+        should 'not create a version' do
+          assert_equal @count, @user.versions.count
+        end
+
+        should 'update the last version' do
+          last_version = @user.versions(true).last
+          assert_equal @last_version.id, last_version.id
+          assert_not_equal @last_version.attributes, last_version.attributes
+        end
+      end
+
+      context 'multiple model updates' do
+        setup do
+          @user.append_version do
+            @user.update_attribute(:first_name, 'Stephen')
+            @user.update_attribute(:last_name, 'Jobs')
+            @user.update_attribute(:first_name, 'Steve')
+          end
+        end
+
+        should 'not create a version' do
+          assert_equal @count, @user.versions.count
+        end
+
+        should 'update the last version' do
+          last_version = @user.versions(true).last
+          assert_equal @last_version.id, last_version.id
+          assert_not_equal @last_version.attributes, last_version.attributes
+        end
+      end
+    end
+  end
+end

data/test/creation_test.rb

@@ -0,0 +1,148 @@
+require File.expand_path(File.join(File.dirname(__FILE__), 'test_helper'))
+
+class CreationTest < Test::Unit::TestCase
+  context 'The number of versions' do
+    setup do
+      @name = 'Steve Richert'
+      @user = User.create(:name => @name)
+      @count = @user.versions.count
+    end
+
+    should 'initially equal zero' do
+      assert_equal 0, @count
+    end
+    
+    context '(with :initial_version option)' do
+      setup do
+        User.prepare_versioned_options(:initial_version => true)
+        @user = User.create(:name => @name)
+        @count = @user.versions.count
+      end
+      should 'initially equal one' do
+        assert_equal 1, @count
+      end
+      teardown do
+        User.prepare_versioned_options(:initial_version => nil)
+      end
+    end
+
+    should 'not increase when no changes are made in an update' do
+      @user.update_attribute(:name, @name)
+      assert_equal @count, @user.versions.count
+    end
+
+    should 'not increase when no changes are made before a save' do
+      @user.save
+      assert_equal @count, @user.versions.count
+    end
+
+    context 'after an update' do
+      setup do
+        @user.update_attribute(:last_name, 'Jobs')
+      end
+
+      should 'increase by one' do
+        assert_equal @count + 1, @user.versions.count
+      end
+    end
+
+    context 'after multiple updates' do
+      setup do
+        @user.update_attribute(:last_name, 'Jobs')
+        @user.update_attribute(:last_name, 'Richert')
+      end
+
+      should 'increase multiple times' do
+        assert_operator @count + 1, :<, @user.versions.count
+      end
+    end
+  end
+
+  context "A created version's changes" do
+    setup do
+      @user = User.create(:name => 'Steve Richert')
+      @user.update_attribute(:last_name, 'Jobs')
+    end
+
+    should 'not contain Rails timestamps' do
+      %w(created_at created_on updated_at updated_on).each do |timestamp|
+        assert_does_not_contain @user.versions.last.changes.keys, timestamp
+      end
+    end
+
+    context '(with :only options)' do
+      setup do
+        @only = %w(first_name)
+        User.prepare_versioned_options(:only => @only)
+        @user.update_attribute(:name, 'Steven Tyler')
+      end
+
+      should 'only contain the specified columns' do
+        assert_equal @only, @user.versions.last.changes.keys
+      end
+
+      teardown do
+        User.prepare_versioned_options(:only => nil)
+      end
+    end
+
+    context '(with :except options)' do
+      setup do
+        @except = %w(first_name)
+        User.prepare_versioned_options(:except => @except)
+        @user.update_attribute(:name, 'Steven Tyler')
+      end
+
+      should 'not contain the specified columns' do
+        @except.each do |column|
+          assert_does_not_contain @user.versions.last.changes.keys, column
+        end
+      end
+
+      teardown do
+        User.prepare_versioned_options(:except => nil)
+      end
+    end
+
+    context '(with both :only and :except options)' do
+      setup do
+        @only = %w(first_name)
+        @except = @only
+        User.prepare_versioned_options(:only => @only, :except => @except)
+        @user.update_attribute(:name, 'Steven Tyler')
+      end
+
+      should 'respect only the :only options' do
+        assert_equal @only, @user.versions.last.changes.keys
+      end
+
+      teardown do
+        User.prepare_versioned_options(:only => nil, :except => nil)
+      end
+    end
+  end
+
+  context 'First version' do
+    setup do
+      @name = 'Steve Richert'
+      @user = User.create(:name => @name)
+    end
+    should 'should be number 2 (after an update)' do
+      @user.update_attribute(:last_name, 'Jobs')
+      assert_equal 2, @user.versions.first.number
+    end
+    
+    context "With :initial_version option" do
+      setup do
+        User.prepare_versioned_options(:initial_version => true)
+        @user = User.create(:name => @name)
+      end
+      should 'should be number 1' do
+        assert_equal 1, @user.versions.first.number
+      end
+      teardown do
+        User.prepare_versioned_options(:initial_version => nil)
+      end
+    end
+  end
+end