caring_form 1.2.3

data/spec/caring_form/action_view_extensions/form_helper_spec.rb

@@ -0,0 +1,72 @@
+require File.expand_path('../../../spec_helper', __FILE__)
+
+require 'caring_form/action_view_extensions/form_helper'
+
+unless defined?(CaringForm::FormBuilder)
+  module CaringForm
+    FormBuilder = Class.new
+  end
+end
+
+class FormHelperTester < SimpleDelegator
+  include CaringForm::ActionViewExtensions::FormHelper
+  def mock
+    __getobj__
+  end
+end
+
+describe CaringForm::ActionViewExtensions::FormHelper do
+  let(:helper_mock) { MiniTest::Mock.new }
+  let(:helper)      { FormHelperTester.new(helper_mock) }
+  let(:form)        { MiniTest::Mock.new }
+
+  context "#caring_form_for" do
+    before(:each) do
+      [:classes, :id].each { |meth| form.expect(meth, nil) }
+    end
+
+    it "instantiates a caring form builder and delegates to #form_for" do
+      def helper_mock.form_for(form, options = {})
+        form.form_object?.must_equal true
+        options[:builder].must_equal CaringForm::FormBuilder
+        "html content"
+      end
+      form.expect(:form_object?, true)
+      helper.caring_form_for(form, :url => '/').must_equal "html content"
+    end
+
+    it "adds classes to the form tag" do
+      def helper_mock.form_for(form, options = {})
+        ['caring-form', 'form-text', 'simple_form'].each do |name|
+          options[:html][:class].must_include name
+        end
+      end
+      options = {:url => '/'}
+      helper.caring_form_for(form, options)
+    end
+
+    it "allows to add more classes to the form tag" do
+      def helper_mock.form_for(form, options = {})
+        options[:html][:class].must_include 'my-class'
+        options[:html][:class].must_include 'my-other-class'
+      end
+      options = {:url => '/', :html => {:class => "my-class my-other-class"}}
+      helper.caring_form_for(form, options)
+    end
+
+    it "allows to set a custom URL" do
+      def helper_mock.form_for(form, options = {})
+        options[:url].must_equal '/my/custom/url'
+      end
+      helper.caring_form_for(form, :url => '/my/custom/url')
+    end
+
+    it "asks the form object for its URL if not specified" do
+      def helper_mock.form_for(form, options = {})
+        options[:url].must_equal '/form/url'
+      end
+      2.times { form.expect(:url, '/form/url') }
+      helper.caring_form_for(form)
+    end
+  end
+end

data/spec/caring_form/dsl_spec.rb

@@ -0,0 +1,21 @@
+require File.expand_path('../../spec_helper', __FILE__)
+
+require 'caring_form'
+
+describe CaringForm::Dsl do
+  let(:form_class) do
+    Class.new(CaringForm::Model) do
+      def self.model_name
+        ActiveModel::Name.new(self, nil, 'ZeForm')
+      end
+    end
+  end
+
+  context "#attributes" do
+    it "returns a hash of non nil attribute values" do
+      form_class.instance_eval { string :first; string :last }
+      form = form_class.new(:first => "John")
+      form.attributes.must_equal(:first => "John")
+    end
+  end
+end

data/spec/caring_form/field/base_spec.rb

