easel_helpers 0.3.0

data/test/grid_helper_test.rb

@@ -0,0 +1,226 @@
+require 'test_helper'
+
+class GridHelperTest < EaselHelpers::ViewTestCase
+
+  context "advanced grid structures" do
+
+    should "properly assign classes for a simple column layout" do
+      template = %(
+        <% container do %>
+          <% column do %>
+            <% column :half, :id => "primary" do %>
+              <% column :one_third do %>
+                one third of one half of 24 is 4
+              <% end %>
+              <% column :one_third, :last, prepend_one_third do %>
+                one third of one half of 24 is 4 (but prepended 4 as well)
+              <% end %>
+              <hr/>
+              more text
+            <% end %>
+            <% column :half, :last, :id => "secondary" do %>
+              second column
+            <% end %>
+            <hr/>
+            text
+          <% end %>
+        <% end %>
+      )
+
+      show_view template do
+        assert_select ".container", 1
+        assert_select ".container.col-24", 0
+        assert_select ".col-24", 1
+        assert_select ".col-12", 2
+        assert_select ".col-12#primary", 1
+        assert_select ".col-12#secondary", 1
+        assert_select ".col-4", 2
+        assert_select ".prepend-4", 1
+        assert_select ".col-24.col-last", 0
+        assert_select ".col-12.col-last", 1
+        assert_select ".col-4.col-last", 1
+        assert_select "hr", 2
+      end
+    end
+
+    should "properly assign classes for generic helpers" do
+      template = %(
+        <% column do %>
+          <% fieldset :hform, :half do %>
+            <% set :one_third do %>text<% end %>
+            <% set :two_thirds, :last do %>more text<% end %>
+          <% end %>
+          <% recordset :half, :last do %>table<% end %>
+        <% end %>
+      )
+
+      show_view template do
+        assert_select "div.col-24" do
+          assert_select "fieldset.hform.col-12" do
+            assert_select "div.col-4", "text"
+            assert_select "div.col-8.col-last", "more text"
+          end
+          assert_select "table.col-12.col-last", "table"
+        end
+      end
+    end
+
+    should "properly assign classes for generic helpers without column wrappers" do
+      template = %(
+        <% fieldset :hform, :half do %>
+          <% set :one_third do %>text<% end %>
+          <% set :two_thirds, :last do %>more text<% end %>
+          <% column do %>
+            <% column :one_third do %>one third<% end %>
+            <% column :two_thirds, :last do %>
+              <% column :half do %>half<% end %>
+              <% column :half, :last do %>last half<% end %>
+            <% end %>
+          <% end %>
+        <% end %>
+        <% column :one_third do %>
+          <% column :one_fourth do %>two wide<% end %>
+          <% column :half do %>four wide<% end %>
+          <% column :one_fourth, :last do %>two more wide<% end %>
+        <% end %>
+        <% recordset :one_sixth, :last do %>table<% end %>
+      )
+
+      show_view template do
+        assert_select "fieldset.hform.col-12" do
+          assert_select "div.col-4", "text"
+          assert_select "div.col-8.col-last", "more text"
+
+          assert_select "div.col-12.col-last" do
+            assert_select "div.col-4", "one third"
+            assert_select "div.col-8.col-last" do
+              assert_select "div.col-4", "half"
+              assert_select "div.col-4.col-last", "last half"
+            end
+          end
+        end
+        assert_select "div.col-8" do
+          assert_select "div.col-2", "two wide"
+          assert_select "div.col-4", "four wide"
+          assert_select "div.col-2.col-last", "two more wide"
+        end
+        assert_select "table.col-4.col-last", "table"
+      end
+    end
+
+    should "properly assign classes for a deeply-nested view" do
+      template = %(
+        <% container :full do %>
+          <% column :half do %>
+            <% fieldset :hform, :half do %>
+              <% set :one_third do %>text<% end %>
+              <% set :two_thirds, :last do %>more text<% end %>
+            <% end %>
+            <% recordset :half, :last do %>table<% end %>
+          <% end %>
+          <% column :one_third do %>one third!<% end %>
+          <% column :one_sixth, :last do %>
+            <% fieldset :vform, :full do %>
+              <% set do %>text<% end %>
+            <% end %>
+          <% end %>
+        <% end %>
+      )
+
+      show_view template do
+        assert_select "div.container.col-24", 1
+        assert_select "div.container" do
+          assert_select "div.col-12" do
+            assert_select "fieldset.hform.col-6" do
+              assert_select "div.col-2", "text"
+              assert_select "div.col-4.col-last", "more text"
+            end
+            assert_select "table.col-6.col-last", "table"
+          end
+
+          assert_select "div.col-8", "one third!"
+
+          assert_select "div.col-4.col-last" do
+            assert_select "fieldset.vform.col-4.col-last" do
+              assert_select "div", "text"
+            end
+          end
+        end
+      end
+    end
+
+    should "properly assign classes when using Blueprint grid" do
+      template = %(
+        <% container do %>
+          <% column do %>
+            <% column :half, :id => "primary" do %>
+              <% column :one_third do %>
+                one third of one half of 24 is 4
+              <% end %>
+              <% column :one_third, :last, prepend_one_third do %>
+                one third of one half of 24 is 4 (but prepended 4 as well)
+              <% end %>
+              <hr/>
+              more text
+            <% end %>
+            <% column :half, :last, :id => "secondary" do %>
+              second column
+            <% end %>
+            <hr/>
+            text
+          <% end %>
+        <% end %>
+      )
+      EaselHelpers::Helpers::GridHelper.blueprint_grid!
+      show_view template do
+        assert_select ".container", 1
+        assert_select ".span-24", 1
+        assert_select ".span-12", 2
+        assert_select ".span-12#primary", 1
+        assert_select ".span-12#secondary", 1
+        assert_select ".span-4", 2
+        assert_select ".prepend-4", 1
+        assert_select ".span-24.last", 0
+        assert_select ".span-12.last", 1
+        assert_select ".span-4.last", 1
+        assert_select "hr", 2
+      end
+      EaselHelpers::Helpers::GridHelper.easel_grid!
+    end
+  end
+
+  context "column" do
+
+    should "allow assigning options hash without having to define a width" do
+      show_view %(
+        <% column :id => "my-custom-id", :class => "content" do %>words<% end %>
+      ) do
+        assert_select "div.col-24.content#my-custom-id", "words"
+      end
+    end
+
+    should "allow explicit column assignment" do
+      show_view %(
+        <% column 6, :sidebar do %>
+          <% column :id => "main" do %>main sidebar<% end %>
+          <% column :half do %>three<% end %>
+          <% column :one_third do %>two<% end %>
+          <% column 1, :last do %>one<% end %>
+        <% end %>
+      ) do
+        assert_select "div.col-6.sidebar" do
+          assert_select "div.col-6.col-last#main", "main sidebar"
+          assert_select "div.col-3", "three"
+          assert_select "div.col-2", "two"
+          assert_select "div.col-1.col-last", "one"
+        end
+      end
+    end
+
+    should "allow tag overriding" do
+      show_view %(<% column :tag => :section do %>content<% end %>) do
+        assert_select "section.col-24:not([tag=section])", "content"
+      end
+    end
+  end
+end

