helperful 0.5.2

data/lib/helperful/version.rb

@@ -0,0 +1,32 @@
+#
+# = Helperful
+#
+# A collection of useful Rails helpers.
+#
+#
+# Category::    Rails
+# Package::     Helperful
+# Author::      Simone Carletti <weppos@weppos.net>
+# Copyright::   2008-2009 The Authors
+# License::     MIT License
+#
+#--
+#
+#++
+
+
+module Helperful
+
+  module Version
+    MAJOR = 0
+    MINOR = 5
+    TINY  = 2
+
+    STRING = [MAJOR, MINOR, TINY].join('.')
+  end
+
+  VERSION         = Version::STRING
+  STATUS          = 'alpha'
+  BUILD           = nil
+
+end

data/rails/init.rb

@@ -0,0 +1,5 @@
+require 'helperful'
+
+ActionController::Base.extend Helperful::ControllerMixin
+
+RAILS_DEFAULT_LOGGER.info("** Helperful: initialized properly") if defined?(RAILS_DEFAULT_LOGGER)

data/tasks/helperful_tasks.rake

@@ -0,0 +1,4 @@
+# desc "Explaining what the task does"
+# task :helperful do
+#   # Task goes here
+# end

data/test/affiliations_helper_test.rb

@@ -0,0 +1,12 @@
+require 'test_helper'
+
+class AffiliationsHelperTest < ActionView::TestCase
+  tests Helperful::AffiliationsHelper
+  
+  def test_tradedoubler_verification_tag
+    assert_equal('<!-- TradeDoubler site verification 112233 -->', tradedoubler_verification_tag('112233'))
+    assert_equal('<!-- TradeDoubler site verification 112233 -->', tradedoubler_verification_tag(112233))
+    assert_equal('<!-- TradeDoubler site verification  -->', tradedoubler_verification_tag(nil))
+  end
+  
+end

data/test/asset_tag_helper_test.rb

@@ -0,0 +1,77 @@
+require 'test_helper'
+
+class AssetTagHelperTest < ActionView::TestCase
+  tests Helperful::AssetTagHelper
+
+  def setup
+    ActionController::Base.perform_caching = false
+    ActionController::Base.asset_host = nil
+    ENV.delete('RAILS_ASSET_ID')
+    
+    @controller = Class.new do
+      attr_accessor :request
+      def url_for(*args)
+        case arg = args.first
+        when String
+          arg
+        when Hash
+          "http://www.example.com?#{arg.to_param}"
+        else
+          "http://www.example.com"
+        end
+      end
+    end.new
+    
+    @request = Class.new do
+      def protocol() 'http://' end
+      def ssl?() false end
+      def host_with_port() 'localhost' end
+    end.new
+    
+    @controller.request = @request
+  end
+  
+  
+  CanonicalToTag = {
+    %(canonical_link_tag) => %(<link href="http://www.example.com?only_path=false" rel="canonical" />),
+    %(canonical_link_tag(:action => "show")) => %(<link href="http://www.example.com?action=show&amp;only_path=false" rel="canonical" />),
+    %(canonical_link_tag("http://localhost/show")) => %(<link href="http://localhost/show" rel="canonical" />),
+  }
+  
+  test "canonical_link_tag" do
+    CanonicalToTag.each do |method, tag|
+      assert_dom_equal(tag, eval(method))
+    end
+  end
+  
+  
+  JavascriptToTag = {
+    %(javascript) => %(javascript_include_tag),
+    %(javascript(["foo", "bar"])) => %(javascript_include_tag(["foo", "bar"])),
+    %(javascript("foo", "bar")) => %(javascript_include_tag("foo", "bar")),
+    %(javascript("foo", "bar", :cache => true)) => %(javascript_include_tag("foo", "bar", :cache => true)),
+  }
+  
+  test "javascript" do
+    JavascriptToTag.each do |method, content|
+      expects(:content_for).with(:head, eval(content))
+      eval(method)
+    end
+  end
+  
+  
+  StylesheetToTag = {
+    %(stylesheet) => %(stylesheet_link_tag),
+    %(stylesheet(["foo", "bar"])) => %(stylesheet_link_tag(["foo", "bar"])),
+    %(stylesheet("foo", "bar")) => %(stylesheet_link_tag("foo", "bar")),
+    %(stylesheet("foo", "bar", :cache => true)) => %(stylesheet_link_tag("foo", "bar", :cache => true)),
+  }
+  
+  test "stylesheet" do
+    StylesheetToTag.each do |method, content|
+      expects(:content_for).with(:head, eval(content))
+      eval(method)
+    end
+  end
+  
+end