@@ -0,0 +1,204 @@
+require File.expand_path('../../../spec_helper', __FILE__)
+
+require 'caring_form'
+
+class TestFormBase < CaringForm::Model
+  def self.model_name
+      ActiveModel::Name.new(self, nil, 'ZeForm')
+  end
+
+  def self.inherited(klass)
+    super
+    klass.url '/'
+  end
+end
+
+MiniTest::Spec.register_spec_type(/CaringForm::Field::Base$/, ControllerSpec)
+
+describe CaringForm::Field::Base do
+  include SimpleForm::ActionViewExtensions::FormHelper
+  include CaringForm::ActionViewExtensions::FormHelper
+
+  context "basics" do
+    def build_form(*args)
+      klass = Class.new(TestFormBase) do
+        string :age, :hint => "Enter your age"
+        string :name
+      end
+      klass.new(*args)
+    end
+
+    it "renders a field as a label, an input field and a hint" do
+      view = caring_form_for(build_form(:age => 41)) do |f|
+        f.field :age
+      end
+      html_matcher('li.field').must_be :matching, view
+      html_matcher(
+        'li > label[for="ze_form_age"]', :text => "Age"
+      ).must_be :matching, view
+      html_matcher(
+        'li > input', :with => {:name => 'ze_form[age]', :value => "41"}
+      ).must_be :matching, view
+      html_matcher(
+        'li > input + p.hint', :text => "Enter your age"
+      ).must_be :matching, view
+    end
+
+    it "can overide the label" do
+      view = caring_form_for(build_form) do |f|
+        f.field :age, :label => "Dude, your age"
+      end
+      html_matcher(
+        'li > label[for="ze_form_age"]', :text => "Dude, your age"
+      ).must_be :matching, view
+    end
+
+    it "marks the field wrapper state as error if the field has errors" do
+      form = build_form(:age => "42")
+      form.valid?
+      view = caring_form_for(form) { |f| f.field :age, :name }
+      html_matcher(
+        'li.field.field-with-errors > input#ze_form_age'
+      ).wont_be :matching, view
+      html_matcher(
+        'li.field.field-with-errors > input#ze_form_name'
+      ).must_be :matching, view
+    end
+  end
+
+  context "conditionals" do
+    it "can specify a label as a symbol so it is rendered dynamically" do
+      klass = Class.new(TestFormBase) do
+        text :notes, :label => :dynamic
+        attr_accessor :custom_label
+        def dynamic
+          custom_label || 'Default Label'
+        end
+      end
+      form = klass.new
+      view = caring_form_for(form) do |f|
+        f.field :notes
+      end
+      html_matcher(
+        'li > label[for="ze_form_notes"]', :text => "Default Label"
+      ).must_be :matching, view
+
+      form.custom_label = "Changed"
+      view = caring_form_for(form) do |f|
+        f.field :notes
+      end
+      html_matcher(
+        'li > label[for="ze_form_notes"]', :text => "Changed"
+      ).must_be :matching, view
+    end
+
+    it "can specify a collection as a symbol so it is queried dynamically" do
+      klass = Class.new(TestFormBase) do
+        collection  :answer, :collection => :alternatives, :optional => true
+        def alternatives
+          %w(maybe likely)
+        end
+      end
+      form = klass.new
+      view = caring_form_for(form) do |f|
+        f.field :answer
+      end
+      html_matcher(
+        'li > select > option[value="maybe"]', :text => "maybe"
+      ).must_be :matching, view
+      html_matcher(
+        'li > select > option[value="likely"]', :text => "likely"
+      ).must_be :matching, view
+    end
+
+    it "can generate a field or not using the :if option" do
+      klass = Class.new(TestFormBase) do
+        us_zip_code :zip_code, :if => :zip_code_is_relevant?
+        def zip_code_is_relevant?
+          zip_code != 'nope'
+        end
+      end
+      form = klass.new
+      view = caring_form_for(form) do |f|
+        f.field :zip_code
+      end
+      html_matcher('li.field > label[for="ze_form_zip_code"]').must_be :matching, view
+      html_matcher('input#ze_form_zip_code').must_be :matching, view
+
+      form.zip_code = 'nope'
+      view = caring_form_for(form) do |f|
+        f.field :zip_code
+      end
+      html_matcher('li.field > label[for="ze_form_zip_code"]').wont_be :matching, view
+      html_matcher('input#ze_form_zip_code').wont_be :matching, view
+    end
+  end
+
+  context "optional fields" do
+    it "renders an (optional) label when the field is optional" do
+      klass = Class.new(TestFormBase) do
+        collection :gender, :collection => %w(female male), :optional => true
+      end
+      form = klass.new
+      view = caring_form_for(form) do |f|
+        f.field :gender
+      end
+      html_matcher(
+        'li > label[for="ze_form_gender"] > span.opt', :text => '(optional)'
+      ).must_be :matching, view
+      html_matcher(
+        'li > label[for="ze_form_gender"]', :text => 'Gender (optional)'
+      ).must_be :matching, view
+    end
+
+    it "doesn't render an (optional) label when the field is required and uses :if" do
+      klass = Class.new(TestFormBase) do
+        us_zip_code :zip_code, label: "Your Zip", if: :use_zip_code?
+        def use_zip_code?
+          true
+        end
+      end
+      form = klass.new
+      view = caring_form_for(form) do |f|
+        f.field :zip_code
+      end
+      html_matcher(
+        'li > label[for="ze_form_zip_code"]', :text => 'Your Zip'
+      ).must_be :matching, view
+      html_matcher(
+        'li > label[for="ze_form_zip_code"] > span.opt', :text => '(optional)'
+      ).wont_be :matching, view
+    end
+
+    it "can conditionally mark a field as optional using a condition hash" do
+      klass = Class.new(TestFormBase) do
+        string :date, :input_html => {:id => 'ze_date'}
+        string :time, :optional => {:absent => :date}
+      end
+      form = klass.new(:value => false)
+      view = caring_form_for(form) do |f|
+        f.field :time
+      end
+      html_matcher(
+        'input#ze_form_time[data-optional-if-absent="#ze_date"]'
+      ).must_be :matching, view
+    end
+
+    it "can have 2 fields with interdependent optional rule conditions" do
+      klass = Class.new(TestFormBase) do
+        string :date, :input_html => {:id => 'ze_date'}, :optional => {:absent => :time}
+        string :time, :input_html => {:id => 'ze_time'}, :optional => {:absent => :date}
+      end
+      form = klass.new(:value => false)
+      view = caring_form_for(form) do |f|
+        f.field(:date) + f.field(:time)
+      end
+      html_matcher(
+        'input#ze_time[data-optional-if-absent="#ze_date"]'
+      ).must_be :matching, view
+      html_matcher(
+        'input#ze_date[data-optional-if-absent="#ze_time"]'
+      ).must_be :matching, view
+    end
+  end
+end

