weppos-helperful 0.3.1 → 0.4.0

data/CHANGELOG.rdoc

@@ -1,6 +1,13 @@
 = Changelog
 
 
+== Release 0.4.0
+
+* ADDED: javascript and stylesheet AssetTag Helpers.
+
+* FIXED: GitHub now requires the Manifest file to be included in the repos.
+
+
 == Release 0.3.1
 
 * FIXED: #javascript_content_for doesn't properly concat output when called with block (closes #183).

data/Manifest

@@ -0,0 +1,32 @@
+CHANGELOG.rdoc
+helperful.gemspec
+init.rb
+install.rb
+lib/helperful/affiliations_helper.rb
+lib/helperful/asset_tag_helper.rb
+lib/helperful/content_helper.rb
+lib/helperful/deprecations.rb
+lib/helperful/javascript_helper.rb
+lib/helperful/title_helper.rb
+lib/helperful/version.rb
+lib/helperful.rb
+LICENSE.rdoc
+Manifest
+rails/init.rb
+Rakefile
+README.rdoc
+tasks/helperful_tasks.rake
+test/affiliations_helper_test.rb
+test/asset_tag_helper_test.rb
+test/content_helper_test.rb
+test/fixtures/content/has_content.html.erb
+test/fixtures/content/has_content_is_called_alone.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/javascript_helper_test.rb
+test/test_helper.rb
+test/title_helper_test.rb
+uninstall.rb

data/README.rdoc

@@ -3,7 +3,7 @@
 Helperful aims to be a collection of useful and reusable Rails helpers.
 
 
-== Rails Installation
+== Plugin Installation
 
 === As a Gem
 
@@ -14,9 +14,6 @@ This is the preferred way to install Helperful and the best way if you want inst
 You can specify the GEM dependency in your application environment.rb file:
 
   Rails::Initializer.run do |config|
-    
-    # other configurations
-    
     config.gem "weppos-helperful", :lib => "helperful", :source => "http://gems.github.com"
   end
 
@@ -96,6 +93,10 @@ Once included, all helper methods are available in the View.
 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.
 
+=== Asset Tag Helper
+
+Provides a set of helpers for generating HTML that links views to assets such as images, javascripts, stylesheets, and feeds.
+
 === Affiliations Helper
 
 Provides a set of helpers for working with online affiliations.

data/Rakefile

@@ -1,14 +1,13 @@
+$:.unshift(File.dirname(__FILE__) + "/lib")
+
 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)
@@ -23,7 +22,7 @@ end
 Echoe.new(PKG_NAME, PKG_VERSION) do |p|
   p.author        = "Simone Carletti"
   p.email         = "weppos@weppos.net"
-  p.summary       = PKG_SUMMARY
+  p.summary       = "A collection of useful Rails helpers."
   p.description   = <<-EOD
     Helperful aims to be a collection of useful and reusable Rails helpers.
   EOD

data/helperful.gemspec

@@ -2,26 +2,26 @@
 
 Gem::Specification.new do |s|
   s.name = %q{helperful}
-  s.version = "0.3.1"
+  s.version = "0.4.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-03-24}
-  s.description = %q{Helperful aims to be a collection of useful and reusable Rails helpers.}
+  s.date = %q{2009-06-30}
+  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/javascript_helper.rb", "lib/helperful/title_helper.rb", "lib/helperful/version.rb", "lib/helperful.rb", "LICENSE.rdoc", "README.rdoc"]
-  s.files = ["CHANGELOG.rdoc", "helperful.gemspec", "init.rb", "install.rb", "lib/helperful/affiliations_helper.rb", "lib/helperful/content_helper.rb", "lib/helperful/deprecations.rb", "lib/helperful/javascript_helper.rb", "lib/helperful/title_helper.rb", "lib/helperful/version.rb", "lib/helperful.rb", "LICENSE.rdoc", "Manifest", "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/has_content_is_called_alone.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/javascript_helper_test.rb", "test/test_helper.rb", "test/title_helper_test.rb", "uninstall.rb"]
-  s.has_rdoc = true
+  s.extra_rdoc_files = ["CHANGELOG.rdoc", "lib/helperful/affiliations_helper.rb", "lib/helperful/asset_tag_helper.rb", "lib/helperful/content_helper.rb", "lib/helperful/deprecations.rb", "lib/helperful/javascript_helper.rb", "lib/helperful/title_helper.rb", "lib/helperful/version.rb", "lib/helperful.rb", "LICENSE.rdoc", "README.rdoc"]
+  s.files = ["CHANGELOG.rdoc", "helperful.gemspec", "init.rb", "install.rb", "lib/helperful/affiliations_helper.rb", "lib/helperful/asset_tag_helper.rb", "lib/helperful/content_helper.rb", "lib/helperful/deprecations.rb", "lib/helperful/javascript_helper.rb", "lib/helperful/title_helper.rb", "lib/helperful/version.rb", "lib/helperful.rb", "LICENSE.rdoc", "Manifest", "rails/init.rb", "Rakefile", "README.rdoc", "tasks/helperful_tasks.rake", "test/affiliations_helper_test.rb", "test/asset_tag_helper_test.rb", "test/content_helper_test.rb", "test/fixtures/content/has_content.html.erb", "test/fixtures/content/has_content_is_called_alone.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/javascript_helper_test.rb", "test/test_helper.rb", "test/title_helper_test.rb", "uninstall.rb"]
   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.rubygems_version = %q{1.3.4}
   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/javascript_helper_test.rb", "test/test_helper.rb", "test/title_helper_test.rb"]
