weppos-helperful 0.2.0

data/CHANGELOG.rdoc

@@ -0,0 +1,22 @@
+= Changelog
+
+== master
+
+* ADDED: Added Helperful::ContentHelper module (subsequently renamed to Helperful::ContentHelper) with #sidebar helper for passing content_for :sidebar to the layout. Even if this is a really simple method, this method adds a bit of semantic meaning to common application usage of content_for for created sidebars.
+
+* ADDED: Added HelperfulAffiliationsHelper module (subsequently renamed to Helperful::AffiliationsHelper).
+
+* ADDED: Added HelperfulAffiliationsHelper#tradedoubler_verification_tag helper for generating Tradedoubler verifications tags (subsequently renamed to Helperful::AffiliationsHelper).
+
+* ADDED: Added #helperful method as shortcut for including helper modules from the Helperful namespace.
+
+* ADDED: Packaged library as a GEM.
+
+* CHANGED: Renamed TitleHelper to HelperfulTitleHelper to prevent conflicts with other common helpers (subsequently renamed to Helperful::TitleHelper).
+
+* CHANGED: Renamed all helper modules from HelperfulHelperName to Helperful::HelperName.
+
+
+== Release 0.1.0
+
+* ADDED: Imported TitleHelper from Gist.

data/LICENSE.rdoc

@@ -0,0 +1,24 @@
+= License
+
+(The MIT License)
+
+Copyright (c) 2008-2009 Simone Carletti <weppos@weppos.net>
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.rdoc