data/spec/caring_form/field/check_boxes_spec.rb

@@ -0,0 +1,32 @@
+require File.expand_path('../../../spec_helper', __FILE__)
+
+require 'caring_form'
+
+class CheckBoxesTestForm < CaringForm::Model
+  url '/'
+  check_boxes :languages, :collection => %w(English Italian French)
+end
+
+MiniTest::Spec.register_spec_type(/CaringForm::Field::CheckBoxes$/, ControllerSpec)
+
+describe CaringForm::Field::CheckBoxes do
+  include SimpleForm::ActionViewExtensions::FormHelper
+  include CaringForm::ActionViewExtensions::FormHelper
+
+  it "renders a collection as check boxes" do
+    form = CheckBoxesTestForm.new(:languages => ['English', 'French'])
+    view = caring_form_for(form) do |f|
+      f.field :languages
+    end
+    html_matcher(
+      'input[value="English"][checked]', :with => {:name => 'check_boxes_test_form[languages][]', :type => 'checkbox'}
+    ).must_be :matching, view
+    html_matcher(
+      'input[value="Italian"]', :with => {:name => 'check_boxes_test_form[languages][]', :type => 'checkbox'}
+    ).must_be :matching, view
+    html_matcher('input[value="Italian"][checked]').wont_be :matching, view
+    html_matcher(
+      'input[value="French"][checked]', :with => {:name => 'check_boxes_test_form[languages][]', :type => 'checkbox'}
+    ).must_be :matching, view
+  end
+end

data/spec/caring_form/field/collection_spec.rb

@@ -0,0 +1,28 @@
+require File.expand_path('../../../spec_helper', __FILE__)
+
+require 'caring_form'
+
+class CollectionTestForm < CaringForm::Model
+  url '/'
+  collection    :answer,          :collection => :alternatives, :optional => true
+end
+
+MiniTest::Spec.register_spec_type(/CaringForm::Field::Collection$/, ControllerSpec)
+
+describe CaringForm::Field::Collection do
+  include SimpleForm::ActionViewExtensions::FormHelper
+  include CaringForm::ActionViewExtensions::FormHelper
+
+  it "renders a collection as a drop-down box" do
+    form = CollectionTestForm.new(:answer => 'non')
+    view = caring_form_for(form) do |f|
+      f.field :answer, :collection => %w(oui non)
+    end
+    html_matcher(
+      'li > select > option[value="oui"]', :text => "oui"
+    ).must_be :matching, view
+    html_matcher(
+      'li > select > option[value="non"][selected]', :text => "non"
+    ).must_be :matching, view
+  end
+end

