formtastic-rails3 0.9.7

data/spec/defaults_spec.rb

@@ -0,0 +1,20 @@
+# coding: utf-8
+require File.join(File.dirname(__FILE__), *%w[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 File.dirname(__FILE__) + '/spec_helper'
+
+describe 'Rails field_error_proc' do
+  
+  include FormtasticSpecHelper
+  
+  before do
+    @output_buffer = ActiveSupport::SafeBuffer.new
+    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,85 @@
+# coding: utf-8
+require File.dirname(__FILE__) + '/spec_helper'
+
+describe 'SemanticFormBuilder#errors_on' do
+  
+  include FormtasticSpecHelper
+  
+  before do
+    @output_buffer = ActiveSupport::SafeBuffer.new
+    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
+  
+end
+

data/spec/form_helper_spec.rb

@@ -0,0 +1,110 @@
+# coding: utf-8
+require File.dirname(__FILE__) + '/spec_helper'
+
+describe 'SemanticFormHelper' do
+  
+  include FormtasticSpecHelper
+  
+  before do
+    @output_buffer = ActiveSupport::SafeBuffer.new
+    mock_everything
+  end
+  
+  describe '#semantic_form_for' do
+
+    it 'yields an instance of SemanticFormBuilder' do
+      semantic_form_for(:post, ::Post.new, :url => '/hello') do |builder|
+        builder.class.should == ::Formtastic::SemanticFormBuilder
+      end
+    end
+
+    it 'adds a class of "formtastic" to the generated form' do
+      semantic_form_for(:post, ::Post.new, :url => '/hello') do |builder|
+      end
+      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
+      semantic_form_for(:post, ::Post.new, :url => '/hello') do |builder|
+      end
+      output_buffer.should have_tag("form.post")
+
+      semantic_form_for(:project, :url => '/hello') do |builder|
+      end
+      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
+      semantic_form_for(@new_post) do |builder|
+      end
+      output_buffer.should have_tag("form.post")
+    end
+
+    it 'adds a namespaced class to the generated form' do
+      semantic_form_for(::Namespaced::Post.new, :url => '/hello') do |builder|
+      end
+      output_buffer.should have_tag("form.namespaced_post")
+    end
+
+    describe 'allows :html options' do
+      before(:each) do
+        semantic_form_for(:post, ::Post.new, :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.should have_tag("form#something-special")
+      end
+
+      it 'to add a class of "something-extra" to generated form' do
+        output_buffer.should have_tag("form.something-extra")
+      end
+
+      it 'to add enctype="multipart/form-data"' do
+        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
+      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
+
+    it 'can be called with a generic style and inline object' do
+      semantic_form_for(:post, ::Post.new, :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(:post, ::Post.new, :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(:post, ::Post.new, :url => '/hello') do |builder|
+        builder.class.should == ::Formtastic::SemanticFormBuilder
+      end
+    end
+  end
+
+end
+

data/spec/i18n_spec.rb

@@ -0,0 +1,131 @@
+# coding: utf-8
+require File.join(File.dirname(__FILE__), *%w[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 = {
+          :required       => 'Default Required',
+          :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
+    
+    it "should translate core strings correctly" do
+      ::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
+      ::I18n.backend.store_translations :en, {:formtastic => {:required => nil}}
+      ::Formtastic::I18n.t(:required, :default => 'Nothing found!').should == 'Nothing found!'
+    end
+    
+  end
+  
+  describe "when no I18n locales are available" do
+    
+    before do
+      ::I18n.backend.store_translations :en, :formtastic => {
+          :required => nil,
+          :yes => nil,
+          :no => nil,
+          :create => nil,
+          :update => nil
+        }
+    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 = ActiveSupport::SafeBuffer.new
+      mock_everything
+      
+      ::I18n.backend.store_translations :en, :formtastic => {
+          :labels => {
+              :title    => "Hello world!",
+              :post     => {:title => "Hello post!"},
+              :project  => {:title => "Hello project!"}
+            }
+        }
+      ::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.store_translations :en, :formtastic => nil
+      ::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
+      semantic_form_for(@new_post) do |builder|
+        concat(builder.input(:title))
+      end
+      output_buffer.should have_tag("form label", /Hello post!/)
+    end
+    
+    it "should be able to translate without form-object" do
+      semantic_form_for(:project, :url => 'http://test.host') do |builder|
+        concat(builder.input(:title))
+      end
+      output_buffer.should have_tag("form label", /Hello project!/)
+    end
+    
+    # TODO: Add spec for namespaced models?
+    
+  end
+  
+end

data/spec/include_blank_spec.rb

@@ -0,0 +1,70 @@
+# coding: utf-8
+require File.dirname(__FILE__) + '/spec_helper'
+
+describe "*select: options[:include_blank]" do
+
+  include FormtasticSpecHelper
+
+  before do
+    @output_buffer = ActiveSupport::SafeBuffer.new
+    mock_everything
+
+    @new_post.stub!(:author_id).and_return(nil)
+    @new_post.stub!(:publish_at).and_return(nil)
+    
+    @select_input_types = {
+        :select => :author,
+        :datetime => :publish_at,
+        :date => :publish_at,
+        :time => :publish_at
+      }
+  end
+
+  describe 'when :include_blank is not set' do
+    it 'blank value should be included if the default value specified in config is true' do
+      ::Formtastic::SemanticFormBuilder.include_blank_for_select_by_default = true
+      @select_input_types.each do |as, attribute|
+        semantic_form_for(@new_post) do |builder|
+          concat(builder.input(attribute, :as => as))
+        end
+        output_buffer.should have_tag("form li select option[@value='']", "")
+      end
+    end
+
+    it 'blank value should not be included if the default value specified in config is false' do
+      ::Formtastic::SemanticFormBuilder.include_blank_for_select_by_default = false
+      @select_input_types.each do |as, attribute|
+        semantic_form_for(@new_post) do |builder|
+          concat(builder.input(attribute, :as => as))
+        end
+        output_buffer.should_not have_tag("form li select option[@value='']", "")
+      end
+    end
+
+    after do
+      ::Formtastic::SemanticFormBuilder.include_blank_for_select_by_default = true
+    end
+  end
+
+  describe 'when :include_blank is set to false' do
+    it 'should not have a blank option' do
+      @select_input_types.each do |as, attribute|
+        semantic_form_for(@new_post) do |builder|
+          concat(builder.input(attribute, :as => as, :include_blank => false))
+        end
+        output_buffer.should_not have_tag("form li select option[@value='']", "")
+      end
+    end
+  end
+
+  describe 'when :include_blank => true is set' do
+    it 'should have a blank select option' do
+      @select_input_types.each do |as, attribute|
+        semantic_form_for(@new_post) do |builder|
+          concat(builder.input(attribute, :as => as, :include_blank => true))
+        end
+        output_buffer.should have_tag("form li select option[@value='']", "")
+      end
+    end
+  end
+end