merb-assets 0.9.2

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2008 YOUR NAME
+
+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

@@ -0,0 +1,4 @@
+merb-assets
+===========
+
+A plugin for the Merb framework that provides ...

data/Rakefile

@@ -0,0 +1,44 @@
+require 'rubygems'
+require 'rake/gempackagetask'
+
+PLUGIN = "merb-assets"
+NAME = "merb-assets"
+VERSION = "0.9.2"
+AUTHOR = "Ezra Zygmuntowicz"
+EMAIL = "ez@engineyard.com"
+HOMEPAGE = "http://merb-plugins.rubyforge.org/merb-assets/"
+SUMMARY = "Merb plugin that provides the helpers for assets and asset bundling"
+
+spec = Gem::Specification.new do |s|
+  s.name = NAME
+  s.version = VERSION
+  s.platform = Gem::Platform::RUBY
+  s.has_rdoc = true
+  s.extra_rdoc_files = ["README", "LICENSE", 'TODO']
+  s.summary = SUMMARY
+  s.description = s.summary
+  s.author = AUTHOR
+  s.email = EMAIL
+  s.homepage = HOMEPAGE
+  s.add_dependency('merb-core', '>= 0.9.2')
+  s.require_path = 'lib'
+  s.autorequire = PLUGIN
+  s.files = %w(LICENSE README Rakefile TODO) + Dir.glob("{lib,specs}/**/*")
+end
+
+Rake::GemPackageTask.new(spec) do |pkg|
+  pkg.gem_spec = spec
+end
+
+task :install => [:package] do
+  sh %{sudo gem install pkg/#{NAME}-#{VERSION} --no-update-sources --no-update-sources}
+end
+
+namespace :jruby do
+
+  desc "Run :package and install the resulting .gem with jruby"
+  task :install => :package do
+    sh %{#{SUDO} jruby -S gem install pkg/#{NAME}-#{Merb::VERSION}.gem --no-rdoc --no-ri}
+  end
+  
+end

data/TODO

@@ -0,0 +1,5 @@
+TODO:
+Fix LICENSE with your name
+Fix Rakefile with your name and contact info
+Add your code to lib/merb-haml.rb
+Add your Merb rake tasks to lib/merb-haml/merbtasks.rb

data/lib/merb-assets.rb

@@ -0,0 +1,14 @@
+require 'merb-assets/assets'
+require 'merb-assets/assets_mixin'
+
+Merb::BootLoader.before_app_loads do
+  Merb::Controller.send(:include, Merb::AssetsMixin)
+end
+
+
+Merb::Plugins.config[:asset_helpers] = {
+    :max_hosts => 4,
+    :asset_domain => "assets%s",
+    :domain => "my-awesome-domain.com",
+    :use_ssl => false
+  } if Merb::Plugins.config[:asset_helpers].nil?

data/lib/merb-assets/assets.rb

@@ -0,0 +1,198 @@
+module Merb
+  module Assets
+    
+    # Check whether the assets should be bundled.
+    #
+    # ==== Returns
+    # Boolean::
+    #   True if the assets should be bundled (e.g., production mode or
+    #   :bundle_assets is explicitly enabled).
+    def self.bundle?
+      (Merb.environment == 'production') ||
+      (!!Merb::Config[:bundle_assets])
+    end
+    
+    # Helpers for handling asset files.
+    module AssetHelpers
+      # :nodoc:
+      ASSET_FILE_EXTENSIONS = {
+        :javascript => ".js",
+        :stylesheet => ".css"
+      }
+      
+      # Returns the URI path to a particular asset file. If +local_path+ is
+      # true, returns the path relative to the Merb.root, not the public
+      # directory. Uses the path_prefix, if any is configured.
+      # 
+      # ==== Parameters
+      # asset_type<Symbol>:: Type of the asset (e.g. :javascript).
+      # filename<~to_s>:: The path to the file.
+      # local_path<Boolean>::
+      #   If true, the returned path will be relative to the Merb.root,
+      #   otherwise it will be the public URI path. Defaults to false.
+      #
+      # ==== Returns
+      # String:: The path to the asset.
+      #
+      # ==== Examples
+      #   asset_path(:javascript, :dingo)
+      #   # => "/javascripts/dingo.js"
+      #
+      #   asset_path(:javascript, :dingo, true)
+      #   # => "public/javascripts/dingo.js"
+      def asset_path(asset_type, filename, local_path = false)
+        filename = filename.to_s
+        if filename !~ /#{'\\' + ASSET_FILE_EXTENSIONS[asset_type]}\Z/
+          filename << ASSET_FILE_EXTENSIONS[asset_type]
+        end
+        filename = "/#{asset_type}s/#{filename}"
+        if local_path
+          return "public#{filename}"
+        else
+          return "#{Merb::Config[:path_prefix]}#{filename}"
+        end
+      end
+    end
+    
+    # Helper for creating unique paths to a file name
+    # Can increase speend for browsers that are limited to a certain number of connections per host 
+    # for downloading static files (css, js, images...)
+    class UniqueAssetPath
+      class << self
+        @@config = Merb::Plugins.config[:asset_helpers]
+        
+        # Builds the path to the file based on the name
+        # 
+        # ==== Parameters
+        # filename<String>:: Name of file to generate path for
+        #
+        # ==== Returns
+        # String:: The path to the asset.
+        #
+        # ==== Examples
+        #   build("/javascripts/my_fancy_script.js")
+        #   # => "https://assets5.my-awesome-domain.com/javascripts/my_fancy_script.js"
+        #
+        def build(filename)
+          #%{#{(USE_SSL ? 'https' : 'http')}://#{sprintf(@@config[:asset_domain],self.calculate_host_id(file))}.#{@@config[:domain]}/#{filename}}
+          path = @@config[:use_ssl] ? 'https://' : 'http://'
+          path << sprintf(@@config[:asset_domain],self.calculate_host_id(filename)) << ".#{@@config[:domain]}"
+          path << "/" if filename.index('/') != 0
+          path << filename
+        end
+      
+        protected
+        
+        # Calculates the id for the host
+        def calculate_host_id(filename)
+          ascii_total = 0
+          filename.each_byte {|byte|
+            ascii_total += byte
+          }
+          (ascii_total % @@config[:max_hosts] + 1)
+        end
+      end
+    end
+    
+    # An abstract class for bundling text assets into single files.
+    class AbstractAssetBundler
+      class << self
+        
+        # ==== Parameters
+        # &block:: A block to add as a post-bundle callback.
+        #
+        # ==== Examples
+        #   add_callback { |filename| `yuicompressor #{filename}` }
+        def add_callback(&block)
+          callbacks << block
+        end
+        alias_method :after_bundling, :add_callback
+        
+        # Retrieve existing callbacks.
+        #
+        # ==== Returns
+        # Array[Proc]:: An array of existing callbacks.
+        def callbacks
+          @callbacks ||= []
+          return @callbacks
+        end
+        
+        # The type of asset for which the bundler is responsible. Override
+        # this method in your bundler code.
+        #
+        # ==== Raises
+        # NotImplementedError:: This method is implemented by the bundler.
+        #
+        # ==== Returns
+        # Symbol:: The type of the asset
+        def asset_type
+          raise NotImplementedError, "should return a symbol for the first argument to be passed to asset_path"
+        end
+      end
+
+      # ==== Parameters
+      # name<~to_s>::
+      #   Name of the bundle. If name is true, it will be converted to :all.
+      # *files<String>:: Names of the files to bundle.
+      def initialize(name, *files)
+        @bundle_name = name == true ? :all : name
+        @bundle_filename = asset_path(self.class.asset_type, @bundle_name, true)
+        @files = files.map { |f| asset_path(self.class.asset_type, f, true) }
+      end
+      
+      # Creates the new bundled file, executing all the callbacks.
+      #
+      # ==== Returns
+      # Symbol:: Name of the bundle.
+      def bundle!
+        # TODO: Move this file check out into an in-memory cache. Also, push it out to the helper level so we don't have to create the helper object.
+        unless File.exist?(@bundle_filename)
+          bundle_files(@bundle_filename, *@files)
+          self.class.callbacks.each { |c| c.call(@bundle_filename) }
+        end
+        return @bundle_name
+      end
+      
+    protected
+      
+      include Merb::Assets::AssetHelpers # for asset_path
+      
+      # Bundle all the files into one.
+      #
+      # ==== Parameters
+      # filename<String>:: Name of the bundle file.
+      # *files<String>:: Filenames to be bundled.
+      def bundle_files(filename, *files)
+        File.open(filename, "w") do |f|
+          files.each { |file| f.puts(File.read(file)) }
+        end
+      end
+      
+    end
+    
+    # Bundles javascripts into a single file:
+    # 
+    #   javascripts/#{name}.js
+    class JavascriptAssetBundler < AbstractAssetBundler
+
+      # ==== Returns
+      # Symbol:: The asset type, i.e. :javascript.
+      def self.asset_type
+        :javascript
+      end
+    end
+    
+    # Bundles stylesheets into a single file:
+    # 
+    #   stylesheets/#{name}.css
+    class StylesheetAssetBundler < AbstractAssetBundler
+
+      # ==== Returns
+      # Symbol:: The asset type, i.e. :stylesheet.
+      def self.asset_type
+        :stylesheet
+      end
+    end
+    
+  end
+end

data/lib/merb-assets/assets_mixin.rb

@@ -0,0 +1,562 @@
+module Merb
+  # The AssetsMixin module provides a number of helper methods to views for
+  # linking to assets and other pages, dealing with JavaScript and CSS.
+  module AssetsMixin
+    include Merb::Assets::AssetHelpers
+    # :section: Accessing Assets
+    # Merb provides views with convenience methods for links images and other
+    # assets.
+
+    # ==== Parameters
+    # name<~to_s>:: The text of the link.
+    # url<~to_s>:: The URL to link to. Defaults to an empty string.
+    # opts<Hash>:: Additional HTML options for the link.
+    #    
+    # ==== Examples
+    #   link_to("The Merb home page", "http://www.merbivore.com/")
+    #     # => <a href="http://www.merbivore.com/">The Merb home page</a>
+    #
+    #   link_to("The Ruby home page", "http://www.ruby-lang.org", {'class' => 'special', 'target' => 'blank'})
+    #     # => <a href="http://www.ruby-lang.org" class="special" target="blank">The Ruby home page</a>
+    #
+    #   link_to p.title, "/blog/show/#{p.id}"
+    #     # => <a href="blog/show/13">The Entry Title</a>
+    #
+    def link_to(name, url='', opts={})
+      opts[:href] ||= url
+      %{<a #{ opts.to_xml_attributes }>#{name}</a>}
+    end
+  
+    # ==== Parameters
+    # img<~to_s>:: The image path.
+    # opts<Hash>:: Additional options for the image tag (see below).
+    #
+    # ==== Options (opts)
+    # :path<String>::
+    #   Sets the path prefix for the image. Defaults to "/images/" or whatever
+    #   is specified in Merb::Config. This is ignored if img is an absolute
+    #   path or full URL.
+    # 
+    # All other options set HTML attributes on the tag.
+    #
+    # ==== Examples
+    #   image_tag('foo.gif') 
+    #   # => <img src='/images/foo.gif' />
+    #   
+    #   image_tag('foo.gif', :class => 'bar') 
+    #   # => <img src='/images/foo.gif' class='bar' />
+    #
+    #   image_tag('foo.gif', :path => '/files/') 
+    #   # => <img src='/files/foo.gif' />
+    #
+    #   image_tag('http://test.com/foo.gif')
+    #   # => <img src="http://test.com/foo.gif">
+    #
+    #   image_tag('charts', :path => '/dynamic/')
+    #   or 
+    #   image_tag('/dynamic/charts')
+    #   # => <img src="/dynamic/charts">
+    def image_tag(img, opts={})
+      if img[0].chr == '/'
+        opts[:src] = img
+      else
+        opts[:path] ||= 
+          if img =~ %r{^https?://}
+            ''
+          else
+            if Merb::Config[:path_prefix]
+              Merb::Config[:path_prefix] + '/images/'
+            else
+              '/images/'
+            end
+          end
+        opts[:src] ||= opts.delete(:path) + img
+      end
+      %{<img #{ opts.to_xml_attributes } />}    
+    end
+
+    # :section: JavaScript related functions
+    #
+    
+    # ==== Parameters
+    # javascript<String>:: Text to escape for use in JavaScript.
+    #
+    # ==== Examples
+    #   escape_js("'Lorem ipsum!' -- Some guy")
+    #     # => "\\'Lorem ipsum!\\' -- Some guy"
+    #
+    #   escape_js("Please keep text\nlines as skinny\nas possible.")
+    #     # => "Please keep text\\nlines as skinny\\nas possible."
+    def escape_js(javascript)
+      (javascript || '').gsub('\\','\0\0').gsub(/\r\n|\n|\r/, "\\n").gsub(/["']/) { |m| "\\#{m}" }
+    end
+    
+    # ==== Parameters
+    # name<~to_s>:: The text in the link.
+    # function<~to_s>:: The onClick event in JavaScript.
+    #
+    # ==== Examples
+    #   link_to_function('Click me', "alert('hi!')")
+    #     # => <a href="#" onclick="alert('hi!'); return false;">Click me</a>
+    #
+    #   link_to_function('Add to cart', "item_total += 1; alert('Item added!');")
+    #     # => <a href="#" onclick="item_total += 1; alert('Item added!'); return false;">Add to cart</a>
+    def link_to_function(name, function)
+      %{<a href="#" onclick="#{function}; return false;">#{name}</a>}
+    end
+    
+    # ==== Parameters
+    # data<Object>::
+    #   Object to translate into JSON. If the object does not respond to
+    #   :to_json, then data.inspect.to_json is returned instead.
+    #
+    # ==== Examples
+    #   js({'user' => 'Lewis', 'page' => 'home'})
+    #    # => "{\"user\":\"Lewis\",\"page\":\"home\"}"
+    #
+    #   js([ 1, 2, {"a"=>3.141}, false, true, nil, 4..10 ])
+    #     # => "[1,2,{\"a\":3.141},false,true,null,\"4..10\"]"
+    def js(data)
+      if data.respond_to? :to_json
+        data.to_json
+      else
+        data.inspect.to_json
+      end
+    end
+      
+    # :section: External JavaScript and Stylesheets
+    #
+    # You can use require_js(:prototype) or require_css(:shinystyles)
+    # from any view or layout, and the scripts will only be included once
+    # in the head of the final page. To get this effect, the head of your
+    # layout you will need to include a call to include_required_js and
+    # include_required_css.
+    #
+    # ==== Examples
+    #   # File: app/views/layouts/application.html.erb
+    #
+    #   <html>
+    #     <head>
+    #       <%= include_required_js %>
+    #       <%= include_required_css %>
+    #     </head>
+    #     <body>
+    #       <%= catch_content :layout %>
+    #     </body>
+    #   </html>
+    # 
+    #   # File: app/views/whatever/_part1.herb
+    #
+    #   <% require_js  'this' -%>
+    #   <% require_css 'that', 'another_one' -%>
+    # 
+    #   # File: app/views/whatever/_part2.herb
+    #
+    #   <% require_js 'this', 'something_else' -%>
+    #   <% require_css 'that' -%>
+    #
+    #   # File: app/views/whatever/index.herb
+    #
+    #   <%= partial(:part1) %>
+    #   <%= partial(:part2) %>
+    #
+    #   # Will generate the following in the final page...
+    #   <html>
+    #     <head>
+    #       <script src="/javascripts/this.js" type="text/javascript"></script>
+    #       <script src="/javascripts/something_else.js" type="text/javascript"></script>
+    #       <link href="/stylesheets/that.css" media="all" rel="Stylesheet" type="text/css"/>
+    #       <link href="/stylesheets/another_one.css" media="all" rel="Stylesheet" type="text/css"/>
+    #     </head>
+    #     .
+    #     .
+    #     .
+    #   </html>
+    #
+    # See each method's documentation for more information.
+    
+    # :section: Bundling Asset Files
+    # 
+    # The key to making a fast web application is to reduce both the amount of
+    # data transfered and the number of client-server interactions. While having
+    # many small, module Javascript or stylesheet files aids in the development
+    # process, your web application will benefit from bundling those assets in
+    # the production environment.
+    # 
+    # An asset bundle is a set of asset files which are combined into a single
+    # file. This reduces the number of requests required to render a page, and
+    # can reduce the amount of data transfer required if you're using gzip
+    # encoding.
+    # 
+    # Asset bundling is always enabled in production mode, and can be optionally
+    # enabled in all environments by setting the <tt>:bundle_assets</tt> value
+    # in <tt>config/merb.yml</tt> to +true+.
+    # 
+    # ==== Examples
+    # 
+    # In the development environment, this:
+    # 
+    #   js_include_tag :prototype, :lowpro, :bundle => true
+    # 
+    # will produce two <script> elements. In the production mode, however, the
+    # two files will be concatenated in the order given into a single file,
+    # <tt>all.js</tt>, in the <tt>public/javascripts</tt> directory.
+    # 
+    # To specify a different bundle name:
+    # 
+    #   css_include_tag :typography, :whitespace, :bundle => :base
+    #   css_include_tag :header, :footer, :bundle => "content"
+    #   css_include_tag :lightbox, :images, :bundle => "lb.css"
+    # 
+    # (<tt>base.css</tt>, <tt>content.css</tt>, and <tt>lb.css</tt> will all be
+    # created in the <tt>public/stylesheets</tt> directory.)
+    # 
+    # == Callbacks
+    # 
+    # To use a Javascript or CSS compressor, like JSMin or YUI Compressor:
+    # 
+    #   Merb::Assets::JavascriptAssetBundler.add_callback do |filename|
+    #     system("/usr/local/bin/yui-compress #{filename}")
+    #   end
+    #   
+    #   Merb::Assets::StylesheetAssetBundler.add_callback do |filename|
+    #     system("/usr/local/bin/css-min #{filename}")
+    #   end
+    # 
+    # These blocks will be run after a bundle is created.
+    # 
+    # == Bundling Required Assets
+    # 
+    # Combining the +require_css+ and +require_js+ helpers with bundling can be
+    # problematic. You may want to separate out the common assets for your
+    # application -- Javascript frameworks, common CSS, etc. -- and bundle those
+    # in a "base" bundle. Then, for each section of your site, bundle the
+    # required assets into a section-specific bundle.
+    # 
+    # <b>N.B.: If you bundle an inconsistent set of assets with the same name,
+    # you will have inconsistent results. Be thorough and test often.</b>
+    # 
+    # ==== Example
+    # 
+    # In your application layout:
+    # 
+    #   js_include_tag :prototype, :lowpro, :bundle => :base
+    # 
+    # In your controller layout:
+    # 
+    #   require_js :bundle => :posts
+    
+    # The require_js method can be used to require any JavaScript file anywhere
+    # in your templates. Regardless of how many times a single script is
+    # included with require_js, Merb will only include it once in the header.
+    #
+    # ==== Parameters
+    # *js<~to_s>:: JavaScript files to include.
+    #
+    # ==== Examples
+    #   <% require_js 'jquery' %>
+    #   # A subsequent call to include_required_js will render...
+    #   # => <script src="/javascripts/jquery.js" type="text/javascript"></script>
+    #
+    #   <% require_js 'jquery', 'effects' %>
+    #   # A subsequent call to include_required_js will render...
+    #   # => <script src="/javascripts/jquery.js" type="text/javascript"></script>
+    #   #    <script src="/javascripts/effects.js" type="text/javascript"></script>
+    #
+    def require_js(*js)
+      @required_js ||= []
+      @required_js |= js
+    end
+    
+    # The require_css method can be used to require any CSS file anywhere in
+    # your templates. Regardless of how many times a single stylesheet is
+    # included with require_css, Merb will only include it once in the header.
+    #
+    # ==== Parameters
+    # *css<~to_s>:: CSS files to include.
+    #
+    # ==== Examples
+    #   <% require_css('style') %>
+    #   # A subsequent call to include_required_css will render...
+    #   # => <link href="/stylesheets/style.css" media="all" rel="Stylesheet" type="text/css"/>
+    #
+    #   <% require_css('style', 'ie-specific') %>
+    #   # A subsequent call to include_required_css will render...
+    #   # => <link href="/stylesheets/style.css" media="all" rel="Stylesheet" type="text/css"/>
+    #   #    <link href="/stylesheets/ie-specific.css" media="all" rel="Stylesheet" type="text/css"/>
+    #
+    def require_css(*css)
+      @required_css ||= []
+      @required_css |= css
+    end
+    
+    # A method used in the layout of an application to create +<script>+ tags
+    # to include JavaScripts required in in templates and subtemplates using
+    # require_js.
+    # 
+    # ==== Parameters
+    # options<Hash>:: Options to pass to js_include_tag.
+    # 
+    # ==== Returns
+    # String:: The JavaScript tag.
+    #
+    # ==== Examples
+    #   # my_action.herb has a call to require_js 'jquery'
+    #   # File: layout/application.html.erb
+    #   include_required_js
+    #   # => <script src="/javascripts/jquery.js" type="text/javascript"></script>
+    #
+    #   # my_action.herb has a call to require_js 'jquery', 'effects', 'validation'
+    #   # File: layout/application.html.erb
+    #   include_required_js
+    #   # => <script src="/javascripts/jquery.js" type="text/javascript"></script>
+    #   #    <script src="/javascripts/effects.js" type="text/javascript"></script>
+    #   #    <script src="/javascripts/validation.js" type="text/javascript"></script>
+    #
+    def include_required_js(options = {})
+      return '' if @required_js.nil?
+      js_include_tag(*(@required_js + [options]))
+    end
+    
+    # A method used in the layout of an application to create +<link>+ tags for
+    # CSS stylesheets required in in templates and subtemplates using
+    # require_css.
+    # 
+    # ==== Parameters
+    # options<Hash>:: Options to pass to css_include_tag.
+    # 
+    # ==== Returns
+    # String:: The CSS tag.
+    # 
+    # ==== Examples
+    #   # my_action.herb has a call to require_css 'style'
+    #   # File: layout/application.html.erb
+    #   include_required_css
+    #   # => <link href="/stylesheets/style.css" media="all" rel="Stylesheet" type="text/css"/>
+    #
+    #   # my_action.herb has a call to require_js 'style', 'ie-specific'
+    #   # File: layout/application.html.erb
+    #   include_required_css
+    #   # => <link href="/stylesheets/style.css" media="all" rel="Stylesheet" type="text/css"/>
+    #   #    <link href="/stylesheets/ie-specific.css" media="all" rel="Stylesheet" type="text/css"/>
+    #
+    def include_required_css(options = {})
+      return '' if @required_css.nil?
+      css_include_tag(*(@required_css + [options]))
+    end
+    
+    # ==== Parameters
+    # *scripts::
+    #   The scripts to include. If the last element is a Hash, it will be used
+    #   as options (see below). If ".js" is left out from the script names, it
+    #   will be added to them.
+    #
+    # ==== Options
+    # :bundle<~to_s>::
+    #   The name of the bundle the scripts should be combined into.
+    #
+    # ==== Returns
+    # String:: The JavaScript include tag(s).
+    #
+    # ==== Examples
+    #   js_include_tag 'jquery'
+    #   # => <script src="/javascripts/jquery.js" type="text/javascript"></script>
+    #
+    #   js_include_tag 'moofx.js', 'upload'
+    #   # => <script src="/javascripts/moofx.js" type="text/javascript"></script>
+    #   #    <script src="/javascripts/upload.js" type="text/javascript"></script>
+    #
+    #   js_include_tag :effects
+    #   # => <script src="/javascripts/effects.js" type="text/javascript"></script>
+    #
+    #   js_include_tag :jquery, :validation
+    #   # => <script src="/javascripts/jquery.js" type="text/javascript"></script>
+    #   #    <script src="/javascripts/validation.js" type="text/javascript"></script>
+    #
+    def js_include_tag(*scripts)
+      options = scripts.last.is_a?(Hash) ? scripts.pop : {}
+      return nil if scripts.empty?
+      
+      if (bundle_name = options[:bundle]) && Merb::Assets.bundle? && scripts.size > 1
+        bundler = Merb::Assets::JavascriptAssetBundler.new(bundle_name, *scripts)
+        bundled_asset = bundler.bundle!
+        return js_include_tag(bundled_asset)
+      end
+
+      tags = ""
+
+      for script in scripts
+        attrs = {
+          :src => asset_path(:javascript, script),
+          :type => "text/javascript"
+        }
+        tags << %Q{<script #{attrs.to_xml_attributes}></script>}
+      end
+
+      return tags
+    end
+    
+    # ==== Parameters
+    # *stylesheets::
+    #   The stylesheets to include. If the last element is a Hash, it will be
+    #   used as options (see below). If ".css" is left out from the stylesheet
+    #   names, it will be added to them.
+    #
+    # ==== Options
+    # :bundle<~to_s>::
+    #   The name of the bundle the stylesheets should be combined into.
+    # :media<~to_s>::
+    #   The media attribute for the generated link element. Defaults to :all.
+    #
+    # ==== Returns
+    # String:: The CSS include tag(s).
+    #
+    # ==== Examples
+    #   css_include_tag 'style'
+    #   # => <link href="/stylesheets/style.css" media="all" rel="Stylesheet" type="text/css" charset="utf-8" />
+    #
+    #   css_include_tag 'style.css', 'layout'
+    #   # => <link href="/stylesheets/style.css" media="all" rel="Stylesheet" type="text/css" charset="utf-8" />
+    #   #    <link href="/stylesheets/layout.css" media="all" rel="Stylesheet" type="text/css" charset="utf-8" />
+    #
+    #   css_include_tag :menu
+    #   # => <link href="/stylesheets/menu.css" media="all" rel="Stylesheet" type="text/css" charset="utf-8" />
+    #
+    #   css_include_tag :style, :screen
+    #   # => <link href="/stylesheets/style.css" media="all" rel="Stylesheet" type="text/css" charset="utf-8" />
+    #   #    <link href="/stylesheets/screen.css" media="all" rel="Stylesheet" type="text/css" charset="utf-8" />
+    # 
+    #  css_include_tag :style, :media => :print
+    #  # => <link href="/stylesheets/style.css" media="print" rel="Stylesheet" type="text/css" charset="utf-8" />
+    #
+    #  css_include_tag :style, :charset => 'iso-8859-1'
+    #  # => <link href="/stylesheets/style.css" media="print" rel="Stylesheet" type="text/css" charset="iso-8859-1" />
+    def css_include_tag(*stylesheets)
+      options = stylesheets.last.is_a?(Hash) ? stylesheets.pop : {}
+      return nil if stylesheets.empty?
+      
+      if (bundle_name = options[:bundle]) && Merb::Assets.bundle? && stylesheets.size > 1
+        bundler = Merb::Assets::StylesheetAssetBundler.new(bundle_name, *stylesheets)
+        bundled_asset = bundler.bundle!
+        return css_include_tag(bundled_asset)
+      end
+
+      tags = ""
+
+      for stylesheet in stylesheets
+        attrs = {
+          :href => asset_path(:stylesheet, stylesheet),
+          :type => "text/css",
+          :rel => "Stylesheet",
+          :charset => options[:charset] || 'utf-8',
+          :media => options[:media] || :all
+        }
+        tags << %Q{<link #{attrs.to_xml_attributes} />}
+      end
+
+      return tags
+    end
+    
+    # ==== Parameters
+    # *assets::
+    #   The assets to include. These should be the full paths to any static served file
+    #
+    # ==== Returns
+    # Array:: Full unique paths to assets OR
+    # String:: if only a single path is requested
+    # ==== Examples
+    #  uniq_path("/javascripts/my.js","/javascripts/my.css")
+    #  #=> ["http://assets2.my-awesome-domain.com/javascripts/my.js", "http://assets2.my-awesome-domain.com/javascripts/my.css"]
+    #
+    #  uniq_path(["/javascripts/my.js","/stylesheets/my.css"])
+    #  #=> ["http://assets2.my-awesome-domain.com/javascripts/my.js", "http://assets1.my-awesome-domain.com/stylesheets/my.css"]
+    #
+    #  uniq_path(%w(/javascripts/my.js /stylesheets/my.css))
+    #  #=> ["http://assets2.my-awesome-domain.com/javascripts/my.js", "http://assets1.my-awesome-domain.com/stylesheets/my.css"]
+    #
+    #  uniq_path('/stylesheets/somearbitrary.css')
+    #  #=> "http://assets3.my-awesome-domain.com/stylesheets/somearbitrary.css"
+    #
+    #  uniq_path('/images/hostsexypicture.jpg')
+    #  #=>"http://assets1.my-awesome-domain.com/images/hostsexypicture.jpg"
+    def uniq_path(*assets)      
+      paths = []
+      assets.collect.flatten.each do |filename|
+        paths.push(UniqueAssetPath.build(filename))
+      end
+      paths.length > 1 ? paths : paths.first
+    end
+    
+    # ==== Parameters
+    # *assets::
+    #   Creates unique paths for javascript files (prepends "/javascripts" and appends ".js")
+    #
+    # ==== Returns
+    # Array:: Full unique paths to assets OR
+    # String:: if only a single path is requested
+    # ==== Examples
+    #  uniq_js_path("my")
+    #  #=> "http://assets2.my-awesome-domain.com/javascripts/my.js"
+    #
+    #  uniq_js_path(["admin/secrets","home/signup"])
+    #  #=> ["http://assets2.my-awesome-domain.com/javascripts/admin/secrets.js", 
+    #         "http://assets1.my-awesome-domain.com/javascripts/home/signup.js"]
+    def uniq_js_path(*assets)
+      paths = []
+      assets.collect.flatten.each do |filename|
+        paths.push(UniqueAssetPath.build(asset_path(:javascript,filename,true)))
+      end
+      paths.length > 1 ? paths : paths.first
+    end
+    
+    # ==== Parameters
+    # *assets::
+    #   Creates unique paths for stylesheet files (prepends "/stylesheets" and appends ".css")
+    #
+    # ==== Returns
+    # Array:: Full unique paths to assets OR
+    # String:: if only a single path is requested
+    # ==== Examples
+    #  uniq_css_path("my")
+    #  #=> "http://assets2.my-awesome-domain.com/stylesheets/my.css"
+    #
+    #  uniq_css_path(["admin/secrets","home/signup"])
+    #  #=> ["http://assets2.my-awesome-domain.com/stylesheets/admin/secrets.css", 
+    #         "http://assets1.my-awesome-domain.com/stylesheets/home/signup.css"]
+    def uniq_css_path(*assets)
+      paths = []
+      assets.collect.flatten.each do |filename|
+        paths.push(UniqueAssetPath.build(asset_path(:stylesheet,filename,true)))
+      end
+      paths.length > 1 ? paths : paths.first
+    end
+    
+    # ==== Parameters
+    # *assets::
+    #   As js_include_tag but has unique path
+    #
+    # ==== Returns
+    # Array:: Full unique paths to assets OR
+    # String:: if only a single path is requested
+    # ==== Examples
+    #  uniq_js_tag("my")
+    #  #=> <script type="text/javascript" src="http://assets2.my-awesome-domain.com/javascripts/my.js"></script>
+    def uniq_js_tag(*assets)
+      js_include_tag(uniq_js_path(assets))
+    end
+    
+    # ==== Parameters
+    # *assets::
+    #   As uniq_css_tag but has unique path
+    #
+    # ==== Returns
+    # Array:: Full unique paths to assets OR
+    # String:: if only a single path is requested
+    # ==== Examples
+    #  uniq_css_tag("my")
+    #  #=> <link href="http://assets2.my-awesome-domain.com/stylesheets/my.css" type="text/css" />
+    def uniq_css_tag(*assets)
+      css_include_tag(uniq_css_path(assets))
+    end
+  end
+end

metadata

@@ -0,0 +1,70 @@
+--- !ruby/object:Gem::Specification 
+name: merb-assets
+version: !ruby/object:Gem::Version 
+  version: 0.9.2
+platform: ruby
+authors: 
+- Ezra Zygmuntowicz
+autorequire: merb-assets
+bindir: bin
+cert_chain: []
+
+date: 2008-03-24 00:00:00 -05:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: merb-core
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 0.9.2
+    version: 
+description: Merb plugin that provides the helpers for assets and asset bundling
+email: ez@engineyard.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README
+- LICENSE
+- TODO
+files: 
+- LICENSE
+- README
+- Rakefile
+- TODO
+- lib/merb-assets
+- lib/merb-assets/assets.rb
+- lib/merb-assets/assets_mixin.rb
+- lib/merb-assets.rb
+has_rdoc: true
+homepage: http://merb-plugins.rubyforge.org/merb-assets/
+post_install_message: 
+rdoc_options: []
+
+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: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.0.1
+signing_key: 
+specification_version: 2
+summary: Merb plugin that provides the helpers for assets and asset bundling
+test_files: []
+