data/test/jquery_helper_test.rb

@@ -0,0 +1,30 @@
+require 'test_helper'
+
+class JqueryHelperTest < EaselHelpers::ViewTestCase
+
+  context "document_ready" do
+
+    setup do
+      @whitespace = '\s+?'
+      @anything =   '(.|\s)+?'
+
+      @anon_function_start_regex  = Regexp.escape "(function($) {"
+      @document_ready_start_regex = Regexp.escape   "$(document).ready(function() {"
+
+      @document_ready_end_regex   = Regexp.escape   "});"
+      @anon_function_end_regex    = Regexp.escape "})(jQuery);"
+    end
+
+    should "properly build the document ready script tag" do
+      show_view %(
+        <% document_ready do %>
+          alert("hello!");
+        <% end %>
+      ) do
+        assert_select "script[type=?]", "text/javascript", /#{@anon_function_start_regex}#{@whitespace}#{@document_ready_start_regex}#{@whitespace}alert#{@anything}#{@document_ready_end_regex}#{@whitespace}#{@anon_function_end_regex}/
+      end
+    end
+
+  end
+
+end

data/test/link_helper_test.rb

@@ -0,0 +1,44 @@
+require 'test_helper'
+
+class LinkHelperTest < EaselHelpers::ViewTestCase
+  context "link_button" do
+
+    should "default with the correct structure" do
+      show_view "<%= link_button 'Link Text', '#' %>" do
+        assert_select "a.btn[href=#]" do
+          assert_select "span", "Link Text"
+        end
+      end
+    end
+
+    should "allow the same assignment as link_to" do
+      show_view "<%= link_button 'Link Text', '#', :class => 'my-button', :id => 'link-text' %>" do
+        assert_select "a.btn.my-button#link-text[href=#]" do
+          assert_select "span", "Link Text"
+        end
+      end
+    end
+
+  end
+
+  context "link_to_email" do
+    should "default with the correct structure" do
+      show_view "<%= link_to_email 'test@example.com' %>" do
+        assert_select "a[href=mailto:test@example.com]", "test@example.com"
+      end
+    end
+
+    should "allow override of link text as the first argument after email" do
+      show_view "<%= link_to_email 'test@example.com', 'Send an email to Test User' %>" do
+        assert_select "a[href=mailto:test@example.com]", "Send an email to Test User"
+      end
+    end
+
+    should "allow the same assignment as link_to" do
+      show_view "<%= link_to_email 'test@example.com', :class => 'test-user-email', :id => 'user_1_email' %>" do
+        assert_select "a.test-user-email#user_1_email[href=mailto:test@example.com]", "test@example.com"
+      end
+    end
+
+  end
+end

