sensis-formtastic-rails3 1.d4e5326

data/spec/custom_builder_spec.rb

@@ -0,0 +1,98 @@
+# coding: utf-8
+require 'spec_helper'
+
+describe 'Formtastic::SemanticFormHelper.builder' do
+
+  include FormtasticSpecHelper
+  
+  class MyCustomFormBuilder < ::Formtastic::SemanticFormBuilder
+    def awesome_input(method, options)
+      self.text_field(method)
+    end
+  end
+  
+  before do
+    @output_buffer = ''
+    mock_everything
+  end
+  
+  it 'is the Formtastic::SemanticFormBuilder by default' do
+    ::Formtastic::SemanticFormHelper.builder.should == ::Formtastic::SemanticFormBuilder
+  end
+  
+  it 'can be configured to use your own custom form builder' do
+    # Set it to a custom builder class
+    ::Formtastic::SemanticFormHelper.builder = MyCustomFormBuilder
+    ::Formtastic::SemanticFormHelper.builder.should == MyCustomFormBuilder
+    
+    # Reset it to the default
+    ::Formtastic::SemanticFormHelper.builder = ::Formtastic::SemanticFormBuilder
+    ::Formtastic::SemanticFormHelper.builder.should == ::Formtastic::SemanticFormBuilder
+  end
+
+  it 'should allow custom settings per form builder subclass' do
+    with_config(:all_fields_required_by_default, true) do
+      MyCustomFormBuilder.all_fields_required_by_default = false
+
+      MyCustomFormBuilder.all_fields_required_by_default.should be_false
+      ::Formtastic::SemanticFormBuilder.all_fields_required_by_default.should be_true
+    end
+  end
+
+  describe "when using a custom builder" do
+    
+    before do
+      @new_post.stub!(:title)
+      ::Formtastic::SemanticFormHelper.builder = MyCustomFormBuilder
+    end
+    
+    after do
+      ::Formtastic::SemanticFormHelper.builder = ::Formtastic::SemanticFormBuilder
+    end
+    
+    describe "semantic_form_for" do
+      
+      it "should yield an instance of the custom builder" do
+        semantic_form_for(@new_post) do |builder|
+          builder.class.should == MyCustomFormBuilder
+        end
+      end
+      
+      it "should allow me to call my custom input" do
+        semantic_form_for(@new_post) do |builder|
+          concat(builder.input(:title, :as => :awesome))
+        end
+      end
+    
+    end
+
+    describe "semantic_fields_for" do
+
+      it "should yield an instance of the parent form builder" do
+        semantic_form_for(@new_post) do |builder|
+          builder.semantic_fields_for(:author) do |nested_builder|
+            nested_builder.class.should == MyCustomFormBuilder
+          end
+        end
+      end
+
+    end
+    
+  end
+
+  describe "when using a builder passed to form options" do
+
+    describe "semantic_fields_for" do
+
+      it "should yield an instance of the parent form builder" do
+        semantic_form_for(@new_post, :builder => MyCustomFormBuilder) do |builder|
+          builder.semantic_fields_for(:author) do |nested_builder|
+            nested_builder.class.should == MyCustomFormBuilder
+          end
+        end
+      end
+
+    end
+
+  end
+end

data/spec/defaults_spec.rb

@@ -0,0 +1,20 @@
+# coding: utf-8
+require 'spec_helper'
+
+describe 'Formtastic::SemanticFormBuilder-defaults' do
+  
+  # Note: This spec might make better sense somewhere else. Just temporary.
+  
+  describe "required string" do
+    
+    it "should render proc with I18n correctly" do
+      ::I18n.backend.store_translations :en, :formtastic => {:required => 'Haha!'}
+      
+      required_string = Formtastic::SemanticFormBuilder.required_string
+      required_string = required_string.is_a?(::Proc) ? required_string.call : required_string.to_s
+      required_string.should == %{<abbr title="Haha!">*</abbr>}
+    end
+    
+  end
+  
+end

data/spec/error_proc_spec.rb

