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

tennpipes-helper 3.6.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

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