factoryform 0.1.0

data/test/boolean_test.rb

@@ -0,0 +1,10 @@
+require 'test_helper'
+
+class BooleanTest < Test::Unit::TestCase
+
+  def test_should_create_boolean_answer_field 
+    bool = FactoryForm::Boolean.new(:id => "fav-color", :label => "Choose your favourite color")
+    assert_equal [true, false], bool.values
+  end
+
+end

data/test/currency_test.rb

@@ -0,0 +1,9 @@
+require 'test_helper'
+
+class CurrencyTest < Test::Unit::TestCase
+
+  def test_should_create_currency_field 
+    
+  end
+
+end

data/test/date_answer_test.rb

@@ -0,0 +1,10 @@
+require 'test_helper'
+
+class DateAnswerTest < Test::Unit::TestCase
+
+  def test_should_create_date_answer_field 
+    date = FactoryForm::DateAnswer.new(:id => "date_1", :label => "Give date of establishment")
+    assert_equal "date", date.validation_format
+  end
+
+end

data/test/descriptive_content_test.rb

@@ -0,0 +1,14 @@
+require 'test_helper'
+
+class DescriptiveContentTest < Test::Unit::TestCase
+  def test_should_create_descriptive_content_field_with_minimum_params_passed
+    dc = FactoryForm::DescriptiveContent.new(:id => "field_3", :label => "Personal email address")
+    assert_equal "Personal email address",dc.label
+    
+  end
+  
+  def test_should_raise_exception_unless_required_params_passed
+    # Raise expected argument exception as ID,label are required
+    assert_raise(FactoryForm::ParameterExpectedException){ FactoryForm::DescriptiveContent.new() }
+  end
+end

data/test/field_test.rb

@@ -0,0 +1,19 @@
+require 'test_helper'
+
+class FieldTest < Test::Unit::TestCase
+
+  def test_should_check_of_having_validation 
+    sa1 = FactoryForm::ShortAnswer.new(:id => "email_1", :label => "Personal email address")
+    la1 = FactoryForm::LongAnswer.new(:id => "comments", :label => "Provide your comments below")
+
+    # By default, no validation for different formats unless explicitly specified
+    assert_equal "general",sa1.validation_format 
+
+    # By default, answer for this field is optional unless explicitly specified as required
+    assert_equal true,sa1.required
+
+    # By default, no uniqueness of answer for this field unless explicitly specified as unique
+    assert_equal false,sa1.unique
+  end
+
+end

data/test/form_test.rb