@@ -0,0 +1,27 @@
+# coding: utf-8
+require 'spec_helper'
+
+describe 'Rails field_error_proc' do
+  
+  include FormtasticSpecHelper
+  
+  before do
+    @output_buffer = ''
+    mock_everything
+  end
+  
+  it "should not be overridden globally for all form builders" do
+    current_field_error_proc = ::ActionView::Base.field_error_proc
+    
+    semantic_form_for(@new_post) do |builder|
+      ::ActionView::Base.field_error_proc.should_not == current_field_error_proc
+    end
+    
+    ::ActionView::Base.field_error_proc.should == current_field_error_proc
+    
+    form_for(@new_post) do |builder|
+      ::ActionView::Base.field_error_proc.should == current_field_error_proc
+    end
+  end
+  
+end

data/spec/errors_spec.rb

@@ -0,0 +1,105 @@
+# coding: utf-8
+require 'spec_helper'
+
+describe 'SemanticFormBuilder#errors_on' do
+  
+  include FormtasticSpecHelper
+  
+  before do
+    @output_buffer = ''
+    mock_everything
+    @title_errors = ['must not be blank', 'must be longer than 10 characters', 'must be awesome']
+    @errors = mock('errors')
+    @new_post.stub!(:errors).and_return(@errors)
+  end
+  
+  describe 'when there are errors' do
+    before do
+      @errors.stub!(:[]).with(:title).and_return(@title_errors)
+    end
+    
+    it 'should render a paragraph with the errors joined into a sentence when inline_errors config is :sentence' do
+      ::Formtastic::SemanticFormBuilder.inline_errors = :sentence
+      semantic_form_for(@new_post) do |builder|
+        builder.errors_on(:title).should have_tag('p.inline-errors', @title_errors.to_sentence)
+      end
+    end
+    
+    it 'should render an unordered list with the class errors when inline_errors config is :list' do
+      ::Formtastic::SemanticFormBuilder.inline_errors = :list
+      semantic_form_for(@new_post) do |builder|
+        builder.errors_on(:title).should have_tag('ul.errors')
+        @title_errors.each do |error|
+          builder.errors_on(:title).should have_tag('ul.errors li', error)
+        end
+      end
+    end
+
+    it 'should render a paragraph with the first error when inline_errors config is :first' do
+      ::Formtastic::SemanticFormBuilder.inline_errors = :first
+      semantic_form_for(@new_post) do |builder|
+        builder.errors_on(:title).should have_tag('p.inline-errors', @title_errors.first)
+      end
+    end
+    
+    it 'should return nil when inline_errors config is :none' do
+      ::Formtastic::SemanticFormBuilder.inline_errors = :none
+      semantic_form_for(@new_post) do |builder|
+        builder.errors_on(:title).should be_nil
+      end
+    end
+    
+  end
+  
+  describe 'when there are no errors (nil)' do
+    before do
+      @errors.stub!(:[]).with(:title).and_return(nil)
+    end
+    
+    it 'should return nil when inline_errors config is :sentence, :list or :none' do
+      [:sentence, :list, :none].each do |config|
+        ::Formtastic::SemanticFormBuilder.inline_errors = config
+        semantic_form_for(@new_post) do |builder|
+          builder.errors_on(:title).should be_nil
+        end
+      end
+    end
+  end
+  
+  describe 'when there are no errors (empty array)' do
+    before do
+      @errors.stub!(:[]).with(:title).and_return([])
+    end
+    
+    it 'should return nil when inline_errors config is :sentence, :list or :none' do
+      [:sentence, :list, :none].each do |config|
+        ::Formtastic::SemanticFormBuilder.inline_errors = config
+        semantic_form_for(@new_post) do |builder|
+          builder.errors_on(:title).should be_nil
+        end
+      end
+    end
+  end
+  
+  
+  describe 'when there are errors on the association and column' do
+    
+    it "should list all unique errors" do
+      ::Formtastic::SemanticFormBuilder.inline_errors = :list
+      ::Post.stub!(:reflections).and_return({:author => mock('reflection', :options => {}, :macro => :belongs_to)})
+      
+      @errors.stub!(:[]).with(:author).and_return(['must not be blank'])
+      @errors.stub!(:[]).with(:author_id).and_return(['is already taken', 'must not be blank']) # note the duplicate of association
+      
+      form = semantic_form_for(@new_post) do |builder|
+        concat(builder.input(:author))
+      end
+      output_buffer.concat(form) if Formtastic::Util.rails3?
+      output_buffer.should have_tag("ul.errors li", /must not be blank/, :count => 1)
+      output_buffer.should have_tag("ul.errors li", /is already taken/, :count => 1)
+    end
+    
+  end
+  
+end
+

