formhelper 0.1.0

data/README.rdoc

@@ -0,0 +1,24 @@
+= formhelper
+This is a library to create different form field elements, allows form object to parse into different formats (YAML, JSON, XML)
+
+= INSTALLATION
+sudo gem install formhelper
+
+= BASIC USAGE
+require 'rubygems'
+require 'formhelper'
+
+# Create a form object
+form = FormHelper::Form.new() 
+
+# Create short answer and long answer objects
+sa = FormHelper::ShortAnswer.new(:id => "email_1",:label => "Personal email address" )
+la = FormHelper::LongAnswer.new(:id => "comment_1",:label => "Provide your comments below")
+
+# Add short answer and long answer objects
+form.add(sa)
+form.add(la)
+
+# Returns YAML format of form
+form.to_yml
+=> 

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/init.rb

@@ -0,0 +1,2 @@
+# Include hook code here
+# require 'form_library'

data/test/lib/factoryform.rb

@@ -0,0 +1,25 @@
+require File.join(File.dirname(__FILE__),'formhelper/form')
+require File.join(File.dirname(__FILE__),'formhelper/field')
+require File.join(File.dirname(__FILE__),'formhelper/short_answer')
+require File.join(File.dirname(__FILE__),'formhelper/long_answer')
+require File.join(File.dirname(__FILE__),'formhelper/multiple_choice')
+require File.join(File.dirname(__FILE__),'formhelper/utils')
+require File.join(File.dirname(__FILE__),'formhelper/text_data')
+require File.join(File.dirname(__FILE__),'formhelper/image_data')
+require File.join(File.dirname(__FILE__),'formhelper/date_answer')
+require File.join(File.dirname(__FILE__),'formhelper/email')
+require File.join(File.dirname(__FILE__),'formhelper/number')
+require File.join(File.dirname(__FILE__),'formhelper/url')
+require File.join(File.dirname(__FILE__),'formhelper/time_answer')
+require File.join(File.dirname(__FILE__),'formhelper/boolean')
+require File.join(File.dirname(__FILE__),'formhelper/currency')
+require File.join(File.dirname(__FILE__),'formhelper/rating')
+require File.join(File.dirname(__FILE__),'formhelper/descriptive_content')
+
+
+module FactoryForm
+  # Raised when FactoryForm::TextData.new doesn't include a required parameter
+  class ParameterExpectedException < RuntimeError
+
+  end
+end

data/test/lib/factoryform/boolean.rb

@@ -0,0 +1,17 @@
+module FactoryForm
+  class Boolean < Field
+    attr_accessor :values # True/false values
+
+    def initialize(options={})
+      self.values = options[:values] = [true, false]
+      options[:field_type] = "boolean"
+
+      super(options)
+      
+      # Unique is always false
+      self.unique = false
+
+    end
+  end
+end
+

data/test/lib/factoryform/currency.rb

@@ -0,0 +1,7 @@
+module FactoryForm
+  class Currency < Field 
+    # TODO: Need to think about it
+    
+    
+  end
+end

data/test/lib/factoryform/date_answer.rb

@@ -0,0 +1,10 @@
+module FactoryForm
+  class DateAnswer < ShortAnswer 
+    def initialize(options={})
+      options[:field_type] = "date_answer"
+      super(options)
+      @validation_format = "date"
+    end
+  end
+end
+

data/test/lib/factoryform/descriptive_content.rb

@@ -0,0 +1,17 @@
+module FactoryForm
+  class DescriptiveContent 
+    attr_reader :id
+    attr_accessor :label, :value
+
+    def initialize(options = {})
+      unless options.empty? || options[:id].empty? || options[:label].empty?
+        @id, @label, @value = options[:id], options[:label], options[:value] || options[:label]
+      else
+        raise(ParameterExpectedException, "Missing ID and label")
+      end
+    end
+
+  end
+end
+
+

data/test/lib/factoryform/email.rb

@@ -0,0 +1,11 @@
+module FactoryForm
+  class Email < ShortAnswer 
+    def initialize(options={})
+      options[:field_type] = "short_answer"      
+      super(options)
+      @validation_format = "email"
+      # extra attributes for ShortAnswer
+    end
+  end
+  
+end

data/test/lib/factoryform/field.rb