data/spec/caring_form/field/radio_buttons_spec.rb

@@ -0,0 +1,29 @@
+require File.expand_path('../../../spec_helper', __FILE__)
+
+require 'caring_form'
+
+class RadioButtonsTestForm < CaringForm::Model
+  url '/'
+  radio_buttons :choice,          :collection => %w(Yes No)
+end
+
+MiniTest::Spec.register_spec_type(/CaringForm::Field::RadioButtons$/, ControllerSpec)
+
+describe CaringForm::Field::RadioButtons do
+  include SimpleForm::ActionViewExtensions::FormHelper
+  include CaringForm::ActionViewExtensions::FormHelper
+
+  it "renders a collection as caring radio buttons" do
+    form = RadioButtonsTestForm.new(:choice => 'No')
+    view = caring_form_for(form) do |f|
+      f.field :choice
+    end
+    html_matcher(
+      'input[value="Yes"]', :with => {:name => 'radio_buttons_test_form[choice]', :type => 'radio'}
+    ).must_be :matching, view
+    html_matcher('input[value="Yes"][checked]').wont_be :matching, view
+    html_matcher(
+      'input[value="No"][checked]', :with => {:name => 'radio_buttons_test_form[choice]', :type => 'radio'}
+    ).must_be :matching, view
+  end
+end

data/spec/caring_form/field/submit_spec.rb

@@ -0,0 +1,57 @@
+require File.expand_path('../../../spec_helper', __FILE__)
+
+require 'caring_form'
+
+MiniTest::Spec.register_spec_type(/CaringForm::Field::Submit$/, ControllerSpec)
+
+describe CaringForm::Field::Submit do
+  include SimpleForm::ActionViewExtensions::FormHelper
+  include CaringForm::ActionViewExtensions::FormHelper
+
+  let(:form_class) do
+    Class.new(CaringForm::Model) do
+      def self.model_name
+        ActiveModel::Name.new(self, nil, 'ZeForm')
+      end
+      url '/'
+    end
+  end
+
+  it "renders an input of type submit by default" do
+    form_class.instance_eval { submit }
+    view = caring_form_for(form_class.new) { |f| f.field :submit }
+    html_matcher('li input[type="submit"]').must_be :matching, view
+  end
+
+  it "can wrap the submit into a different tag with :wrapper_tag" do
+    form_class.instance_eval { submit :wrapper_tag => :p }
+    view = caring_form_for(form_class.new) { |f| f.field :submit }
+    html_matcher('p input[type="submit"]').must_be :matching, view
+  end
+
+  it "can use a different type of submit with :input_tag option" do
+    form_class.instance_eval { submit :input_tag => :button }
+    view = caring_form_for(form_class.new) { |f| f.field :submit }
+    html_matcher('li button[type="submit"]').must_be :matching, view
+  end
+
+  it "adds the default 'input-width' and 'trackable' classes for an input" do
+    form_class.instance_eval { submit }
+    view = caring_form_for(form_class.new) { |f| f.field :submit }
+    html_matcher('input.input-width.trackable[type="submit"]').must_be :matching, view
+  end
+
+  it "can add a single property to the button" do
+    form_class.instance_eval { submit :marketing, :input_tag => :button }
+    view = caring_form_for(form_class.new) { |f| f.field :submit }
+    html_matcher('button.marketing-button[type="submit"]').must_be :matching, view
+  end
+
+  it "can add multiple properties to the button" do
+    form_class.instance_eval { submit [:secondary, :add, :huge] }
+    view = caring_form_for(form_class.new) { |f| f.field :submit }
+    html_matcher(
+      'input.secondary-button.add-button.huge-button[type="submit"]'
+    ).must_be :matching, view
+  end
+end