data/spec/form_helper_spec.rb

@@ -0,0 +1,142 @@
+# coding: utf-8
+require 'spec_helper'
+
+describe 'SemanticFormHelper' do
+  
+  include FormtasticSpecHelper
+  
+  before do
+    @output_buffer = ''
+    mock_everything
+  end
+  
+  describe '#semantic_form_for' do
+
+    it 'yields an instance of SemanticFormBuilder' do
+      semantic_form_for(@new_post, :url => '/hello') do |builder|
+        builder.class.should == ::Formtastic::SemanticFormBuilder
+      end
+    end
+
+    it 'adds a class of "formtastic" to the generated form' do
+      form = semantic_form_for(@new_post, :url => '/hello') do |builder|
+      end
+      output_buffer.concat(form) if Formtastic::Util.rails3?
+      output_buffer.should have_tag("form.formtastic")
+    end
+
+    it 'adds class matching the object name to the generated form when a symbol is provided' do
+      form = semantic_form_for(@new_post, :url => '/hello') do |builder|
+      end
+      output_buffer.concat(form) if Formtastic::Util.rails3?
+      output_buffer.should have_tag("form.post")
+
+      form = semantic_form_for(:project, :url => '/hello') do |builder|
+      end
+      output_buffer.concat(form) if Formtastic::Util.rails3?
+      output_buffer.should have_tag("form.project")
+    end
+
+    it 'adds class matching the object\'s class to the generated form when an object is provided' do
+      form = semantic_form_for(@new_post) do |builder|
+      end
+      output_buffer.concat(form) if Formtastic::Util.rails3?
+      output_buffer.should have_tag("form.post")
+    end
+
+    it 'adds a namespaced class to the generated form' do
+      form = semantic_form_for(::Namespaced::Post.new, :url => '/hello') do |builder|
+      end
+      output_buffer.concat(form) if Formtastic::Util.rails3?
+      output_buffer.should have_tag("form.namespaced_post")
+    end
+
+    describe 'allows :html options' do
+      before(:each) do
+         @form = semantic_form_for(@new_post, :url => '/hello', :html => { :id => "something-special", :class => "something-extra", :multipart => true }) do |builder|
+        end
+      end
+
+      it 'to add a id of "something-special" to generated form' do
+        output_buffer.concat(@form) if Formtastic::Util.rails3?
+        output_buffer.should have_tag("form#something-special")
+      end
+
+      it 'to add a class of "something-extra" to generated form' do
+        output_buffer.concat(@form) if Formtastic::Util.rails3?
+        output_buffer.should have_tag("form.something-extra")
+      end
+
+      it 'to add enctype="multipart/form-data"' do
+        output_buffer.concat(@form) if Formtastic::Util.rails3?
+        output_buffer.should have_tag('form[@enctype="multipart/form-data"]')
+      end
+    end
+
+    it 'can be called with a resource-oriented style' do
+      semantic_form_for(@new_post) do |builder|
+        builder.object.class.should == ::Post
+        builder.object_name.should == "post"
+      end
+    end
+    
+    it 'can be called with a generic style and instance variable' do
+      if rails3?
+        semantic_form_for(@new_post, :as => :post, :url => new_post_path) do |builder|
+          builder.object.class.should == ::Post
+          builder.object_name.to_s.should == "post" # TODO: is this forced .to_s a bad assumption somewhere?
+        end
+      end
+      if rails2?
+        semantic_form_for(:post, @new_post, :url => new_post_path) do |builder|
+          builder.object.class.should == ::Post
+          builder.object_name.to_s.should == "post" # TODO: is this forced .to_s a bad assumption somewhere?
+        end
+      end
+    end
+
+    it 'can be called with a generic style and inline object' do
+      semantic_form_for(@new_post, :url => new_post_path) do |builder|
+        builder.object.class.should == ::Post
+        builder.object_name.to_s.should == "post" # TODO: is this forced .to_s a bad assumption somewhere?
+      end
+    end
+    
+    describe "with :builder option" do
+      it "yields an instance of the given builder" do
+        class MyAwesomeCustomBuilder < ::Formtastic::SemanticFormBuilder
+        end
+        semantic_form_for(@new_post, :url => '/hello', :builder => MyAwesomeCustomBuilder) do |builder|
+          builder.class.should == MyAwesomeCustomBuilder
+        end
+      end
+    end
+    
+  end
+
+  describe '#semantic_fields_for' do
+    it 'yields an instance of SemanticFormBuilder' do
+      semantic_fields_for(@new_post, :url => '/hello') do |builder|
+        builder.class.should == ::Formtastic::SemanticFormBuilder
+      end
+    end
+  end
+
+  describe '#semantic_form_remote_for' do
+    it 'yields an instance of SemanticFormBuilder' do
+      semantic_form_remote_for(@new_post, :url => '/hello') do |builder|
+        builder.class.should == ::Formtastic::SemanticFormBuilder
+      end
+    end
+  end
+
+  describe '#semantic_form_for_remote' do
+    it 'yields an instance of SemanticFormBuilder' do
+      semantic_remote_form_for(@new_post, :url => '/hello') do |builder|
+        builder.class.should == ::Formtastic::SemanticFormBuilder
+      end
+    end
+  end
+
+end
+