@@ -0,0 +1,29 @@
+module FactoryForm
+  # Field is simply a hash of different attributes 
+  class Field
+    attr_reader :id
+    attr_accessor :label, :hint, :required, :unique, :validation_format, :field_type
+
+    def initialize(options)
+      unless options.nil? || options[:id].nil? || options[:label].nil?
+        extra_options = options[:options] || { }
+        extra_options.merge!({
+          # defaults
+          :hint => extra_options[:hint] || " ",
+          :required => extra_options[:required] || true,
+          :unique => extra_options[:unique] || false,
+          :validation_format => extra_options[:validation_format] || "general",
+          })
+          options.merge!({:options => extra_options})
+
+          @id, @label, @hint, @required, @unique, @validation_format, @field_type = options[:id], options[:label],options[:options][:hint], options[:options][:required], options[:options][:unique], options[:options][:validation_format], options[:field_type]
+        else
+          raise(ParameterExpectedException, "Missing ID and label")
+        end
+      end
+  end
+end
+
+
+
+

data/test/lib/factoryform/form.rb

@@ -0,0 +1,127 @@
+require 'yaml'
+require 'rubygems'
+require 'json/pure'
+require File.join(File.dirname(__FILE__),'utils')
+require 'rexml/document'
+
+module FactoryForm
+  # Form is simply an ordered array of fields. Each Field is simply a hash of field options.
+  class Form 
+    attr_accessor :title, :fields
+
+    def initialize(options = {})
+      @title = options[:title] || ""
+      @fields = Array.new
+    end
+
+    # Add field object
+    def add(field, position=@fields.length)
+      # Check for duplicate ID
+      unless get_ids.include?(field.id)
+        @fields.insert(position, field)
+      else
+        raise(DuplicateIDException, "Duplicate ID")
+      end
+
+    end
+
+    # Get field object by ID  
+    # form.get(:id => "email_1")
+    # TODO:: Get element by other attributes as well
+    def get(option)
+      # @fields[@fields.index(option)]
+      @fields[get_ids.index(option[:id])]
+    end
+
+    # Remove field object
+    def remove(field)
+      @fields.delete(field)
+    end
+
+    def move_up(field, steps = 1)
+      @fields.move_object(field, @fields.index(field) - steps)
+    end
+
+    def move_down(field, steps = 1)
+      @fields.move_object(field, @fields.index(field) + steps)
+    end  
+
+    def move_to_position(field, position)
+      @fields.move_object(field, position)
+    end
+
+    def add_to_position(field, position)
+      @fields.insert(position, field)  
+    end
+
+    def to_yml
+      self.to_yaml
+    end
+
+    def to_json
+      fields = Array.new
+      @fields.each do |f|
+        attributes = f.instance_variables.map{|a| a.gsub("@","")}
+        attributes_hash = {}
+        attributes.each do |a|
+          attributes_hash[a] = f.send(a)
+        end
+        fields << {f.class.name => attributes_hash }  
+      end
+      fields
+      fields.to_json
+    end
+
+    def to_xml
+      doc = REXML::Document.new
+      root = doc.add_element("Form")
+
+      title_element = root.add_element("Title")
+      title_element.add_text("#{self.title}")
+
+      out_string = ''
+      @fields.each {|field|
+        field_element = root.add_element("Field")
+        field_type_element = field_element.add_element("#{field.class.name}")
+
+        field_type_element.add_attribute("id", field.id)
+        field_type_element.add_attribute("label", field.label)
+
+        attributes = field.instance_variables.map{|a| a.gsub("@","")}
+        attributes.each do |attrb|
+          attrb_element = field_type_element.add_element("#{attrb}")
+
+          # For option values of Multiple choice, separate them as option tags
+          if attrb == "values"
+            field.send(attrb).each do |option|
+              option_element = attrb_element.add_element("option")
+              option_element.add_text(option)
+            end
+          else
+            attrb_element.add_text(field.send(attrb).to_s)
+          end  
+        end
+
+        doc.write( out_string = "\n"+'<?xml version="1.0" encoding="UTF-8"?>'+"\n", 2 )
+
+      }
+      return out_string
+    end
+
+    private
+
+    # List of all IDs
+    def get_ids
+      @fields.map(& :id)
+    end
+
+  end
+
+  # Raised if the field with the same ID already exists
+  class DuplicateIDException < RuntimeError
+
+  end
+  
+end
+
+

data/test/lib/factoryform/image_data.rb

@@ -0,0 +1,13 @@
+module FactoryForm
+  class ImageData < Field
+    attr_accessor :alt, :url
+
+    def initialize(options = {})
+      options[:field_type] = "image_data"
+      @url = options[:url] || options[:label]
+      @alt = options[:alt] || options[:label]
+      super(options)
+    end
+  end
+end
+

data/test/lib/factoryform/long_answer.rb