data/test/content_helper_test.rb

@@ -0,0 +1,52 @@
+require 'test_helper'
+
+class ContentController < ActionController::Base
+  def self.controller_name; "content"; end
+  def self.controller_path; "content"; end
+  
+  helperful "content"
+  
+  def has_content
+    render :layout => "has_content"
+  end
+
+  def has_content_is_called_alone
+    render :layout => false
+  end
+
+  def rescue_action(e) raise end
+end
+
+ContentController.view_paths = [ File.dirname(__FILE__) + "/fixtures/" ]
+
+
+class ContentTest < ActionController::TestCase
+
+  # Compatibility workaround for Rails ~> 2.2.0
+  tests ContentController
+
+  def setup
+    @controller = ContentController.new
+    @request    = ActionController::TestRequest.new
+    @response   = ActionController::TestResponse.new
+
+    @request.host = "test.host"
+  end
+
+  def test_has_content
+    get :has_content
+    assert_equal %Q{
+`one' has content: this is :one for :one\n
+`two' has content: this is 'two' for 'two'\n
+\n
+`four' has content: this is 'four' for :four\n
+`five' has content: this is 'five' for :five\n}, @response.body
+  end
+
+  def test_has_content_is_called_alone
+    get :has_content_is_called_alone
+    assert_response :success
+    assert_equal('bar', @response.body)
+  end
+    
+end

data/test/fixtures/content/has_content.html.erb

@@ -0,0 +1,4 @@
+<% content_for :one,    "this is :one for :one" -%>
+<% content_for 'two',   "this is 'two' for 'two'" -%>
+<% content_for 'four',  "this is 'four' for :four" -%>
+<% content_for 'five' do %>this is 'five' for :five<% end %>

data/test/fixtures/content/has_content_is_called_alone.html.erb

@@ -0,0 +1 @@
+<% if  has_content? :foo %>foo<% end %><% if !has_content? :bar %>bar<% end %>

data/test/fixtures/layouts/has_content.html.erb

@@ -0,0 +1,3 @@
+<% for name in [:one, 'two', :three, :four, :five] %>
+<% if has_content? name %>`<%= name %>' has content: <%= yield name %><% end %>
+<% end %>

data/test/helperful_test.rb

@@ -0,0 +1,55 @@
+require 'test_helper'
+
+class HelperfulController < ActionController::Base
+end
+
+%w(First Second Third).each do |name|
+  class_eval <<-RUBY
+    module Helperful::#{name}Helper
+    end
+  RUBY
+end
+
+
+class HelperfulTest < Test::Unit::TestCase
+  
+  def setup
+    @controller = HelperfulController
+  end
+  
+  def test_helperful_should_delegate_module
+    @controller.expects(:helper).with(Helperful::FirstHelper)
+    @controller.helperful(Helperful::FirstHelper)
+  end
+  
+  def test_helperful_should_delegate_modules
+    @controller.expects(:helper).with(Helperful::FirstHelper)
+    @controller.expects(:helper).with(Helperful::SecondHelper)
+    @controller.helperful(Helperful::FirstHelper, Helperful::SecondHelper)
+  end
+  
+  def test_helperful_should_prepend_namespace_and_delegate_string_symbol
+    @controller.expects(:helper).with('helperful/first')
+    @controller.helperful('first')
+
+    @controller.expects(:helper).with('helperful/first')
+    @controller.helperful(:first)
+  end
+  
+  def test_helperful_should_prepend_namespace_and_delegate_strings_symbols
+    @controller.expects(:helper).with('helperful/first')
+    @controller.helperful('first')
+
+    @controller.expects(:helper).with('helperful/first')
+    @controller.helperful(:first)
+
+    @controller.expects(:helper).with('helperful/first')
+    @controller.expects(:helper).with('helperful/second')
+    @controller.helperful('first', 'second')
+
+    @controller.expects(:helper).with('helperful/first')
+    @controller.expects(:helper).with('helperful/second')
+    @controller.helperful(:first, :second)
+  end
+  
+end

data/test/javascript_helper_test.rb

@@ -0,0 +1,91 @@
+require 'test_helper'
+
+class JavascriptHelperTest < ActionView::TestCase
+  tests Helperful::JavascriptHelper
+
+  attr_accessor :output_buffer
+
+  def setup
+    @content_for_name = nil
+  end
+
+  def test_javascript_content_for
+    javascript_content_for(:name, "alert('hello')")
+
+    assert_dom_equal "<script type=\"text/javascript\">\n//<![CDATA[\nalert('hello')\n//]]>\n</script>",
+      @content_for_name
+  end
+
+  def test_javascript_content_for_with_block_in_erb
+    __in_erb_template = ''
+    javascript_content_for(:name) { concat "alert('hello')" }
+    
+    assert_dom_equal "<script type=\"text/javascript\">\n//<![CDATA[\nalert('hello')\n//]]>\n</script>",
+      @content_for_name
+  end
+
+  def test_javascript_content_for_with_block_out_of_erb
+    javascript_content_for(:name) { "alert('hello')" }
+    
+    assert_dom_equal "<script type=\"text/javascript\">\n//<![CDATA[\nalert('hello')\n//]]>\n</script>",
+      @content_for_name
+  end
+
+  def test_javascript_content_for_with_options
+    javascript_content_for(:name, "alert('hello')", :id => "the_js_tag")
+
+    assert_dom_equal "<script id=\"the_js_tag\" type=\"text/javascript\">\n//<![CDATA[\nalert('hello')\n//]]>\n</script>",
+      @content_for_name
+  end
+
+  def test_javascript_content_for_with_options_and_block_in_erb
+    __in_erb_template = ''
+    javascript_content_for(:name, :id => "the_js_tag") { concat "alert('hello')" }
+
+    assert_dom_equal "<script id=\"the_js_tag\" type=\"text/javascript\">\n//<![CDATA[\nalert('hello')\n//]]>\n</script>",
+      @content_for_name
+  end
+
+  def test_javascript_content_for_with_options_and_block_out_of_erb
+    javascript_content_for(:name, :id => "the_js_tag") { "alert('hello')" }
+    
+    assert_dom_equal "<script id=\"the_js_tag\" type=\"text/javascript\">\n//<![CDATA[\nalert('hello')\n//]]>\n</script>",
+      @content_for_name
+  end
+  
+  def test_javascript_content_for_with_subsequent_calls
+    javascript_content_for(:name, "alert('hello')")
+    javascript_content_for(:name, "alert('world')")
+
+    expected  = "<script type=\"text/javascript\">\n//<![CDATA[\nalert('hello')\n//]]>\n</script>"
+    expected += "<script type=\"text/javascript\">\n//<![CDATA[\nalert('world')\n//]]>\n</script>"
+
+    assert_dom_equal expected,
+      @content_for_name
+  end
+
+  def test_javascript_content_for_with_subsequent_calls_and_block_in_erb
+    __in_erb_template = ''
+
+    javascript_content_for(:name) { concat "alert('hello')" }
+    javascript_content_for(:name) { concat "alert('world')" }
+
+    expected  = "<script type=\"text/javascript\">\n//<![CDATA[\nalert('hello')\n//]]>\n</script>"
+    expected += "<script type=\"text/javascript\">\n//<![CDATA[\nalert('world')\n//]]>\n</script>"
+
+    assert_dom_equal expected,
+      @content_for_name
+  end
+
+  def test_javascript_content_for_with_subsequent_calls_and_block_out_of_erb
+    javascript_content_for(:name) { "alert('hello')" }
+    javascript_content_for(:name) { "alert('world')" }
+
+    expected  = "<script type=\"text/javascript\">\n//<![CDATA[\nalert('hello')\n//]]>\n</script>"
+    expected += "<script type=\"text/javascript\">\n//<![CDATA[\nalert('world')\n//]]>\n</script>"
+
+    assert_dom_equal expected,
+      @content_for_name
+  end
+
+end

data/test/test_helper.rb

@@ -0,0 +1,47 @@
+#
+# = Helperful
+#
+# A collection of useful Rails helpers.
+#
+#
+# Category::    Rails
+# Package::     Helperful
+# Author::      Simone Carletti <weppos@weppos.net>
+# Copyright::   2008-2009 The Authors
+# License::     MIT License
+#
+#--
+#
+#++
+
+
+require 'rubygems'
+gem     'rails', '~>2.3.0'
+gem     'mocha', '0.9.7'
+
+# Remember! Due to some Mocha internal changes,
+# Rails 2.2.x requires Mocha 0.9.5 and
+# Rails 2.3.x requires Mocha 0.9.7 
+# gem     'rails', '2.2.2'
+# gem     'mocha', '0.9.5'
+
+require 'mocha'
+require 'test/unit'
+require 'active_support'
+require 'action_controller'
+require 'action_controller/cgi_ext'
+require 'action_controller/test_process'
+require 'action_view/test_case'
+
+$:.unshift File.dirname(__FILE__) + '/../lib'
+require    File.dirname(__FILE__) + '/../init.rb'
+
+RAILS_ROOT = '.'    unless defined? RAILS_ROOT
+RAILS_ENV  = 'test' unless defined? RAILS_ENV
+
+ActionController::Base.logger = nil
+ActionController::Routing::Routes.reload rescue nil
+
+
+# Unit tests for Helpers are based on unit tests created and developed by Rails core team.
+# See action_pack/test/abstract_unit for more details.

data/test/title_helper_test.rb

@@ -0,0 +1,69 @@
+require 'test_helper'
+
+class HelperfulTitleHelperTest < ActionView::TestCase
+  tests Helperful::TitleHelper
+
+  def setup
+    reset!
+  end
+
+  def test_title_should_accepts_zero_or_more_params
+    assert_nothing_raised { title }
+    assert_nothing_raised { title('One') }
+    assert_nothing_raised { title('One', 'Two', 'Three') }
+  end
+
+  def test_title_should_return_content
+    assert_equal('', title)
+    assert_equal('One', title('One'))
+  end
+
+  def test_title_should_return_empty_string_if_empty
+    assert_equal('', title)
+  end
+
+  def test_title_should_store_content
+    assert_equal('', title)
+    assert_equal('One', title('One'))
+    assert_equal('One', title)
+  end
+
+  def test_title_should_join_content
+    assert_equal('', title)
+    assert_equal('One', title('One'))
+    assert_equal('One - Two', title('Two'))
+    assert_equal('One - Two - Three - Four', title('Three', 'Four'))
+  end
+
+  def test_title_should_join_content_with_separator
+    assert_equal('One - Two', title('One', 'Two'))
+    assert_equal('One | Two', title(:separator => ' | '))
+    assert_equal('One x Two x Three', title('Three', :separator => ' x '))
+  end
+
+  def test_title_should_append_headline_to_content
+    assert_equal('One - Two', title('One', 'Two'))
+    assert_equal('One - Two - Cool!', title(:headline => 'Cool!'))
+    assert_equal('One - Two - Three - Yeah!', title('Three', :headline => 'Yeah!'))
+  end
+
+  def test_title_should_append_site_to_content
+    assert_equal('One - Two', title('One', 'Two'))
+    assert_equal('One - Two - Cool!', title(:site => 'Cool!'))
+    assert_equal('One - Two - Three - Yeah!', title('Three', :site => 'Yeah!'))
+  end
+
+  def test_title_should_append_site_then_headline
+    assert_equal('One - Two', title('One', 'Two'))
+    assert_equal('One - Two - Cool!', title(:site => 'Cool!'))
+    assert_equal('One - Two - Cool! - Yeah!', title(:headline => 'Yeah!'))
+  end
+
+
+  protected
+
+    def reset!
+      title(nil)
+    end
+
+end