@@ -0,0 +1,166 @@
+require 'test_helper'
+
+class FormTest < Test::Unit::TestCase
+
+  def test_should_create_form
+    # Create short answer and long answer objects
+    sa = FactoryForm::ShortAnswer.new(:id => "email_1",:label => "Personal email address" )
+    la = FactoryForm::LongAnswer.new(:id => "comment_1",:label => "Provide your comments below")
+    form = FactoryForm::Form.new() 
+
+    # Add short answer and long answer objects
+    form.add(sa)
+    form.add(la)
+
+    assert_equal 2,form.fields.length
+
+    # Create form object with title
+    form2 = FactoryForm::Form.new({:title => "Data collection"})
+    assert_equal "Data collection", form2.title
+
+  end
+
+  def test_should_list_all_the_fields
+    sa = FactoryForm::ShortAnswer.new(:id => "url_1",:label => "Personal web address",
+    :options => {
+      :hint => "It should be his/her personal web address",
+      :validation_format => "url",
+      :required => true,
+      :unique => false
+    }
+    )
+
+    la = FactoryForm::LongAnswer.new(:id => "comment_1",:label => "Provide your comments below", 
+    :options => {
+      :hint => "Up to a maximum of 250 characters",
+      :required => false,
+      :unique => true,
+      :min_chars => 50,
+      :rows => 6,
+      :cols => 5
+    }
+    )
+    form = FactoryForm::Form.new()
+    form.add(sa)
+    form.add(la)
+
+    # Get the list of all fields in the form
+    list = form.fields
+
+    assert_equal true,list.first.required
+    assert_equal "url", list.first.validation_format
+
+    assert_equal true,list.last.required    
+
+  end
+
+  def test_should_get_field
+    form = create_form
+    assert_equal 3, form.fields.length
+
+    # Get email field
+    field_to_delete = form.get(:id => "email_1")
+    assert_instance_of FactoryForm::ShortAnswer,field_to_delete  
+
+    # Delete email field
+    form.remove(field_to_delete)
+
+    assert_equal 2, form.fields.length
+    assert_instance_of FactoryForm::LongAnswer, form.fields.first
+
+  end
+
+  def test_should_re_order_fields
+    form = create_form
+    field1 = form.get(:id => "email_1")
+    field2 = form.get(:id => "comment_1")
+    field3 = form.get(:id => "name_1")
+
+    assert_equal 0,form.fields.index(field1)
+    assert_equal 1,form.fields.index(field2)
+
+    # Move email field down
+    form.move_down(field1) 
+
+    assert_equal 1,form.fields.index(field1)
+    assert_equal 0,form.fields.index(field2)
+
+    # Move comment field up
+    form.move_up(field3)
+
+    assert_equal 0,form.fields.index(field2)
+    assert_equal 1,form.fields.index(field3)
+    assert_equal 2,form.fields.index(field1)
+
+  end
+
+  def test_should_change_to_yml 
+    form = create_form
+    changed_yml = form.to_yml
+    # TODO: FIND BETTER WAY FOR TESTING .yml CONTENT-TYPE
+    assert_kind_of(String, changed_yml) 
+
+    # Create short answer and long answer objects
+    sa = FactoryForm::ShortAnswer.new(:id => "email_1",:label => "Personal email address" )
+    la = FactoryForm::LongAnswer.new(:id => "comment_1",:label => "Provide your comments below")
+    td = FactoryForm::TextData.new(:id => "name_1", :label => "Person's name")    
+    img = FactoryForm::ImageData.new(:id => "photo_1", :label => "Photo of person")
+    form = FactoryForm::Form.new(:title => "Survey form") 
+
+    # Add short answer and long answer objects
+    form.add(sa)
+    form.add(la)
+    form.add(td)
+    form.add(img)
+    assert_instance_of FactoryForm::ImageData, form.fields.last
+    
+  
+  end
+
+  def test_should_change_position_in_yml_string
+    form = create_form
+    field1 = form.get(:id => "email_1")
+    field2 = form.get(:id => "comment_1")
+    changed_yml = form.to_yml
+
+    # Convert to hash for making sure that yaml string is also changed
+    before_hash =  YAML::load(changed_yml)
+    assert_instance_of FactoryForm::ShortAnswer, before_hash.fields.first
+
+    # Move email field down
+    form.move_down(field1) 
+    after_hash = YAML::load(form.to_yml)
+    assert_instance_of FactoryForm::LongAnswer, after_hash.fields.first
+
+    form.add(FactoryForm::TextData.new(:id => "my-name", :label => "my name"))
+    assert_instance_of FactoryForm::TextData, after_hash.fields.last
+
+  end
+
+  def test_should_change_to_xml 
+    form = create_form
+    changed_xml = form.to_xml
+    # TODO: FIND BETTER WAY FOR TESTING .xml CONTENT-TYPE
+    assert_kind_of(String, changed_xml) 
+  end
+
+  def test_should_change_to_json
+    form = create_form  
+    changed_json = form.to_json
+
+    # TODO: FIND BETTER WAY FOR TESTING json CONTENT-TYPE
+    assert_kind_of(String, changed_json) 
+  end
+
+  private 
+  def create_form
+    sa = FactoryForm::ShortAnswer.new(:id => "email_1", :label => "Personal email address" )
+    la = FactoryForm::LongAnswer.new(:id => "comment_1", :label => "Provide your comments below")
+    td = FactoryForm::TextData.new(:id => "name_1", :label => "Person's name")  
+    form = FactoryForm::Form.new()
+    form.add(sa)
+    form.add(la)
+    form.add(td)
+    return form
+  end
+end

data/test/image_data_test.rb

@@ -0,0 +1,18 @@
+require 'test_helper'
+
+class ImageDataTest < Test::Unit::TestCase
+  def test_should_create_image_data_field_with_minimum_params_passed
+    td = FactoryForm::ImageData.new(:id => "photo_1", :label => "Photo of child")
+    assert_equal "Photo of child",td.label
+    
+    # By default alt attribute is same as field id
+    assert_equal "Photo of child",td.alt
+    assert_equal "image_data",td.field_type
+    assert_equal true,td.required    
+  end
+  
+  def test_should_raise_exception_unless_required_params_passed
+    # Raise expected argument exception as ID,label are required
+    assert_raise(FactoryForm::ParameterExpectedException){ FactoryForm::ImageData.new() }
+  end
+end

data/test/long_answer_test.rb