@@ -0,0 +1,171 @@
+= Helperful
+
+Helperful aims to be a collection of useful and reusable Rails helpers.
+
+*WARNING*: This library has not been released yet. This package seems stable, but should be considered a development release. You should not use it in production.
+Changes to specifications may occur at any time and without notice. For the full list of changes look at the CHANGELOG file.
+
+
+== Getting Started
+
+Helper methods are grouped into different files according to their scope.
+
+Before using an helper method you should include the helper file in your Rails application,
+as you would expected to do for a standard Rails helper.
+All helpers belongs to the Helperful namespace to prevent conflicts with default Rails helpers.
+Don't forget to add the namespace when including an helper from your controller.
+
+  class MyController < ApplicationController
+
+    # include the title_helper
+    helper 'helperful/title'
+
+    # include the title_helper passing the qualified the module name
+    helper Helperful::TitleHelper
+
+  end
+
+
+Moreover, the <tt>Helperful</tt> library provides a helpful method called <tt>helperful</tt>. 
+It aliases the standard Rails <tt>ActionController::Base#helper</tt> method with the exception that it automatically prepends the <tt>helperful</tt> namespace when necessary.
+
+  class MyController < ApplicationController
+
+    # include the title_helper
+    helperful :title
+
+    # include the title_helper passing the qualified the module name
+    helperful Helperful::TitleHelper
+
+  end
+
+
+The following lines are equivalent:
+
+  helper    'helperful/title'
+  helper    :'helperful/title'
+  helper    Helperful::TitleHelper
+  helperful 'title'
+  helperful :title
+  helperful Helperful::TitleHelper
+
+
+The <tt>helperful</tt> methods accepts any parameter accepted by the original <tt>helper</tt> method.
+  
+  helper    'helperful/title', 'helperful/affiliations'
+  helperful :title, :affiliations
+
+
+See the Rails documentation for <tt>ActionController::Base#helper</tt> method
+for more details about how to include an helper into a Rails application.
+
+Once included, all helper methods are available in the View.
+
+  <html>
+    <title><%= title 'This is a title' %></title>
+    <body>
+      <%= yield %>
+    </body>
+  </html>
+
+
+== Helpers
+
+This is a short description of all available helpers.
+Please refer to the documentation available at the beginning of any helper file for further details.
+
+=== Affiliations Helper
+
+Provides a set of helpers for working with online affiliations.
+
+The <tt>tradedoubler_verification_tag</tt> helper method returns the site verification tag required by {Tradedoubler}[http://www.tradedoubler.com/] to verify the publisher account ownership.
+
+  # In your template
+  <html>
+    <head>
+      <%= tradedoubler_verification_tag('00112233') %>
+    </head>
+    <body>
+      This is your page content.
+    </body>
+  </html>
+  
+  # Will produce the following output.
+  <html>
+    <head>
+      <%= tradedoubler_verification_tag('00112233') %>
+    </head>
+    <body>
+      <!-- TradeDoubler site verification 00112233 -->
+    </body>
+  </html>
+
+=== Content Helper
+
+Provides a set of helpers for capturing and working with your page content in a more effective way.
+
+The <tt>sidebar</tt> helper method is a syntactic sugar addition to store content for your website sidebars.
+
+  <% sidebar do %>
+    <div>This is a sidebar module.</div>
+  <% end %>
+  <% sidebar do %>
+    <div>This is an other sidebar module.</div>
+  <% end %>
+  
+  <%= yield :sidebar # Produces the following output %>
+  <div>This is an other sidebar module.</div>
+  <div>This is a sidebar module.</div>
+
+The <tt>has_content?</tt> helper is a natural fulfillment for the original <tt>content_for</tt> helper.
+
+  <% content_for :foo do %>
+    <div>This is a foo content.</div>
+  <% end %>
+  
+  <% has_content? :foo  # => true %>
+  <% has_content? "foo" # => true %>
+
+=== Title Helper
+
+Provides an helper for managing page title in Rails views and layouts.
+
+  # Include the helper in your controller.
+  # You might want to include it in ApplicationController to make it available
+  # always and everywhere in your templates.
+  class ApplicationController < ActionController::Base
+    helperful :title
+  end
+
+  # Now you can use set a title in your action
+  # Example. index.html.rb
+  <h1><%= title 'This is a title' %></h1>
+
+  # And print the title with a :site decorator in your layout.
+  <html>
+    <head>
+      <title><%= title :site => 'My Cool Site!' %></title>
+    </head>
+    <body>
+      <%= yield %>
+    </body>
+  </html>
+
+Originally available at http://gist.github.com/3840.
+
+
+== Credits
+
+Author:: {Simone Carletti}[http://www.simonecarletti.com/] <weppos@weppos.net>
+
+
+== Resources
+
+* {Homepage}[http://code.simonecarletti.com/helperful]
+* {GitHub}[http://github.com/weppos/helperful]
+
+
+== License
+
+Copyright (c) 2008-2009 Simone Carletti, Helperful is released under the MIT license. 
+

data/Rakefile

@@ -0,0 +1,52 @@
+require 'rubygems'
+require 'rake'
+require 'echoe'
+
+$:.unshift(File.dirname(__FILE__) + "/lib")
+require 'helperful'
+
+
+PKG_NAME    = ENV['PKG_NAME']    || Helperful::GEM
+PKG_VERSION = ENV['PKG_VERSION'] || Helperful::VERSION
+PKG_SUMMARY = "A collection of useful Rails helpers."
+PKG_FILES   = FileList.new("{lib,rails,tasks,test}/**/*") do |files|
+  files.include %w(*.{rdoc,rb})
+  files.include %w(Rakefile)
+end
+RUBYFORGE_PROJECT = nil
+
+if ENV['SNAPSHOT'].to_i == 1
+  PKG_VERSION << "." << Time.now.utc.strftime("%Y%m%d%H%M%S")
+end
+ 
+ 
+Echoe.new(PKG_NAME, PKG_VERSION) do |p|
+  p.author        = "Simone Carletti"
+  p.email         = "weppos@weppos.net"
+  p.summary       = PKG_SUMMARY
+  p.description   = <<-EOD
+    Helperful aims to be a collection of useful and reusable Rails helpers.
+  EOD
+  p.url           = "http://code.simonecarletti.com/helperful"
+  p.project       = RUBYFORGE_PROJECT
+
+  p.need_zip      = true
+  p.rcov_options  = ["--main << README.rdoc -x Rakefile -x mocha -x rcov"]
+  p.rdoc_pattern  = /^(lib|CHANGELOG.rdoc|README.rdoc|LICENSE.rdoc)/
+
+  p.development_dependencies += ["rake  >=0.8",
+                                 "echoe >=3.1",
+                                 "mocha >=0.9"]
+end
+
+
+begin
+  require 'code_statistics'
+  desc "Show library's code statistics"
+  task :stats do
+    CodeStatistics.new(["Helperful", "lib"],
+                       ["Tests", "test"]).to_s
+  end
+rescue LoadError
+  puts "CodeStatistics (Rails) is not available"
+end

data/helperful.gemspec

@@ -0,0 +1,40 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{helperful}
+  s.version = "0.2.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 1.2") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Simone Carletti"]
+  s.date = %q{2009-02-25}
+  s.description = %q{Helperful aims to be a collection of useful and reusable Rails helpers.}
+  s.email = %q{weppos@weppos.net}
+  s.extra_rdoc_files = ["CHANGELOG.rdoc", "lib/helperful/affiliations_helper.rb", "lib/helperful/content_helper.rb", "lib/helperful/deprecations.rb", "lib/helperful/title_helper.rb", "lib/helperful/version.rb", "lib/helperful.rb", "LICENSE.rdoc", "README.rdoc"]
+  s.files = ["CHANGELOG.rdoc", "init.rb", "install.rb", "lib/helperful/affiliations_helper.rb", "lib/helperful/content_helper.rb", "lib/helperful/deprecations.rb", "lib/helperful/title_helper.rb", "lib/helperful/version.rb", "lib/helperful.rb", "LICENSE.rdoc", "rails/init.rb", "Rakefile", "README.rdoc", "tasks/helperful_tasks.rake", "test/affiliations_helper_test.rb", "test/content_helper_test.rb", "test/fixtures/content/has_content.html.erb", "test/fixtures/content/sidebar.html.erb", "test/fixtures/content/sidebar_concatenate.html.erb", "test/fixtures/layouts/has_content.html.erb", "test/fixtures/layouts/sidebar.html.erb", "test/helperful_test.rb", "test/test_helper.rb", "test/title_helper_test.rb", "uninstall.rb", "Manifest", "helperful.gemspec"]
+  s.has_rdoc = true
+  s.homepage = %q{http://code.simonecarletti.com/helperful}
+  s.rdoc_options = ["--line-numbers", "--inline-source", "--title", "Helperful", "--main", "README.rdoc"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.1}
+  s.summary = %q{A collection of useful Rails helpers.}
+  s.test_files = ["test/affiliations_helper_test.rb", "test/content_helper_test.rb", "test/helperful_test.rb", "test/test_helper.rb", "test/title_helper_test.rb"]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 2
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+      s.add_development_dependency(%q<rake>, [">= 0.8"])
+      s.add_development_dependency(%q<echoe>, [">= 3.1"])
+      s.add_development_dependency(%q<mocha>, [">= 0.9"])
+    else
+      s.add_dependency(%q<rake>, [">= 0.8"])
+      s.add_dependency(%q<echoe>, [">= 3.1"])
+      s.add_dependency(%q<mocha>, [">= 0.9"])
+    end
+  else
+    s.add_dependency(%q<rake>, [">= 0.8"])
+    s.add_dependency(%q<echoe>, [">= 3.1"])
+    s.add_dependency(%q<mocha>, [">= 0.9"])
+  end
+end

data/init.rb

@@ -0,0 +1 @@
+require File.join(File.dirname(__FILE__), 'rails', 'init')

data/install.rb

@@ -0,0 +1 @@
+# Install hook code here

data/lib/helperful/affiliations_helper.rb

@@ -0,0 +1,44 @@
+#
+# = 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
+  
+  #
+  # = Affiliations Helper
+  # 
+  # Provides a set of helpers for working with online affiliations.
+  #
+  module AffiliationsHelper
+  
+    # 
+    # Returns the tradedoubler site verification tag for +publisher_id+.
+    # 
+    #   tradedoubler_verification_tag('123456')
+    #   # => <!-- TradeDoubler site verification 123456 -->
+    #   
+    #   tradedoubler_verification_tag(123456)
+    #   # => <!-- TradeDoubler site verification 123456 -->
+    #   
+    #   tradedoubler_verification_tag(nil)
+    #   # => <!-- TradeDoubler site verification  -->
+    #
+    def tradedoubler_verification_tag(publisher_id)
+      "<!-- TradeDoubler site verification #{publisher_id.to_s} -->"
+    end
+  
+  end
+end

data/lib/helperful/content_helper.rb

@@ -0,0 +1,125 @@
+#
+# = 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
+  
+  # 
+  # = Content Helper
+  # 
+  # Provides a set of helpers for capturing and working with your page content
+  # in a more effective way.
+  # 
+  # ==== Requires
+  # 
+  # The following requirements are mandatory for this module.
+  # Including this helper will automatically include them unless already included.
+  # 
+  # * ActionView::Helpers::CaptureHelper
+  #
+  module ContentHelper
+    
+    def self.included(base)
+      base.class_eval do
+        base.included_modules.include?(ActionView::Helpers::CaptureHelper) || include(ActionView::Helpers::CaptureHelper)
+        alias_method_chain :content_for, :has
+      end
+    end
+    
+    # 
+    # Evaluates the content of <tt>block</tt> and stores the result as <tt>content_for :sidebar</tt>.
+    # 
+    # Because <tt>content_for</tt> concatenates the block, you can call <tt>sidebar</tt> multiple time
+    # and yield all the final content once.
+    # 
+    # See <tt>ActionView::Helpers::CaptureHelper#content_for</tt> for the full API documentation.
+    # 
+    # ==== Examples
+    # 
+    #   <% sidebar do %>
+    #     <p>Sidebar</p>
+    #   <% end %>
+    #   
+    #   <%= yield :sidebar %>
+    #   # => <p>Sidebar</p>
+    # 
+    def sidebar(&block)
+      content_for :sidebar, &block
+    end
+    
+    #
+    # Returns <tt>true</tt> if <tt>name</tt> has any content,
+    # in other workds if content_for(name) has ever been called.
+    # 
+    # ==== Important
+    # 
+    # Some important details to keep in mind.
+    # 
+    # Due to the way <tt>content_for</tt> stores data, it doesn't matter
+    # whether name is a Symbol or a String.
+    # They are treated in the same way. The following calls are equivalent.
+    # 
+    #   has_content? :foo   # => true
+    #   has_content? "foo"  # => true
+    # 
+    # This method doesn't make any difference between an empty, 
+    # blank or nil content. It always returns <tt>true</tt> if
+    # <tt>content_for</tt> has been called with <tt>name</tt>,
+    # it doesn't matter which content is stored.
+    # A call to <tt>has_content?</tt> will always return true
+    # in any of the following cases:
+    # 
+    #   content_for :name, nil
+    #   content_for :name, ''
+    #   content_for :name, []
+    #   content_for :name, 'A real content'
+    #   content_for :name do
+    #     "nothing here"
+    #   end
+    #
+    def has_content?(name)
+      @has_content.key?(name.to_s)
+    end
+    
+    # Flags +name+ to ensure <tt>has_content?</tt> will work as expected.
+    # You would probably never call this method directly.
+    # In fact, you are encouraged to not do so.
+    def has_content!(name) # :nodoc:
+      @has_content ||= {}
+      @has_content[name.to_s] = true
+    end
+    
+    #
+    # Despite its name, this method is a transparent replacement for
+    # the original <tt>content_for</tt> Rails helper.
+    # 
+    # It forwards any request to the original Rails helper,
+    # but before it keep tracks of every request to ensure <tt>has_content?</tt>
+    # will work as expected.
+    # 
+    # == Behind this original name
+    # 
+    # For those of you interested in, this name arises from the need 
+    # to chain it with <tt>alias_method_chain</tt>, following
+    # Rails best practice for extending original core methods.
+    #
+    def content_for_with_has(*args, &block) # :nodoc:
+      has_content!(args.first)
+      content_for_without_has(*args, &block)
+    end
+  
+  end
+end

data/lib/helperful/deprecations.rb

@@ -0,0 +1,26 @@
+#
+# = 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
+#
+#--
+#
+#++
+
+
+unless defined?(TitleHelper)
+  module TitleHelper
+    def self.included(base)
+      ActiveSupport::Deprecation.warn("TitleHelper is deprecated and will be removed in a future version. " +
+                                      "Please include Helperful::TitleHelper instead.", caller)
+      base.send :include, Helperful::TitleHelper
+    end
+  end
+end

data/lib/helperful/title_helper.rb

@@ -0,0 +1,79 @@
+#
+# = 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
+  
+  #
+  # = Title Helper
+  #
+  # This module provides an helper for managing page title in Rails views and layouts.
+  #
+  module TitleHelper
+
+    #
+    # = Title Helper
+    #
+    # This helper provides both input and output capabilities
+    # for managing page title in Rails views and layouts.
+    #
+    # When called with +args+, it stores all args for later retrieval.
+    # Additionally, it always return a formatted title so that 
+    # it can be easily called without arguments to display the full page title.
+    #
+    # You can pass some additional options to customize the behavior of the returned string.
+    # The following options are supported:
+    #
+    # :separator::
+    #   the separator used to join all title elements, by default a dash.
+    #
+    # :site::
+    #   the name of the site to be appended to page title.
+    #
+    # :headline::
+    #   website headline to be appended to page title, after any element.
+    #
+    # ==== Examples
+    #
+    #   # in a template set the title of the page
+    #   <h1><%= title "Latest news" %></h1>
+    #   # => <h1>Latest news</h1>
+    #
+    #   # in the layout print the title of the page
+    #   # with the name of the site
+    #   <title><%= title :site => 'My Site' %></title>
+    #   # => <title>Latest news | My Site</title>
+    #
+    def title(*args)
+      @helperful_title ||= []
+      @helperful_title_options ||= {
+        :separator => ' - ',
+        :headline  => nil,
+        :site      => nil,
+      }
+      options = args.extract_options!
+
+      @helperful_title += args
+      @helperful_title_options.merge!(options)
+
+      t =  @helperful_title.clone
+      t << @helperful_title_options[:site]
+      t << @helperful_title_options[:headline]
+      t.compact.join(@helperful_title_options[:separator])
+    end
+
+  end
+end

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 = 2
+    TINY  = 0
+
+    STRING = [MAJOR, MINOR, TINY].join('.')
+  end
+
+  VERSION         = Version::STRING
+  STATUS          = 'alpha'
+  BUILD           = ''.match(/(\d+)/).to_a.first
+
+end

data/lib/helperful.rb

@@ -0,0 +1,46 @@
+#
+# = 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
+#
+#--
+#
+#++
+
+
+Dir.glob(File.dirname(__FILE__) + '/helperful/*_helper.rb').each { |helper| require helper }
+require 'helperful/deprecations'
+require 'helperful/version'
+
+
+module Helperful
+  
+  NAME            = 'Helperful'
+  GEM             = 'helperful'
+  AUTHOR          = 'Simone Carletti <weppos@weppos.net>'
+  
+
+  module ControllerMixin
+
+    def helperful(*args, &block)
+      args.flatten.each do |arg|
+        case arg
+          when String, Symbol
+            file_name = 'helperful/' + arg.to_s.underscore
+            helper(file_name)
+          else
+            helper(arg, &block)
+        end
+      end
+    end
+
+  end
+
+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/content_helper_test.rb

@@ -0,0 +1,71 @@
+require 'test_helper'
+
+class ContentController < ActionController::Base
+  def self.controller_name; "content"; end
+  def self.controller_path; "content"; end
+  
+  helperful "content"
+  
+  def sidebar
+    render :layout => "sidebar"
+  end
+  
+  def sidebar_concatenate
+    render :layout => "sidebar"
+  end
+  
+  def has_content
+    render :layout => "has_content"
+  end
+  
+  def rescue_action(e) raise end
+end
+
+ContentController.view_paths = [ File.dirname(__FILE__) + "/fixtures/" ]
+
+
+class ContentTest < ActiveSupport::TestCase
+  
+  def setup
+    @controller = ContentController.new
+    @request    = ActionController::TestRequest.new
+    @response   = ActionController::TestResponse.new
+
+    @request.host = "test.host"
+  end
+
+  def test_sidebar
+    get :sidebar
+    assert_equal expected_sidebar_content_for_output, @response.body
+  end
+
+  def test_sidebar_concatenate
+    get :sidebar_concatenate
+    assert_equal expected_sidebar_content_for_output, @response.body
+  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
+
+  protected
+  
+    def expected_sidebar_content_for_output
+<<-EOS
+<title>This is the title</title>
+<div id="first">
+  <p>First Sidebar</p>
+</div>
+<div id="second">
+  <p>Second Sidebar</p>
+</div>
+EOS
+    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/sidebar.html.erb

@@ -0,0 +1,8 @@
+<% sidebar do -%>
+<div id="first">
+  <p>First Sidebar</p>
+</div>
+<div id="second">
+  <p>Second Sidebar</p>
+</div>
+<% end %>

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

@@ -0,0 +1,10 @@
+<% sidebar do -%>
+<div id="first">
+  <p>First Sidebar</p>
+</div>
+<% end %>
+<% sidebar do -%>
+<div id="second">
+  <p>Second Sidebar</p>
+</div>
+<% 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/fixtures/layouts/sidebar.html.erb

@@ -0,0 +1,2 @@
+<title>This is the title</title>
+<%= yield :sidebar %>

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/test_helper.rb

@@ -0,0 +1,37 @@
+#
+# = 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 'test/unit'
+require 'rubygems'
+require 'mocha'
+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

data/uninstall.rb

@@ -0,0 +1 @@
+# Uninstall hook code here

metadata

@@ -0,0 +1,125 @@
+--- !ruby/object:Gem::Specification 
+name: weppos-helperful
+version: !ruby/object:Gem::Version 
+  version: 0.2.0
+platform: ruby
+authors: 
+- Simone Carletti
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-02-25 00:00:00 -08:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rake
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0.8"
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: echoe
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "3.1"
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: mocha
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0.9"
+    version: 
+description: Helperful aims to be a collection of useful and reusable Rails helpers.
+email: weppos@weppos.net
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- CHANGELOG.rdoc
+- lib/helperful/affiliations_helper.rb
+- lib/helperful/content_helper.rb
+- lib/helperful/deprecations.rb
+- lib/helperful/title_helper.rb
+- lib/helperful/version.rb
+- lib/helperful.rb
+- LICENSE.rdoc
+- README.rdoc
+files: 
+- CHANGELOG.rdoc
+- init.rb
+- install.rb
+- lib/helperful/affiliations_helper.rb
+- lib/helperful/content_helper.rb
+- lib/helperful/deprecations.rb
+- lib/helperful/title_helper.rb
+- lib/helperful/version.rb
+- lib/helperful.rb
+- LICENSE.rdoc
+- rails/init.rb
+- Rakefile
+- README.rdoc
+- tasks/helperful_tasks.rake
+- test/affiliations_helper_test.rb
+- test/content_helper_test.rb
+- test/fixtures/content/has_content.html.erb
+- test/fixtures/content/sidebar.html.erb
+- test/fixtures/content/sidebar_concatenate.html.erb
+- test/fixtures/layouts/has_content.html.erb
+- test/fixtures/layouts/sidebar.html.erb
+- test/helperful_test.rb
+- test/test_helper.rb
+- test/title_helper_test.rb
+- uninstall.rb
+- Manifest
+- helperful.gemspec
+has_rdoc: true
+homepage: http://code.simonecarletti.com/helperful
+post_install_message: 
+rdoc_options: 
+- --line-numbers
+- --inline-source
+- --title
+- Helperful
+- --main
+- README.rdoc
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "1.2"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.2.0
+signing_key: 
+specification_version: 2
+summary: A collection of useful Rails helpers.
+test_files: 
+- test/affiliations_helper_test.rb
+- test/content_helper_test.rb
+- test/helperful_test.rb
+- test/test_helper.rb
+- test/title_helper_test.rb