data/test/message_helper_test.rb

@@ -0,0 +1,50 @@
+require 'test_helper'
+
+class MessageHelperTest < EaselHelpers::ViewTestCase
+
+  context "messages" do
+
+    should "default with the correct structure" do
+      show_view %(<%= messages(:structure => "Flash message") %>) do
+        assert_select "p.structure.box.single-line", "Flash message"
+      end
+    end
+
+    should "display all flash messages present" do
+      show_view %(<%= messages(:structure => "Flash message", :error => "Warning message") %>) do
+        assert_select "p.structure", "Flash message"
+        assert_select "p.error", "Warning message"
+      end
+    end
+
+    should "not display a flash if it is blank" do
+      show_view %(<%= messages(:structure => "", :error => nil) %>) do
+        assert_select "p.structure", false
+        assert_select "p.error", false
+      end
+    end
+
+    should "filter by the :only option" do
+      show_view %(<%= messages({:structure => "Flash message", :error => "Warning message", :notice => "Notice!"}, {:only => [:structure, :error]}) %>) do
+        assert_select "p.structure", "Flash message"
+        assert_select "p.error", "Warning message"
+        assert_select "p.notice", false
+      end
+    end
+
+    should "filter by the :except option" do
+      show_view %(<%= messages({:structure => "Flash message", :error => "Warning message", :notice => "Notice!"}, {:except => [:structure, :error]}) %>) do
+        assert_select "p.structure", false
+        assert_select "p.error", false
+        assert_select "p.notice", "Notice!"
+      end
+    end
+
+    should "raise an error of :only and :except are both passed" do
+      assert_raise ArgumentError, /conflict/ do
+        show_view %(<%= messages({:structure => "Flash message"}, {:except => [:structure, :error], :only => :structure}) %>)
+      end
+    end
+  end
+
+end

data/test/navigation_helper_test.rb