@@ -0,0 +1,12 @@
+module FactoryForm
+  class LongAnswer < Field
+    attr_accessor :min_chars
+    def initialize(options={})
+      options[:field_type] = "long_answer"
+      super(options)
+      @min_chars = options[:options][:min_chars] || 500 # Default number of chars 500
+    end
+  end
+end
+
+

data/test/lib/factoryform/multiple_choice.rb

@@ -0,0 +1,39 @@
+module FactoryForm
+  class MultipleChoice < Field
+    attr_accessor :values # Option values
+    # attr_accessor :type # select_box, check_box, radio_button(:default)
+    FIELD_TYPE = ["select_box", "check_box", "radio_button"]
+
+    def initialize(options={})
+      options[:field_type] ||=  "radio_button"
+      super(options)
+
+      # Unique is always false
+      @unique = false
+      
+      if options[:values] && options[:values].length > 1
+        @values = options[:values]
+      else
+        raise(ParameterExpectedException, "Missing option values (at least two)")
+      end
+      
+      
+      check_field_type
+    end
+
+    def add_option(value)
+      @values.push(value)
+    end
+
+    def remove_option(value)
+      @values.delete(value)
+    end
+    
+    private
+    def check_field_type
+      raise(ArgumentError, "Invalid Field Type, Expected one of select_box, check_box, radio_button") if !FIELD_TYPE.include?(@field_type)
+    end
+    
+  end
+end
+

data/test/lib/factoryform/number.rb

@@ -0,0 +1,11 @@
+module FactoryForm
+  class Number < ShortAnswer 
+    def initialize(options={})
+      options[:field_type] =  "short_answer"      
+      super(options)
+      @validation_format = "number"
+    end
+  end
+end
+
+

data/test/lib/factoryform/rating.rb

@@ -0,0 +1,23 @@
+module FactoryForm
+  # Rating has different scales
+  class Rating < Field
+    attr_accessor :scale, :from_label, :to_label
+
+    def initialize(options={})
+      options[:field_type] = "rating"
+      super(options)
+      
+      # Default is 2 for number of scales
+      if options[:scale] && options[:scale].to_i > 1
+        self.scale = options[:scale].to_i
+      else
+        raise(ParameterExpectedException, "Missing rating scale (should be greater than or equal to 2)")
+      end
+    
+      self.from_label = options[:from_label] || ""
+      self.to_label = options[:to_label] || ""
+          
+    end
+  end
+end
+

data/test/lib/factoryform/short_answer.rb

@@ -0,0 +1,11 @@
+module FactoryForm
+  class ShortAnswer < Field
+    def initialize(options={})
+      options[:field_type] = options[:field_type] || "short_answer"
+      super(options)
+      # extra attributes for ShortAnswer
+
+    end
+  end
+end
+

data/test/lib/factoryform/text_data.rb

@@ -0,0 +1,11 @@
+module FactoryForm
+  class TextData < Field
+    attr_accessor :value
+
+    def initialize(options = {})
+      options[:field_type] = "text_data"
+      @value = options[:value] || options[:label]
+      super(options)
+    end
+  end
+end

data/test/lib/factoryform/time_answer.rb

@@ -0,0 +1,11 @@
+module FactoryForm
+  class TimeAnswer< ShortAnswer 
+    def initialize(options={})
+      options[:field_type] = "short_answer"
+      super(options)
+      @validation_format = "time"
+    end
+  end
+end
+
+

data/test/lib/factoryform/url.rb

@@ -0,0 +1,10 @@
+module FactoryForm
+  class Url < ShortAnswer 
+    def initialize(options={})
+      options[:field_type] = "short_answer"
+      super(options)
+      @validation_format = "url"
+    end
+  end
+end
+

data/test/lib/factoryform/utils.rb

@@ -0,0 +1,13 @@
+class Array
+  def move(from, to)
+    insert(to, delete_at(from))
+  end
+
+  def move_object(obj, to)
+    return self if index(obj).nil? # return original array if obj not found
+    move(index(obj), to)
+  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

data/test/test_helper.rb

@@ -0,0 +1,2 @@
+require 'test/unit'
+require File.join(File.dirname(__FILE__),'../lib/formhelper')

data/test/text_data_test.rb

@@ -0,0 +1,17 @@
+require 'test_helper'
+
+class TextDataTest < Test::Unit::TestCase
+  def test_should_create_text_data_field_with_minimum_params_passed
+    td = FactoryForm::TextData.new(:id => "email_1", :label => "Personal email address")
+    assert_equal "Personal email address",td.label
+    assert_equal 'text_data', td.field_type
+    assert_equal 'general', td.validation_format
+    assert_equal 'Personal email address', td.value
+    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::TextData.new() }
+  end
+end

data/test/time_answer_test.rb

