RubyGems - tennpipes-helper - Versions diffs - 3.6.6 - Mend

tennpipes-helper 3.6.6

Files changed (145) hide show

checksums.yaml +7 -0
data/LICENSE.txt +20 -0
data/README.rdoc +239 -0
data/Rakefile +1 -0
data/lib/tennpipes-helper.rb +62 -0
data/lib/tennpipes-helper/asset_tag_helpers.rb +394 -0
data/lib/tennpipes-helper/form_builder/abstract_form_builder.rb +279 -0
data/lib/tennpipes-helper/form_builder/standard_form_builder.rb +40 -0
data/lib/tennpipes-helper/form_helpers.rb +639 -0
data/lib/tennpipes-helper/form_helpers/errors.rb +138 -0
data/lib/tennpipes-helper/form_helpers/options.rb +98 -0
data/lib/tennpipes-helper/form_helpers/security.rb +70 -0
data/lib/tennpipes-helper/format_helpers.rb +372 -0
data/lib/tennpipes-helper/locale/cs.yml +103 -0
data/lib/tennpipes-helper/locale/da.yml +91 -0
data/lib/tennpipes-helper/locale/de.yml +81 -0
data/lib/tennpipes-helper/locale/en.yml +103 -0
data/lib/tennpipes-helper/locale/es.yml +103 -0
data/lib/tennpipes-helper/locale/fr.yml +79 -0
data/lib/tennpipes-helper/locale/hu.yml +103 -0
data/lib/tennpipes-helper/locale/it.yml +89 -0
data/lib/tennpipes-helper/locale/ja.yml +103 -0
data/lib/tennpipes-helper/locale/lv.yml +103 -0
data/lib/tennpipes-helper/locale/nl.yml +82 -0
data/lib/tennpipes-helper/locale/no.yml +91 -0
data/lib/tennpipes-helper/locale/pl.yml +95 -0
data/lib/tennpipes-helper/locale/pt_br.yml +103 -0
data/lib/tennpipes-helper/locale/ro.yml +103 -0
data/lib/tennpipes-helper/locale/ru.yml +103 -0
data/lib/tennpipes-helper/locale/sv.yml +103 -0
data/lib/tennpipes-helper/locale/tr.yml +103 -0
data/lib/tennpipes-helper/locale/uk.yml +103 -0
data/lib/tennpipes-helper/locale/zh_cn.yml +103 -0
data/lib/tennpipes-helper/locale/zh_tw.yml +103 -0
data/lib/tennpipes-helper/number_helpers.rb +283 -0
data/lib/tennpipes-helper/output_helpers.rb +226 -0
data/lib/tennpipes-helper/output_helpers/abstract_handler.rb +61 -0
data/lib/tennpipes-helper/output_helpers/erb_handler.rb +27 -0
data/lib/tennpipes-helper/output_helpers/haml_handler.rb +25 -0
data/lib/tennpipes-helper/output_helpers/slim_handler.rb +18 -0
data/lib/tennpipes-helper/render_helpers.rb +63 -0
data/lib/tennpipes-helper/tag_helpers.rb +294 -0
data/lib/tennpipes-helper/translation_helpers.rb +36 -0
data/lib/tennpipes/rendering.rb +369 -0
data/lib/tennpipes/rendering/erb_template.rb +40 -0
data/lib/tennpipes/rendering/erubis_template.rb +66 -0
data/lib/tennpipes/rendering/haml_template.rb +26 -0
data/lib/tennpipes/rendering/slim_template.rb +20 -0
data/test/fixtures/apps/render.rb +25 -0
data/test/fixtures/apps/views/article/comment/show.slim +1 -0
data/test/fixtures/apps/views/blog/post.erb +1 -0
data/test/fixtures/apps/views/layouts/specific.erb +1 -0
data/test/fixtures/apps/views/test/post.erb +1 -0
data/test/fixtures/layouts/layout.erb +1 -0
data/test/fixtures/markup_app/app.rb +87 -0
data/test/fixtures/markup_app/views/button_to.erb +8 -0
data/test/fixtures/markup_app/views/button_to.haml +5 -0
data/test/fixtures/markup_app/views/button_to.slim +6 -0
data/test/fixtures/markup_app/views/capture_concat.erb +14 -0
data/test/fixtures/markup_app/views/capture_concat.haml +12 -0
data/test/fixtures/markup_app/views/capture_concat.slim +12 -0
data/test/fixtures/markup_app/views/content_for.erb +23 -0
data/test/fixtures/markup_app/views/content_for.haml +19 -0
data/test/fixtures/markup_app/views/content_for.slim +19 -0
data/test/fixtures/markup_app/views/content_tag.erb +13 -0
data/test/fixtures/markup_app/views/content_tag.haml +11 -0
data/test/fixtures/markup_app/views/content_tag.slim +11 -0
data/test/fixtures/markup_app/views/current_engine.erb +5 -0
data/test/fixtures/markup_app/views/current_engine.haml +5 -0
data/test/fixtures/markup_app/views/current_engine.slim +5 -0
data/test/fixtures/markup_app/views/fields_for.erb +20 -0
data/test/fixtures/markup_app/views/fields_for.haml +15 -0
data/test/fixtures/markup_app/views/fields_for.slim +15 -0
data/test/fixtures/markup_app/views/form_for.erb +72 -0
data/test/fixtures/markup_app/views/form_for.haml +59 -0
data/test/fixtures/markup_app/views/form_for.slim +59 -0
data/test/fixtures/markup_app/views/form_tag.erb +95 -0
data/test/fixtures/markup_app/views/form_tag.haml +78 -0
data/test/fixtures/markup_app/views/form_tag.slim +79 -0
data/test/fixtures/markup_app/views/link_to.erb +5 -0
data/test/fixtures/markup_app/views/link_to.haml +4 -0
data/test/fixtures/markup_app/views/link_to.slim +4 -0
data/test/fixtures/markup_app/views/mail_to.erb +3 -0
data/test/fixtures/markup_app/views/mail_to.haml +3 -0
data/test/fixtures/markup_app/views/mail_to.slim +3 -0
data/test/fixtures/markup_app/views/meta_tag.erb +3 -0
data/test/fixtures/markup_app/views/meta_tag.haml +3 -0
data/test/fixtures/markup_app/views/meta_tag.slim +3 -0
data/test/fixtures/markup_app/views/partials/_erb.erb +1 -0
data/test/fixtures/markup_app/views/partials/_haml.haml +1 -0
data/test/fixtures/markup_app/views/partials/_slim.slim +1 -0
data/test/fixtures/markup_app/views/simple_partial.erb +1 -0
data/test/fixtures/markup_app/views/simple_partial.haml +1 -0
data/test/fixtures/markup_app/views/simple_partial.slim +1 -0
data/test/fixtures/render_app/app.rb +110 -0
data/test/fixtures/render_app/views/_deep.erb +3 -0
data/test/fixtures/render_app/views/_deep.haml +2 -0
data/test/fixtures/render_app/views/_deep.slim +2 -0
data/test/fixtures/render_app/views/_partial_block_erb.erb +10 -0
data/test/fixtures/render_app/views/_partial_block_haml.haml +7 -0
data/test/fixtures/render_app/views/_partial_block_slim.slim +7 -0
data/test/fixtures/render_app/views/_unsafe.html.builder +2 -0
data/test/fixtures/render_app/views/_unsafe_object.html.builder +2 -0
data/test/fixtures/render_app/views/current_engine.haml +5 -0
data/test/fixtures/render_app/views/current_engines/_erb.erb +1 -0
data/test/fixtures/render_app/views/current_engines/_haml.haml +1 -0
data/test/fixtures/render_app/views/current_engines/_slim.slim +1 -0
data/test/fixtures/render_app/views/dive_inner_erb.erb +3 -0
data/test/fixtures/render_app/views/dive_inner_haml.haml +2 -0
data/test/fixtures/render_app/views/dive_inner_slim.slim +2 -0
data/test/fixtures/render_app/views/dive_outer_erb.erb +3 -0
data/test/fixtures/render_app/views/dive_outer_haml.haml +2 -0
data/test/fixtures/render_app/views/dive_outer_slim.slim +2 -0
data/test/fixtures/render_app/views/double_capture_erb.erb +3 -0
data/test/fixtures/render_app/views/double_capture_haml.haml +2 -0
data/test/fixtures/render_app/views/double_capture_slim.slim +2 -0
data/test/fixtures/render_app/views/erb/test.erb +1 -0
data/test/fixtures/render_app/views/explicit_engine.haml +5 -0
data/test/fixtures/render_app/views/haml/test.haml +1 -0
data/test/fixtures/render_app/views/render_block_erb.erb +5 -0
data/test/fixtures/render_app/views/render_block_haml.haml +4 -0
data/test/fixtures/render_app/views/render_block_slim.slim +4 -0
data/test/fixtures/render_app/views/ruby_block_capture_erb.erb +1 -0
data/test/fixtures/render_app/views/ruby_block_capture_haml.haml +1 -0
data/test/fixtures/render_app/views/ruby_block_capture_slim.slim +1 -0
data/test/fixtures/render_app/views/template/_user.haml +7 -0
data/test/fixtures/render_app/views/template/haml_template.haml +1 -0
data/test/fixtures/render_app/views/template/some_template.haml +2 -0
data/test/fixtures/render_app/views/wrong_capture_erb.erb +3 -0
data/test/fixtures/render_app/views/wrong_capture_haml.haml +2 -0
data/test/fixtures/render_app/views/wrong_capture_slim.slim +2 -0
data/test/helper.rb +88 -0
data/test/test_asset_tag_helpers.rb +401 -0
data/test/test_form_builder.rb +1216 -0
data/test/test_form_helpers.rb +1056 -0
data/test/test_format_helpers.rb +251 -0
data/test/test_helpers.rb +10 -0
data/test/test_locale.rb +20 -0
data/test/test_number_helpers.rb +142 -0
data/test/test_output_helpers.rb +157 -0
data/test/test_render_helpers.rb +225 -0
data/test/test_rendering.rb +706 -0
data/test/test_rendering_extensions.rb +14 -0
data/test/test_tag_helpers.rb +131 -0
metadata +299 -0