@@ -0,0 +1,54 @@
+require 'test_helper'
+
+class LongAnswerTest < Test::Unit::TestCase
+  def test_should_create_long_answer_field
+    la = FactoryForm::LongAnswer.new(:id => "comments", :label => "Provide your comments below")
+
+    # Long answer text should not have any validation format
+    assert_equal "general", la.validation_format
+
+    la.hint = "Up to a maximum of 250 characters"
+    assert_equal "Up to a maximum of 250 characters", la.hint
+
+    # By default, answer for this field is optional unless explicitly specified as required
+    assert_equal true,la.required
+
+    # By default, no uniqueness of answer for this field unless explicitly specified as unique
+    assert_equal false,la.unique
+
+    # Set answer for this field as required
+    la.required = true
+
+    # Set answer for this field to be unique
+    la.unique = true
+
+    # Should have required attribute to be true
+    assert_equal true, la.required 
+
+    # Should have unique answers
+    assert_equal true, la.unique
+      
+    # Should have 500 min_chars
+    assert_equal 500, la.min_chars
+    
+    # Pass min_chars 
+    la2 = FactoryForm::LongAnswer.new(:id => "comments", :label => "Provide your comments below", :options => {:min_chars => 700 })
+    assert_equal 700, la2.min_chars
+    
+    # Field type
+    assert_equal "long_answer", la.field_type
+
+  end
+
+   def test_should_not_create_long_answer_field_if_ID_label_are_missing
+    # Raise expected argument exception as ID,label are required
+    assert_raise(FactoryForm::ParameterExpectedException){ FactoryForm::LongAnswer.new() }
+  end
+
+  def test_should_set_minimum_number_of_characters
+    la = FactoryForm::LongAnswer.new(:id => "comments", :label => "Provide your comments below")
+    la.min_chars = 500
+    assert_equal 500,la.min_chars
+  end
+
+end

data/test/multiple_choice_test.rb

@@ -0,0 +1,61 @@
+require 'test_helper'
+
+class MultipleChoiceTest < Test::Unit::TestCase
+  def test_should_create_multiple_choice_answer_field 
+
+    # Multiple choice should have value attributes passed as well
+    assert_raise(FactoryForm::ParameterExpectedException){ FactoryForm::MultipleChoice.new(:id => "fav-color", :label => "Choose your favourite color") }
+
+    mc = FactoryForm::MultipleChoice.new(:id => "fav-color", :label => "Choose your favourite color",
+                                  :values => ["Red color","Green color"]
+                                      )
+    
+    # There should be at least two values for this field
+    assert_raise(FactoryForm::ParameterExpectedException){ FactoryForm::MultipleChoice.new(:id => "fav-color", :label => "Choose your favourite color") }
+    assert_equal 2, mc.values.length
+  
+  end
+    
+  def test_should_add_remove_new_option
+     mc = FactoryForm::MultipleChoice.new(:id => "fav-color", :label => "Choose your favourite color",
+                                    :values => ["Red color","Green color"]
+                                        )
+     assert_equal "Green color", mc.values.last
+     assert_equal 2, mc.values.length
+                                 
+    # Add other option values
+    mc.add_option("Blue Color")
+    assert_equal "Blue Color", mc.values.last
+    assert_equal 3, mc.values.length
+    
+    mc.remove_option("Blue Color")
+    assert_equal 2, mc.values.length
+    
+  end  
+  
+  def test_should_support_different_field_types
+    mc = FactoryForm::MultipleChoice.new(:id => "fav-color", :label => "Choose your favourite color",
+                                  :values => ["Red color","Green color"]
+                                      )    
+    assert_equal "radio_button", mc.field_type
+    
+    mc = FactoryForm::MultipleChoice.new(:id => "fav-color", :label => "Choose your favourite color",
+                                        :values => ["Red color","Green color"],
+                                        :field_type => "check_box"
+                                        )    
+    assert_equal "check_box", mc.field_type
+    
+    # Should not allow field types other than "select_box", "check_box", "radio_button"
+    assert_raise(ArgumentError){ FactoryForm::MultipleChoice.new(:id => "fav-color", :label => "Choose your favourite color",
+                                                                  :values => ["Red color","Green color"],
+                                                                  :field_type => "list"
+                                                                ) 
+                                }
+                                
+    # Change field type to select_box
+    mc.field_type = "select_box"
+    assert_equal "select_box", mc.field_type
+    
+  end
+    
+end

data/test/number_test.rb