@@ -0,0 +1,10 @@
+require 'test_helper'
+
+class TimeAnswerTest < Test::Unit::TestCase
+
+  def test_should_create_time_answer_field 
+    number = FactoryForm::TimeAnswer.new(:id => "time_1", :label => "Give departure time")
+    assert_equal "time", number.validation_format
+  end
+
+end

data/test/url_test.rb

@@ -0,0 +1,11 @@
+require 'test_helper'
+
+class UrlTest < Test::Unit::TestCase
+
+  def test_should_create_url_answer_field 
+    url = FactoryForm::Url.new(:id => "url_1", :label => "Give url")
+    assert_equal "url", url.validation_format
+    assert_equal "short_answer", url.field_type
+  end
+
+end

metadata

@@ -0,0 +1,169 @@
+--- !ruby/object:Gem::Specification 
+name: formhelper
+version: !ruby/object:Gem::Version 
+  hash: 27
+  prerelease: false
+  segments: 
+  - 0
+  - 1
+  - 0
+  version: 0.1.0
+platform: ruby
+authors: 
+- shyamkkhadka
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-09-24 00:00:00 +05:45
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: json_pure
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 1
+        segments: 
+        - 1
+        - 4
+        - 3
+        version: 1.4.3
+  type: :development
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: json_pure
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 1
+        segments: 
+        - 1
+        - 4
+        - 3
+        version: 1.4.3
+  type: :runtime
+  version_requirements: *id002
+description: "This is a library to create different form field elements, allows form object to parse into different formats (YAML, JSON, XML)\n    "
+email: shyamkkhadka@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README
+- README.rdoc
+files: 
+- README
+- README.rdoc
+- test/boolean_test.rb
+- test/currency_test.rb
+- test/date_answer_test.rb
+- test/descriptive_content_test.rb
+- test/field_test.rb
+- test/form_test.rb
+- test/image_data_test.rb
+- test/init.rb
+- test/lib/factoryform/boolean.rb
+- test/lib/factoryform/currency.rb
+- test/lib/factoryform/date_answer.rb
+- test/lib/factoryform/descriptive_content.rb
+- test/lib/factoryform/email.rb
+- test/lib/factoryform/field.rb
+- test/lib/factoryform/form.rb
+- test/lib/factoryform/image_data.rb
+- test/lib/factoryform/long_answer.rb
+- test/lib/factoryform/multiple_choice.rb
+- test/lib/factoryform/number.rb
+- test/lib/factoryform/rating.rb
+- test/lib/factoryform/short_answer.rb
+- test/lib/factoryform/text_data.rb
+- test/lib/factoryform/time_answer.rb
+- test/lib/factoryform/url.rb
+- test/lib/factoryform/utils.rb
+- test/lib/factoryform.rb
+- test/long_answer_test.rb
+- test/multiple_choice_test.rb
+- test/number_test.rb
+- test/rating_test.rb
+- test/short_answer_test.rb
+- test/test_helper.rb
+- test/text_data_test.rb
+- test/time_answer_test.rb
+- test/url_test.rb
+has_rdoc: true
+homepage: http://github.com/shyamkkhadka/formhelper
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: This is a library to create different form field elements, allows form object to parse into different formats (YAML, JSON, XML)
+test_files: 
+- test/boolean_test.rb
+- test/currency_test.rb
+- test/date_answer_test.rb
+- test/descriptive_content_test.rb
+- test/field_test.rb
+- test/form_test.rb
+- test/image_data_test.rb
+- test/init.rb
+- test/lib/factoryform/boolean.rb
+- test/lib/factoryform/currency.rb
+- test/lib/factoryform/date_answer.rb
+- test/lib/factoryform/descriptive_content.rb
+- test/lib/factoryform/email.rb
+- test/lib/factoryform/field.rb
+- test/lib/factoryform/form.rb
+- test/lib/factoryform/image_data.rb
+- test/lib/factoryform/long_answer.rb
+- test/lib/factoryform/multiple_choice.rb
+- test/lib/factoryform/number.rb
+- test/lib/factoryform/rating.rb
+- test/lib/factoryform/short_answer.rb
+- test/lib/factoryform/text_data.rb
+- test/lib/factoryform/time_answer.rb
+- test/lib/factoryform/url.rb
+- test/lib/factoryform/utils.rb
+- test/lib/factoryform.rb
+- test/long_answer_test.rb
+- test/multiple_choice_test.rb
+- test/number_test.rb
+- test/rating_test.rb
+- test/short_answer_test.rb
+- test/test_helper.rb
+- test/text_data_test.rb
+- test/time_answer_test.rb
+- test/url_test.rb