checksums.yaml ADDED Viewed

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 075ac7ae20c2d50474386971a390201859b847b0
+  data.tar.gz: 3f8f93db0c3dddd6ccd71935b2680f82ff03f3a6
+SHA512:
+  metadata.gz: fc330fdc29804f9e90567e780a596886498f5ced2a161e3fc4b0cbac3247953bee3b5b0657d26a7f37cc2c86d0b4d2278f476275b32f129a6cf4ee5c3cef3542
+  data.tar.gz: efeb79da4049d5133d9c726ed5ce480e1d675fdee6976a6cc43054d743a986cb427f8938941341f0fbfcff77fe630380d9220244c4af8de42e3159c405a9c706

data/LICENSE.txt ADDED Viewed

@@ -0,0 +1,20 @@
+Copyright (c) 2011 Tennpipes
+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 ADDED Viewed

@@ -0,0 +1,239 @@
+= Application Extensions and Helpers (tennpipes-helper)
+=== Overview
+This component provides a great deal of view helpers related to html markup generation.
+There are helpers for generating tags, forms, links, images, and more. Most of the basic
+methods should be very familiar to anyone who has used rails view helpers.
+=== Output Helpers
+Output helpers are a collection of important methods for managing, capturing and displaying output
+in various ways and is used frequently to support higher-level helper functions. There are
+three output helpers worth mentioning: <tt>content_for</tt>, <tt>capture_html</tt>, and <tt>concat_content</tt>
+The content_for functionality supports capturing content and then rendering this into a different place
+such as within a layout. One such popular example is including assets onto the layout from a template:
+  # app/views/site/index.erb
+  ...
+  <% content_for :assets do %>
+    <%= stylesheet_link_tag 'index', 'custom' %>
+  <% end %>
+  ...
+Added to a template, this will capture the includes from the block and allow them to be yielded into the layout:
+  # app/views/layout.erb
+  ...
+  <head>
+    <title>Example</title>
+    <%= stylesheet_link_tag 'style' %>
+    <%= yield_content :assets %>
+  </head>
+  ...
+This will automatically insert the contents of the block (in this case a stylesheet include) into the
+location the content is yielded within the layout. You can also check if content exists for a block using
+<tt>content_for?(true)</tt> which returns true if content exists.
+The capture_html and the concat_content methods allow content to be manipulated and stored for use in building
+additional helpers accepting blocks or displaying information in a template. One example is the use of
+these in constructing a simplified 'form_tag' helper which accepts a block.
+  # form_tag '/register' do ... end
+  def form_tag(url, options={}, &block)
+    # ... truncated ...
+    inner_form_html = capture_html(&block)
+    concat_content '<form>' + inner_form_html + '</form>'
+  end
+This will capture the template body passed into the form_tag block and then append the content
+to the template through the use of <tt>concat_content</tt>. Note have been built to work for both haml and erb
+templates using the same syntax.
+For more information on using output helpers, check out the guide for
+{Tennpipes Helpers}[http://www.tennpipesrb.com/guides/application-helpers].
+=== Tag Helpers
+Tag helpers are the basic building blocks used to construct html 'tags' within a view template. There
+are three major functions for this category: <tt>tag</tt>, <tt>content_tag</tt> and <tt>input_tag</tt>.
+The tag and content_tag are for building arbitrary html tags with a name and specified options. If
+the tag contains 'content' within then <tt>content_tag</tt> is used. For example:
+  tag(:br, :style => 'clear:both') => <br style="clear:both" />
+  content_tag(:p, "demo", :class => 'light') => <p class="light">demo</p>
+The input_tag is used to build tags that are related to accepting input from the user:
+  input_tag :text, :class => "demo" => <input type='text' class='demo' />
+  input_tag :password, :value => "secret", :class => "demo"
+Note that all of these accept html options and result in returning a string containing html tags.
+For more information on using tag helpers, check out the guide for
+{Tennpipes Helpers}[http://www.tennpipesrb.com/guides/application-helpers].
+=== Asset Helpers
+Asset helpers are intended to help insert useful html onto a view template such as 'flash' notices,
+hyperlinks, mail_to links, images, stylesheets and javascript. An example of their uses would be on a
+simple view template:
+  # app/views/example.haml
+  ...
+  %head
+    = stylesheet_link_tag 'layout'
+    = javascript_include_tag 'application'
+  %body
+    ...
+    = flash_tag :notice
+    %p= link_to 'Blog', '/blog', :class => 'example'
+    %p Mail me at #{mail_to 'fake@faker.com', "Fake Email Link", :cc => "test@demo.com"}
+    %p= image_tag 'tennpipes.png', :width => '35', :class => 'logo'
+For more information on using asset helpers, check out the guide for
+{Tennpipes Helpers}[http://www.tennpipesrb.com/guides/application-helpers].
+=== Form Helpers
+Form helpers are the 'standard' form tag helpers you would come to expect when building forms. A simple
+example of constructing a non-object form would be:
+  = form_tag '/destroy', :class => 'destroy-form', :method => 'delete' do
+    = flash_tag(:notice)
+    = field_set_tag do
+      %p
+        = label_tag :username, :class => 'first'
+        = text_field_tag :username, :value => params[:username]
+      %p
+        = label_tag :password, :class => 'first'
+        = password_field_tag :password, :value => params[:password]
+      %p
+        = label_tag :strategy
+        = select_tag :strategy, :options => ['delete', 'destroy'], :selected => 'delete'
+      %p
+        = check_box_tag :confirm_delete
+    = field_set_tag(:class => 'buttons') do
+      = submit_tag "Remove"
+For more information on using form helpers, check out the guide for
+{Tennpipes Helpers}[http://www.tennpipesrb.com/guides/application-helpers].
+=== FormBuilders
+Form builders are full-featured objects allowing the construction of complex object-based forms
+using a simple, intuitive syntax.
+A form_for using these basic fields might look like:
+  = form_for @user, '/register', :id => 'register' do |f|
+    = f.error_messages
+    %p
+      = f.label :username, :caption => "Nickname"
+      = f.text_field :username
+    %p
+      = f.label :email
+      = f.text_field :email
+    %p
+      = f.label :password
+      = f.password_field :password
+    %p
+      = f.label :is_admin, :caption => "Admin User?"
+      = f.check_box :is_admin
+    %p
+      = f.label :color, :caption => "Favorite Color?"
+      = f.select :color, :options => ['red', 'black']
+    %p
+      = fields_for @user.location do |location|
+        = location.text_field :street
+        = location.text_field :city
+    %p
+      = f.submit "Create", :class => 'button'
+Forms can also accept nested attributes using `fields_for` within the form builder in recent releases. Check out the guide for {Tennpipes Helpers}[http://www.tennpipesrb.com/guides/application-helpers] to learn more about nested forms.
+There is also an additional StandardFormBuilder which builds on the abstract fields that can be used within a form_for.
+A form_for using these standard fields might be:
+  = form_for @user, '/register', :id => 'register' do |f|
+    = f.error_messages
+    = f.text_field_block :name, :caption => "Full name"
+    = f.text_field_block :email
+    = f.check_box_block  :remember_me
+    = f.select_block     :fav_color, :options => ['red', 'blue']
+    = f.password_field_block :password
+    = f.submit_block "Create", :class => 'button'
+and would generate this html (with each input contained in a paragraph and containing a label):
+  <form id="register" action="/register" method="post">
+    <p><label for="user_name">Full name: </label><input type="text" id="user_name" name="user[name]"></p>
+    ...omitted...
+    <p><input type="submit" value="Create" class="button"></p>
+  </form>
+You can also easily build your own FormBuilder which allows for customized fields and behavior.
+For more information on using the Tennpipes form builders, check out the guide for
+{Tennpipes Helpers}[http://www.tennpipesrb.com/guides/application-helpers].
+=== Format Helpers
+Format helpers are several useful utilities for manipulating the format of text to achieve a goal.
+The four format helpers are <tt>escape_html</tt>, <tt>time_ago_in_words</tt>, and <tt>js_escape_html</tt>.
+The escape_html and js_escape_html function are for taking an html string and escaping certain characters.
+<tt>escape_html</tt> will escape ampersands, brackets and quotes to their HTML/XML entities. This is useful
+to sanitize user content before displaying this on a template. <tt>js_escape_html</tt> is used for
+passing javascript information from a js template to a javascript function.
+  escape_html('<hello>&<goodbye>') # => &lt;hello&gt;&amp;&lt;goodbye&gt;
+There is also an alias for escape_html called <tt>h</tt> for even easier usage within templates.
+Format helpers also includes a number of useful text manipulation functions such as <tt>simple_format</tt>,
+<tt>pluralize</tt>, <tt>word_wrap</tt>, <tt>truncate</tt> and <tt>truncate_words</tt>.
+  simple_format("hello\nworld") # => "<p>hello<br/>world</p>"
+  pluralize(2, 'person') => '2 people'
+  word_wrap('Once upon a time', :line_width => 8) => "Once upon\na time"
+  truncate("Once upon a time in a world far far away", :length => 8) => "Once upon..."
+  truncate_words("Once upon a time in a world far far away", :length => 4) => "Once upon a time..."
+These helpers can be invoked from any route or view within your application.
+For more information on using the format helpers, check out the guide for
+{Tennpipes Helpers}[http://www.tennpipesrb.com/guides/application-helpers].
+=== Render Helpers
+This component provides a number of rendering helpers making the process of displaying templates a bit easier.
+This plugin also has support for useful additions such as partials (with support for :collection) for the templating system.
+Using render plugin helpers is extremely simple. If you want to render an erb template in your view path:
+  render :erb, 'path/to/erb/template'
+or using haml templates works just as well:
+  render :haml, 'path/to/haml/template'
+There is also a method which renders the first view matching the path and removes the need to define an engine:
+  render 'path/to/any/template'
+Finally, we have the all-important partials support for rendering mini-templates onto a page:
+  partial 'photo/_item', :object => @photo, :locals => { :foo => 'bar' }
+  partial 'photo/_item', :collection => @photos
+For more information on using the render and partial helpers, check out the guide for
+{Tennpipes Helpers}[http://www.tennpipesrb.com/guides/application-helpers].
+== Copyright
+Copyright (c) 2011-2013 Tennpipes. See LICENSE for details.

data/Rakefile ADDED Viewed

	@@ -0,0 +1 @@
1	+ require File.expand_path(File.dirname(__FILE__) + '/../gem_rake_helper')

data/lib/tennpipes-helper.rb ADDED Viewed

@@ -0,0 +1,62 @@
+require 'tennpipes-assist'
+require 'i18n'
+require 'enumerator'
+require 'active_support/time_with_zone'               # next extension depends on this
+require 'active_support/core_ext/string/conversions'  # to_date
+require 'active_support/option_merger'                # with_options
+require 'active_support/core_ext/object/with_options' # with_options
+require 'active_support/inflector'                    # humanize
+require 'active_support/core_ext/hash/except'         # Hash#except
+require 'tennpipes/rendering'
+FileSet.glob_require('tennpipes-helper/**/*.rb', __FILE__)
+I18n.load_path += Dir["#{File.dirname(__FILE__)}/tennpipes-helper/locale/*.yml"]
+I18n.enforce_available_locales = true
+module Tennpipes
+  ##
+  # This component provides a variety of view helpers related to html markup generation.
+  # There are helpers for generating tags, forms, links, images, and more.
+  # Most of the basic methods should be very familiar to anyone who has used rails view helpers.
+  #
+  module Helpers
+    class << self
+      ##
+      # Registers these helpers into your application:
+      #
+      #   Tennpipes::Helpers::OutputHelpers
+      #   Tennpipes::Helpers::TagHelpers
+      #   Tennpipes::Helpers::AssetTagHelpers
+      #   Tennpipes::Helpers::FormHelpers
+      #   Tennpipes::Helpers::FormatHelpers
+      #   Tennpipes::Helpers::RenderHelpers
+      #   Tennpipes::Helpers::NumberHelpers
+      #
+      # @param [Sinatra::Application] app
+      #   The specified Tennpipes application.
+      #
+      # @example Register the helper module
+      #   require 'tennpipes-helper'
+      #   class Tennpipes::Application
+      #     register Tennpipes::Helpers
+      #   end
+      #
+      def registered(app)
+        app.register Tennpipes::Rendering
+        app.set :default_builder, 'StandardFormBuilder'
+        included(app)
+      end
+      def included(base)
+        base.send :include, Tennpipes::Helpers::OutputHelpers
+        base.send :include, Tennpipes::Helpers::TagHelpers
+        base.send :include, Tennpipes::Helpers::AssetTagHelpers
+        base.send :include, Tennpipes::Helpers::FormHelpers
+        base.send :include, Tennpipes::Helpers::FormatHelpers
+        base.send :include, Tennpipes::Helpers::RenderHelpers
+        base.send :include, Tennpipes::Helpers::NumberHelpers
+        base.send :include, Tennpipes::Helpers::TranslationHelpers
+      end
+    end
+  end
+end

data/lib/tennpipes-helper/asset_tag_helpers.rb ADDED Viewed

@@ -0,0 +1,394 @@
+module Tennpipes
+  module Helpers
+    ###
+    # Helpers related to producing assets (images, stylesheets, js, etc) within templates.
+    #
+    module AssetTagHelpers
+      APPEND_ASSET_EXTENSIONS = ["js", "css"]
+      ABSOLUTE_URL_PATTERN = %r{^(https?://)}
+      ASSET_FOLDERS = {
+        :js => 'javascripts',
+        :css => 'stylesheets',
+      }
+      ##
+      # Creates a div to display the flash of given type if it exists.
+      #
+      # @param [Symbol] kind
+      #   The type of flash to display in the tag.
+      # @param [Hash] options
+      #   The html options for this section.
+      #   use :bootstrap => true to support Twitter's bootstrap dismiss alert button.
+      #
+      # @return [String] Flash tag html with specified +options+.
+      #
+      # @example
+      #   flash_tag(:notice, :id => 'flash-notice')
+      #   # Generates: <div class="notice" id="flash-notice">flash-notice</div>
+      #   flash_tag(:error, :success)
+      #   # Generates: <div class="error">flash-error</div>
+      #   # <div class="success">flash-success</div>
+      #
+      def flash_tag(*args)
+        options = args.extract_options!
+        bootstrap = options.delete(:bootstrap) if options[:bootstrap]
+        args.inject(ActiveSupport::SafeBuffer.new) do |html,kind|
+          flash_text = ActiveSupport::SafeBuffer.new << flash[kind]
+          next html if flash_text.blank?
+          flash_text << content_tag(:button, '&times;'.html_safe, {:type => :button, :class => :close, :'data-dismiss' => :alert}) if bootstrap
+          html << content_tag(:div, flash_text, { :class => kind }.update(options))
+        end
+      end
+      ##
+      # Creates a link element with given name, url and options.
+      #
+      # @overload link_to(caption, url, options={})
+      #   @param [String]  caption  The text caption.
+      #   @param [String]  url      The url href.
+      #   @param [Hash]    options  The html options.
+      # @overload link_to(url, options={}, &block)
+      #   @param [String]  url      The url href.
+      #   @param [Hash]    options  The html options.
+      #   @param [Proc]    block    The link content.
+      #
+      # @option options [Boolean] :if
+      #   If true, the link will appear, otherwise not.
+      # @option options [Boolean] :unless
+      #   If false, the link will appear, otherwise not.
+      # @option options [Boolean] :remote
+      #   If true, this link should be handled by an ajax ujs handler.
+      # @option options [String] :confirm
+      #   Instructs ujs handler to alert confirm message.
+      # @option options [Symbol] :method
+      #   Instructs ujs handler to use different http method (i.e :post, :delete).
+      #
+      # @return [String] Link tag html with specified +options+.
+      #
+      # @example
+      #   link_to('click me', '/dashboard', :class => 'linky')
+      #   # Generates <a class="linky" href="/dashboard">click me</a>
+      #
+      #   link_to('click me', '/dashboard', :remote => true)
+      #   # Generates <a href="/dashboard" data-remote="true">click me</a>
+      #
+      #   link_to('click me', '/dashboard', :method => :delete)
+      #   # Generates <a href="/dashboard" data-method="delete" rel="nofollow">click me</a>
+      #
+      #   link_to('click me', :class => 'blocky') do; end
+      #   # Generates <a class="blocky" href="#">click me</a>
+      #
+      # Note that you can pass :+if+ or :+unless+ conditions, but if you provide :current as
+      # condition tennpipes return true/false if the request.path_info match the given url.
+      #
+      def link_to(*args, &block)
+        options  = args.extract_options!
+        name = block_given? ? '' : args.shift
+        href = args.first
+        options.reverse_merge!(:href => href || '#')
+        return name unless parse_conditions(href, options)
+        block_given? ? content_tag(:a, options, &block) : content_tag(:a, name, options)
+      end
+      ##
+      # Creates a link tag that browsers and news readers can use to auto-detect an RSS or ATOM feed.
+      #
+      # @param [Symbol] mime
+      #   The mime type of the feed (i.e :atom or :rss).
+      # @param [String] url
+      #   The url for the feed tag to reference.
+      # @param[Hash] options
+      #   The options for the feed tag.
+      # @option options [String] :rel ("alternate")
+      #   Specify the relation of this link.
+      # @option options [String] :type
+      #   Override the auto-generated mime type.
+      # @option options [String] :title
+      #   Specify the title of the link, defaults to the type.
+      #
+      # @return [String] Feed link html tag with specified +options+.
+      #
+      # @example
+      #   feed_tag :atom, url(:blog, :posts, :format => :atom), :title => "ATOM"
+      #   # Generates: <link type="application/atom+xml" rel="alternate" href="/blog/posts.atom" title="ATOM" />
+      #   feed_tag :rss, url(:blog, :posts, :format => :rss)
+      #   # Generates: <link type="application/rss+xml" rel="alternate" href="/blog/posts.rss" title="rss" />
+      #
+      def feed_tag(mime, url, options={})
+        full_mime = (mime == :atom) ? 'application/atom+xml' : 'application/rss+xml'
+        tag(:link, options.reverse_merge(:rel => 'alternate', :type => full_mime, :title => mime, :href => url))
+      end
+      ##
+      # Creates a mail link element with given name and caption.
+      #
+      # @param [String] email
+      #   The email address for the link.
+      # @param [String] caption
+      #   The caption for the link.
+      # @param [Hash] mail_options
+      #   The options for the mail link. Accepts html options.
+      # @option mail_options [String] cc      The cc recipients.
+      # @option mail_options [String] bcc     The bcc recipients.
+      # @option mail_options [String] subject The subject line.
+      # @option mail_options [String] body    The email body.
+      #
+      # @return [String] Mail link html tag with specified +options+.
+      #
+      # @example
+      #   mail_to "me@demo.com"
+      #   # Generates: <a href="mailto:me@demo.com">me@demo.com</a>
+      #
+      #   mail_to "me@demo.com", "My Email"
+      #   # Generates: <a href="mailto:me@demo.com">My Email</a>
+      #
+      def mail_to(email, caption=nil, mail_options={})
+        html_options = mail_options.slice!(:cc, :bcc, :subject, :body)
+        mail_query = Rack::Utils.build_query(mail_options).gsub(/\+/, '%20').gsub('%40', '@')
+        mail_href = "mailto:#{email}"; mail_href << "?#{mail_query}" if mail_query.present?
+        link_to((caption || email), mail_href, html_options)
+      end
+      ##
+      # Creates a meta element with the content and given options.
+      #
+      # @param [String] content
+      #   The content for the meta tag.
+      # @param [Hash] options
+      #   The html options for the meta tag.
+      #
+      # @return [String] Meta html tag with specified +options+.
+      #
+      # @example
+      #   meta_tag "weblog,news", :name => "keywords"
+      #   # Generates: <meta name="keywords" content="weblog,news" />
+      #
+      #   meta_tag "text/html; charset=UTF-8", 'http-equiv' => "Content-Type"
+      #   # Generates: <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
+      #
+      def meta_tag(content, options={})
+        options.reverse_merge!("content" => content)
+        tag(:meta, options)
+      end
+      ##
+      # Generates a favicon link. Looks inside images folder
+      #
+      # @param [String] source
+      #   The source image path for the favicon link tag.
+      # @param [Hash] options
+      #   The html options for the favicon link tag.
+      #
+      # @return [String] The favicon link html tag with specified +options+.
+      #
+      # @example
+      #   favicon_tag 'favicon.png'
+      #   favicon_tag 'icons/favicon.png'
+      #   # or override some options
+      #   favicon_tag 'favicon.png', :type => 'image/ico'
+      #
+      def favicon_tag(source, options={})
+        type = File.extname(source).sub('.','')
+        options = options.dup.reverse_merge!(:href => image_path(source), :rel => 'icon', :type => "image/#{type}")
+        tag(:link, options)
+      end
+      ##
+      # Creates an image element with given url and options.
+      #
+      # @param [String] url
+      #   The source path for the image tag.
+      # @param [Hash] options
+      #   The html options for the image tag.
+      #
+      # @return [String] Image html tag with +url+ and specified +options+.
+      #
+      # @example
+      #   image_tag('icons/avatar.png')
+      #
+      def image_tag(url, options={})
+        options.reverse_merge!(:src => image_path(url))
+        tag(:img, options)
+      end
+      ##
+      # Returns a html link tag for each of the sources provided.
+      # You can pass in the filename without extension or a symbol and we search it in your +appname.public_folder+
+      # like app/public/stylesheets for inclusion. You can provide also a full path.
+      #
+      # @overload stylesheet_link_tag(*sources, options={})
+      #   @param [Array<String>] sources   Splat of css source paths
+      #   @param [Hash]          options   The html options for the link tag
+      #
+      # @return [String] Stylesheet link html tag for +sources+ with specified +options+.
+      #
+      # @example
+      #   stylesheet_link_tag 'style', 'application', 'layout'
+      #
+      # @api public.
+      def stylesheet_link_tag(*sources)
+        options = {
+          :rel => 'stylesheet',
+          :type => 'text/css'
+        }.update(sources.extract_options!.symbolize_keys)
+        sources.flatten.inject(ActiveSupport::SafeBuffer.new) do |all,source|
+          all << tag(:link, { :href => asset_path(:css, source) }.update(options))
+        end
+      end
+      ##
+      # Returns a html script tag for each of the sources provided.
+      # You can pass in the filename without extension or a symbol and we search it in your +appname.public_folder+
+      # like app/public/javascript for inclusion. You can provide also a full path.
+      #
+      # @overload javascript_include_tag(*sources, options={})
+      #   @param [Array<String>] sources   Splat of js source paths
+      #   @param [Hash]          options   The html options for the script tag
+      #
+      # @return [String] Script tag for +sources+ with specified +options+.
+      #
+      # @example
+      #   javascript_include_tag 'application', :extjs
+      #
+      def javascript_include_tag(*sources)
+        options = {
+          :type => 'text/javascript'
+        }.update(sources.extract_options!.symbolize_keys)
+        sources.flatten.inject(ActiveSupport::SafeBuffer.new) do |all,source|
+          all << content_tag(:script, nil, { :src => asset_path(:js, source) }.update(options))
+        end
+      end
+      ##
+      # Returns the path to the image, either relative or absolute. We search it in your +appname.public_folder+
+      # like app/public/images for inclusion. You can provide also a full path.
+      #
+      # @param [String] src
+      #   The path to the image file (relative or absolute).
+      #
+      # @return [String] Path to an image given the +kind+ and +source+.
+      #
+      # @example
+      #   # Generates: /images/foo.jpg?1269008689
+      #   image_path("foo.jpg")
+      #
+      # @api public
+      def image_path(src)
+        asset_path(:images, src)
+      end
+      ##
+      # Returns the path to the specified asset (css or javascript).
+      #
+      # @param [String] kind
+      #   The kind of asset (i.e :images, :js, :css).
+      # @param [String] source
+      #   The path to the asset (relative or absolute).
+      #
+      # @return [String] Path for the asset given the +kind+ and +source+.
+      #
+      # @example
+      #   # Generates: /javascripts/application.js?1269008689
+      #   asset_path :js, :application
+      #
+      #   # Generates: /stylesheets/application.css?1269008689
+      #   asset_path :css, :application
+      #
+      #   # Generates: /images/example.jpg?1269008689
+      #   asset_path :images, 'example.jpg'
+      #
+      #   # Generates: /uploads/file.ext?1269008689
+      #   asset_path 'uploads/file.ext'
+      #
+      def asset_path(kind, source = nil)
+        kind, source = source, kind if source.nil?
+        source = asset_normalize_extension(kind, URI.escape(source.to_s))
+        return source if source =~ ABSOLUTE_URL_PATTERN || source =~ /^\//
+        source = File.join(asset_folder_name(kind), source)
+        timestamp = asset_timestamp(source)
+        result_path = uri_root_path(source)
+        "#{result_path}#{timestamp}"
+      end
+      private
+      ##
+      # Returns the URI root of the application with optional paths appended.
+      #
+      # @example
+      #   uri_root_path("/some/path") => "/root/some/path"
+      #   uri_root_path("javascripts", "test.js") => "/uri/root/javascripts/test.js"
+      #
+      def uri_root_path(*paths)
+        root_uri = self.class.uri_root if self.class.respond_to?(:uri_root)
+        File.join(ENV['RACK_BASE_URI'].to_s, root_uri || '/', *paths)
+      end
+      ##
+      # Returns the timestamp mtime for an asset.
+      #
+      # @example
+      #   asset_timestamp("some/path/to/file.png") => "?154543678"
+      #
+      def asset_timestamp(file_path)
+        return nil if file_path =~ /\?/ || (self.class.respond_to?(:asset_stamp) && !self.class.asset_stamp)
+        public_path = self.class.public_folder if self.class.respond_to?(:public_folder)
+        public_path ||= Tennpipes.root("public") if Tennpipes.respond_to?(:root)
+        public_file_path = File.join(public_path, file_path) if public_path
+        stamp = File.mtime(public_file_path).to_i if public_file_path && File.exist?(public_file_path)
+        stamp ||= Time.now.to_i
+        "?#{stamp}"
+      end
+      ###
+      # Returns the asset folder given a kind.
+      #
+      # Configureable by setting kind_asset_folder.
+      #
+      # @example
+      #   asset_folder_name(:css) => 'stylesheets'
+      #   asset_folder_name(:js)  => 'javascripts'
+      #   asset_folder_name(:images) => 'images'
+      #   asset_folder_name(:abrakadabrah) => 'abrakadabrah'
+      #
+      def asset_folder_name(kind)
+        if self.class.respond_to? "#{kind}_asset_folder"
+          self.class.send "#{kind}_asset_folder"
+        else
+          (ASSET_FOLDERS[kind] || kind).to_s
+        end
+      end
+      ##
+      # Normalizes the extension for a given asset.
+      #
+      #  @example
+      #
+      #    asset_normalize_extension(:images, "/foo/bar/baz.png") => "/foo/bar/baz.png"
+      #    asset_normalize_extension(:js, "/foo/bar/baz") => "/foo/bar/baz.js"
+      #
+      def asset_normalize_extension(kind, source)
+        ignore_extension = !APPEND_ASSET_EXTENSIONS.include?(kind.to_s)
+        source << ".#{kind}" unless ignore_extension || source =~ /\.#{kind}/ || source =~ ABSOLUTE_URL_PATTERN
+        source
+      end
+      ##
+      # Parses link_to options for given correct conditions.
+      #
+      # @example
+      #   parse_conditions("/some/url", :if => false) => true
+      #
+      def parse_conditions(url, options)
+        if options.has_key?(:if)
+          condition = options.delete(:if)
+          condition == :current ? url == request.path_info : condition
+        elsif condition = options.delete(:unless)
+          condition == :current ? url != request.path_info : !condition
+        else
+          true
+        end
+      end
+    end
+  end
+end