data/spec/helpers/layout_helper_spec.rb

@@ -0,0 +1,21 @@
+# coding: utf-8
+require 'spec_helper'
+
+describe Formtastic::LayoutHelper do
+  
+  include FormtasticSpecHelper
+  include Formtastic::LayoutHelper
+  
+  describe '#formtastic_stylesheet_link_tag' do
+    
+    it 'should render a link to formtastic.css' do
+      formtastic_stylesheet_link_tag.should have_tag("link[@href='/stylesheets/formtastic.css']")
+    end
+    
+    it 'should render a link to formtastic_changes.css' do
+      formtastic_stylesheet_link_tag.should have_tag("link[@href='/stylesheets/formtastic_changes.css']")
+    end
+    
+  end
+end
+

data/spec/i18n_spec.rb

@@ -0,0 +1,152 @@
+# coding: utf-8
+require 'spec_helper'
+
+describe 'Formtastic::I18n' do
+  
+  FORMTASTIC_KEYS = [:required, :yes, :no, :create, :update].freeze
+  
+  it "should be defined" do
+    lambda { ::Formtastic::I18n }.should_not raise_error(::NameError)
+  end
+  
+  describe "default translations" do
+    it "should be defined" do
+      lambda { ::Formtastic::I18n::DEFAULT_VALUES }.should_not raise_error(::NameError)
+      ::Formtastic::I18n::DEFAULT_VALUES.is_a?(::Hash).should == true
+    end
+    
+    it "should exists for the core I18n lookup keys" do
+      (::Formtastic::I18n::DEFAULT_VALUES.keys & FORMTASTIC_KEYS).size.should == FORMTASTIC_KEYS.size
+    end
+  end
+  
+  describe "when I18n locales are available" do
+    
+    before do
+      @formtastic_strings = {
+          :yes            => 'Default Yes',
+          :no             => 'Default No',
+          :create         => 'Default Create %{model}',
+          :update         => 'Default Update %{model}',
+          :custom_scope   => {
+              :duck           => 'Duck',
+              :duck_pond      => '%{ducks} ducks in a pond'
+            }
+        }
+      ::I18n.backend.store_translations :en, :formtastic => @formtastic_strings
+    end
+
+    after do
+      ::I18n.backend.reload!
+    end
+    
+    it "should translate core strings correctly" do
+      ::I18n.backend.store_translations :en, {:formtastic => {:required => 'Default Required'}}
+      ::Formtastic::I18n.t(:required).should  == "Default Required"
+      ::Formtastic::I18n.t(:yes).should       == "Default Yes"
+      ::Formtastic::I18n.t(:no).should        == "Default No"
+      ::Formtastic::I18n.t(:create, :model => 'Post').should == "Default Create Post"
+      ::Formtastic::I18n.t(:update, :model => 'Post').should == "Default Update Post"
+    end
+    
+    it "should all belong to scope 'formtastic'" do
+      ::Formtastic::I18n.t(:duck, :scope => [:custom_scope]).should == 'Duck'
+    end
+    
+    it "should override default I18n lookup args if these are specified" do
+      ::Formtastic::I18n.t(:duck_pond, :scope => [:custom_scope], :ducks => 15).should == '15 ducks in a pond'
+    end
+    
+    it "should be possible to override default values" do
+      ::Formtastic::I18n.t(:required, :default => 'Nothing found!').should == 'Nothing found!'
+    end
+    
+  end
+  
+  describe "when no I18n locales are available" do
+    
+    before do
+      ::I18n.backend.reload!
+    end
+
+    it "should use default strings" do
+      (::Formtastic::I18n::DEFAULT_VALUES.keys).each do |key|
+        ::Formtastic::I18n.t(key, :model => '%{model}').should == ::Formtastic::I18n::DEFAULT_VALUES[key]
+      end
+    end
+    
+  end
+  
+  describe "I18n string lookups" do
+    
+    include FormtasticSpecHelper
+    
+    before do
+      @output_buffer = ''
+      mock_everything
+      
+      ::I18n.backend.store_translations :en, :formtastic => {
+          :labels => {
+              :title    => "Hello world!",
+              :post     => {:title => "Hello post!"},
+              :project  => {:title => "Hello project!", :task => {:name => "Hello task name!"}},
+              :line_item => {:name => "Hello line item name!"}
+            }
+        }
+      ::Formtastic::SemanticFormBuilder.i18n_lookups_by_default = true
+      
+      @new_post.stub!(:title)
+      @new_post.stub!(:column_for_attribute).with(:title).and_return(mock('column', :type => :string, :limit => 255))
+    end
+    
+    after do
+      ::I18n.backend.reload!
+      ::Formtastic::SemanticFormBuilder.i18n_lookups_by_default = false
+    end
+    
+    it "lookup scopes should be defined" do
+      lambda { ::Formtastic::I18n::SCOPES }.should_not raise_error(::NameError)
+    end
+    
+    it "should be able to translate with namespaced object" do
+      form = semantic_form_for(@new_post) do |builder|
+        concat(builder.input(:title))
+      end
+      output_buffer.concat(form) if Formtastic::Util.rails3?
+      output_buffer.should have_tag("form label", /Hello post!/)
+    end
+    
+    it "should be able to translate without form-object" do
+      form = semantic_form_for(:project, :url => 'http://test.host') do |builder|
+        concat(builder.input(:title))
+      end
+      output_buffer.concat(form) if Formtastic::Util.rails3?
+      output_buffer.should have_tag("form label", /Hello project!/)
+    end
+    
+    it 'should be able to translate nested objects with nested translations' do
+      form = semantic_form_for(:project, :url => 'http://test.host') do |builder|
+        builder.semantic_fields_for(:task) do |f|
+          concat(f.input(:name))
+        end
+      end
+      output_buffer.concat(form) if Formtastic::Util.rails3?
+      output_buffer.should have_tag("form label", /Hello task name!/)
+    end
+
+    it 'should be able to translated nested objects with top level translations' do
+      form = semantic_form_for(:order, :url => 'http://test.host') do |builder|
+        builder.semantic_fields_for(:line_item) do |f|
+          concat(f.input(:name))
+        end
+      end
+      output_buffer.concat(form) if Formtastic::Util.rails3?
+      output_buffer.should have_tag("form label", /Hello line item name!/)
+    end
+
+
+    # TODO: Add spec for namespaced models?
+    
+  end
+  
+end