@@ -0,0 +1,130 @@
+require "test_helper"
+
+class NavigationHelperTest < ActiveSupport::TestCase
+  include EaselHelpers::Helpers::NavigationHelper
+
+  context "tab" do
+    should "parse tab options properly" do
+      expects(:parse_tab_options).with("test", {:b => 2}).returns({})
+      stubs(:link_to)
+      stubs(:content_tag)
+      stubs(:clean_css_classes)
+      tab("test", "/", {:a => 1}, {:b => 2})
+    end
+
+    should "call link_to properly" do
+      stubs(:content_tag)
+      stubs(:clean_css_classes)
+      stubs(:parse_tab_options).returns({})
+      expects(:link_to).with("test", "/path", {:a => 1, :b => 2})
+      tab("test", "/path", {:a => 1, :b => 2})
+    end
+
+    context "compiling li classes" do
+      setup do
+        @result_options = { :active => "1",
+                            :comparison => "2",
+                            :compare => false,
+                            :li_classes => "one two three" }
+        stubs(:link_to).returns("link_to")
+        stubs(:content_tag)
+      end
+
+      should "properly use classes passed in the options" do
+        stubs(:parse_tab_options).returns(@result_options)
+        expects(:clean_css_classes).with(["one two three", nil])
+        tab("test", "/")
+      end
+
+      should "properly compare information" do
+        @result_options[:comparison] = "1"
+        stubs(:parse_tab_options).returns(@result_options)
+        expects(:clean_css_classes).with(["one two three", "active"])
+        tab("test", "/")
+      end
+
+      should "properly use compare value" do
+        @result_options[:compare] = true
+        stubs(:parse_tab_options).returns(@result_options)
+        expects(:clean_css_classes).with(["one two three", "active"])
+        tab("test", "/")
+      end
+
+      should "not assign class if css_classes is blank" do
+        @result_options[:li_classes] = nil
+        stubs(:parse_tab_options).returns({})
+        stubs(:clean_css_classes).returns("")
+        expects(:content_tag).with(:li, "link_to", {})
+        tab("test", "/")
+      end
+    end
+
+    context "parse_tab_options" do
+      context "calculating :active" do
+        setup do
+          stubs(:controller).returns(stub_everything)
+        end
+
+        should "be based on option" do
+          result = send(:parse_tab_options, "name", {:active => "words"})
+          assert_equal "words", result[:active]
+        end
+
+        should "be based on name" do
+          name = tableized_name = stub
+          name.expects(:gsub).with(/\s/, '').returns(tableized_name)
+          tableized_name.expects(:tableize).returns("name")
+
+          result = send(:parse_tab_options, name, {})
+          assert_equal "name", result[:active]
+        end
+      end
+
+      context "calculating :comparison" do
+        should "be based on option" do
+          result = send(:parse_tab_options, "name", {:active_compare => "active"})
+          assert_equal "active", result[:comparison]
+        end
+
+        should "be based on controller name" do
+          controller = stub(:controller_name => "controller-name")
+          expects(:controller).returns(controller)
+          result = send(:parse_tab_options, "name", {})
+          assert_equal "controller-name", result[:comparison]
+        end
+      end
+
+      context "calculating :compare" do
+        setup do
+          stubs(:controller).returns(stub_everything)
+        end
+
+        should "be based on option" do
+          result = send(:parse_tab_options, "name", {:compare => true})
+          assert_equal true, result[:compare]
+        end
+
+        should "have a default value" do
+          result = send(:parse_tab_options, "name")
+          assert_equal false, result[:compare]
+        end
+      end
+
+      context "calculating :li_classes" do
+        setup do
+          stubs(:controller).returns(stub_everything)
+        end
+
+        should "be based on option" do
+          result = send(:parse_tab_options, "name", {:class => "custom classes"})
+          assert_equal "custom classes", result[:li_classes]
+        end
+
+        should "be nil if no option is passed" do
+          result = send(:parse_tab_options, "name")
+          assert_nil result[:li_classes]
+        end
+      end
+    end
+  end
+end