+  s.test_files = ["test/affiliations_helper_test.rb", "test/asset_tag_helper_test.rb", "test/content_helper_test.rb", "test/helperful_test.rb", "test/javascript_helper_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
+    s.specification_version = 3
 
     if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
       s.add_development_dependency(%q<rake>, [">= 0.8"])

data/lib/helperful/asset_tag_helper.rb

@@ -0,0 +1,78 @@
+#
+# = 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
+
+  #
+  # = Asset Tag Helper
+  #
+  # Provides a set of helpers for generating HTML that links views to assets such
+  # as images, javascripts, stylesheets, and feeds.
+  #
+  # ==== Requirements
+  #
+  # The following requirements are mandatory for this module.
+  # Including this helper will automatically include them unless already included.
+  #
+  # * ActionView::Helpers::AssetTagHelper
+  #
+  module AssetTagHelper
+
+    def self.included(base)
+      base.class_eval do
+        base.included_modules.include?(ActionView::Helpers::AssetTagHelper) || include(ActionView::Helpers::AssetTagHelper)
+      end
+    end
+
+    # Converts given +files+ in javascript include statements
+    # and appends them in the head section of the page.
+    # 
+    # ==== Examples
+    # 
+    #   # in your index.html.erb view
+    #   <% javascript :foo, :bar, :cache => "foobar" %>
+    # 
+    #   # this is equivalent to
+    #   <% content_for :head, javascript_include_tag(:foo, :bar, :cache => "foobar") %>
+    # 
+    #   # in your application
+    #   <% yield :head %>
+    # 
+    def javascript(*files)
+      content_for(:head, javascript_include_tag(*files))
+    end
+
+    # Converts given +files+ in stylesheet link statements
+    # and appends them in the head section of the page.
+    # 
+    # ==== Examples
+    # 
+    #   # in your index.html.erb view
+    #   <% stylesheet :foo, :bar, :cache => "foobar" %>
+    # 
+    #   # this is equivalent to
+    #   <% content_for :head, stylesheet_link_tag(:foo, :bar, :cache => "foobar") %>
+    # 
+    #   # in your application
+    #   <% yield :head %>
+    # 
+    def stylesheet(*files)
+      content_for(:head, stylesheet_link_tag(*files))
+    end
+
+  end
+end

data/lib/helperful/version.rb

@@ -19,8 +19,8 @@ module Helperful
 
   module Version
     MAJOR = 0
-    MINOR = 3
-    TINY  = 1
+    MINOR = 4
+    TINY  = 0
 
     STRING = [MAJOR, MINOR, TINY].join('.')
   end

data/test/asset_tag_helper_test.rb

@@ -0,0 +1,42 @@
+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')
+  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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: weppos-helperful
 version: !ruby/object:Gem::Version 
-  version: 0.3.1
+  version: 0.4.0
 platform: ruby
 authors: 
 - Simone Carletti
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2009-03-24 00:00:00 -07:00
+date: 2009-06-30 00:00:00 -07:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -51,6 +51,7 @@ extensions: []
 extra_rdoc_files: 
 - CHANGELOG.rdoc
 - lib/helperful/affiliations_helper.rb
+- lib/helperful/asset_tag_helper.rb
 - lib/helperful/content_helper.rb
 - lib/helperful/deprecations.rb
 - lib/helperful/javascript_helper.rb
@@ -65,6 +66,7 @@ files:
 - init.rb
 - install.rb
 - lib/helperful/affiliations_helper.rb
+- lib/helperful/asset_tag_helper.rb
 - lib/helperful/content_helper.rb
 - lib/helperful/deprecations.rb
 - lib/helperful/javascript_helper.rb
@@ -78,6 +80,7 @@ files:
 - README.rdoc
 - tasks/helperful_tasks.rake
 - test/affiliations_helper_test.rb
+- test/asset_tag_helper_test.rb
 - test/content_helper_test.rb
 - test/fixtures/content/has_content.html.erb
 - test/fixtures/content/has_content_is_called_alone.html.erb
@@ -90,7 +93,7 @@ files:
 - test/test_helper.rb
 - test/title_helper_test.rb
 - uninstall.rb
-has_rdoc: true
+has_rdoc: false
 homepage: http://code.simonecarletti.com/helperful
 post_install_message: 
 rdoc_options: 
@@ -119,10 +122,11 @@ requirements: []
 rubyforge_project: 
 rubygems_version: 1.2.0
 signing_key: 
-specification_version: 2
+specification_version: 3
 summary: A collection of useful Rails helpers.
 test_files: 
 - test/affiliations_helper_test.rb
+- test/asset_tag_helper_test.rb
 - test/content_helper_test.rb
 - test/helperful_test.rb
 - test/javascript_helper_test.rb