@@ -0,0 +1,11 @@
+require 'test_helper'
+
+class NumberTest < Test::Unit::TestCase
+
+  def test_should_create_number_answer_field 
+    number = FactoryForm::Number.new(:id => "number_1", :label => "Give phone number")
+    assert_equal "number", number.validation_format
+    assert_equal "short_answer", number.field_type 
+  end
+
+end

data/test/rating_test.rb

@@ -0,0 +1,21 @@
+require 'test_helper'
+
+class RatingTest < Test::Unit::TestCase
+  def test_should_create_rating_answer_field 
+
+    # Rating answer field should have scale attributes passed as well
+    assert_raise(FactoryForm::ParameterExpectedException){ FactoryForm::Rating.new(:id => "rating_1", :label => "Choose your ranking" ) }
+  
+    # Create rating answer field providing scales
+    rating = FactoryForm::Rating.new(:id => "rating_1", :label => "Choose your ranking" , :scale => "5" )
+    assert_equal 5, rating.scale
+    assert_equal "", rating.from_label
+  
+    # Create rating answer field providing from and to label
+    rating = FactoryForm::Rating.new(:id => "rating_1", :label => "How would you rank this website, on the basis of easiness of UI ?" , :scale => 5, :from_label => "bad", :to_label => "good" )
+    assert_equal "bad", rating.from_label
+    assert_equal "good", rating.to_label
+    assert_equal "rating", rating.field_type
+  end
+  
+end

data/test/short_answer_test.rb

@@ -0,0 +1,83 @@
+require 'test_helper'
+
+class ShortAnswerTest < Test::Unit::TestCase
+  def test_should_create_short_answer_field_with_minimum_params_passed
+    sa1 = FactoryForm::ShortAnswer.new(:id => "email_1", :label => "Personal email address")
+
+    # By default, no validation for different formats unless explicitly specified
+    assert_equal "general",sa1.validation_format
+
+    # By default, answer for this field is optional unless explicitly specified as required
+    assert_equal true,sa1.required
+
+    # By default, no uniqueness of answer for this field unless explicitly specified as unique
+    assert_equal false,sa1.unique
+
+    # Set validation format as email
+    sa1.validation_format = "email"
+
+    # Should have email format as validation_format
+    assert_equal "email", sa1.validation_format
+
+    # Set answer for this field as required
+    sa1.required = true
+
+    # Set answer for this field to be unique
+    sa1.unique = true
+
+    # Should have required attribute to be true
+    assert_equal true, sa1.required 
+
+    # Should have unique answers
+    assert_equal true, sa1.unique 
+    
+    assert_equal "short_answer", sa1.field_type
+
+
+    sa1.hint = "It should be his/her personal email address, not his official address."
+    assert_equal "It should be his/her personal email address, not his official address.", sa1.hint
+
+    # Ensures object of this class
+    assert_instance_of FactoryForm::ShortAnswer, sa1
+
+  end
+
+  def test_should_create_short_answer_field_with_all_other_optional_params 
+    sa = FactoryForm::ShortAnswer.new(:id => "url_1", :label => "Personal web address",
+    :options => {
+      :hint => "It should be his/her personal web address",
+      :validation_format => "url",
+      :required => true,
+      :unique => false
+    }
+    )
+    assert_equal "url_1", sa.id
+    assert_equal "Personal web address", sa.label
+    assert_equal "It should be his/her personal web address", sa.hint
+    assert_equal "url", sa.validation_format
+    assert_equal true, sa.required 
+    assert_equal false, sa.unique 
+
+  end
+
+  def test_should_not_create_short_answer_field_if_required_params_are_missing
+    # Raise expected argument exception as ID,label are required
+    assert_raise(FactoryForm::ParameterExpectedException){ FactoryForm::ShortAnswer.new() }
+  end
+
+  def test_should_not_raise_exception_for_valid_params_passed
+    assert_nothing_raised(Exception){ FactoryForm::ShortAnswer.new(:id => "phone_number", :label => "Phone Number") }
+  end
+
+  def test_should_raise_exception_if_duplicate_ID_exists
+    sa1 = FactoryForm::ShortAnswer.new(:id => "email_1", :label => "Official email address")
+    sa2 = FactoryForm::ShortAnswer.new(:id => "email_1", :label => "Personal email address")
+    form = FactoryForm::Form.new
+    form.add(sa1)
+    
+    # Raise duplicate ID exception
+    assert_raise(FactoryForm::DuplicateIDException){ form.add(sa2) }
+  end
+
+
+end