rapper 0.2.0 → 0.2.1

data/README.markdown

@@ -71,7 +71,14 @@ The above definition will create two asset files: `public/assets/base.js` and `p
 
 ## View helpers
 
-Rapper provides helper methods to generate HTML include tags for your assets in the `Rapper::ViewHelpers`. Simply `include` it in the appropriate place for your web app / framework / widget / whatever. It's automaticallly included for Merb.
+Rapper provides helper methods to generate HTML include tags for your assets in the `Rapper::ViewHelpers` module. Simply `include` it in the appropriate place for your web app / framework / widget / spaceship / row boat / whatever. It's automaticallly included for Merb because Merb people are notoriously lazy.
+
+Rapper's view helpers respect your `bundle` setting. If it is `true`, a singe include tag for the joined asset will be returned. If bundling is `false`, it will return include tags for every component file of the asset (as a single string).
+
+Rapper provides helper methods for each definition type. For instance, if you have "javascripts.yml" and "stylesheets.yml" definition files, Rapper will provide `rapper_javascripts_tag` and `rapper_stylesheets_tag` helper methods. Just pass the name of the asset to the helper method as a symbol and the correct HTML will be returned:
+
+    rapper_stylesheets_tag :mootools
+    # <script src="/javascripts/assets/mootools.js"></script>
 
 ## Versioning
 
@@ -114,11 +121,14 @@ Rapper's got a Gemfile. You know what to do.
 * Watch for CoffeeScript changes and automatically compile
 * Watch for Sass changes and automatically compile
 * Per-asset configuration overrides
-* Sinatra helpers
-* Rails helpers
+* Auto-setup Sinatra helpers (?)
+* Auto-setup Rails helpers (?)
 
 ## Version history
 
+* **0.2.1** - Add tag_files() to get all file paths for a given asset.
+* **0.2.0** - Custom asset destination roots, fix Rake task.
+* **0.1.1** - Rake tasks.
 * **0.1.0** - View helpers.
 * **0.0.3** - New `Definition` object to make working with definitions significantly easier, don't re-package assets that don't need re-packaging.
 * **0.0.2** - Compression now works and is specced.

data/VERSION

@@ -1 +1 @@
-0.2.0
+0.2.1

data/lib/rapper/html_tags.rb

@@ -30,7 +30,7 @@ module Rapper
     
     # Build a CSS tag for an asset.
     # 
-    # @param [Symbol] name Name of the asset to build a `<link>` tag for.
+    # @param [Symbol] type Definition type.
     # 
     # @param [Symbol] name Name of the asset to build a `<link>` tag for.
     # 
@@ -40,6 +40,24 @@ module Rapper
       self.get_tag( CssTag, type, name )
     end
     
+    # Get all paths for a given asset. If bundling is turned on, a one-item
+    # array is returned containing the path to the asset file. Otherwise, an
+    # array of all component paths for the asset are returned.
+    # 
+    # @param [Symbol] type Definition type.
+    # 
+    # @param [Symbol] name Name of the asset to get paths for.
+    # 
+    # @return [String<Array>] All files that comprise the given asset.
+    def tag_files( type, name )
+      definition = @definitions[type]
+      if self.get_config( "bundle" )
+        Array( definition.asset_path( name, definition.asset_tag_root ) )
+      else
+        definition.component_paths( name, definition.component_tag_root )
+      end
+    end
+    
     protected
     
     def get_tag( klass, type, name )
@@ -50,15 +68,9 @@ module Rapper
         version = definition.get_version( name )
       end
       
-      if self.get_config( "bundle" )
-        path = definition.asset_path( name, definition.asset_tag_root )
+      tag_files( type, name ).map do |path|
         klass.send( :for, path, version, style )
-      else
-        paths = definition.component_paths( name, definition.component_tag_root )
-        paths.map do |path|
-          klass.send( :for, path, version, style )
-        end.join( "\n" )
-      end
+      end.join( "\n" )
     end
     
     # Represents an HTML tag.

data/rapper.gemspec

@@ -5,7 +5,7 @@
 
 Gem::Specification.new do |s|
   s.name = %q{rapper}
-  s.version = "0.2.0"
+  s.version = "0.2.1"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Tyson Tate"]

data/spec/rapper_spec.rb

@@ -67,6 +67,14 @@ describe Rapper do
         ]
       ]
     end
+    
+    it "provides tag files" do
+      rapper = Rapper::Engine.new( "spec/fixtures/config/assets.yml", "test" )
+      rapper.tag_files( "javascripts", "multiple_files" ).should == ["/javascripts/assets/multiple_files.js"]
+      
+      rapper = Rapper::Engine.new( "spec/fixtures/config/assets.yml", "test_no_bundle" )
+      rapper.tag_files( "javascripts", "multiple_files" ).should == ["/javascripts/simple_1.js", "/javascripts/simple_2.js"]
+    end
   end
   
   describe "logging" do

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: rapper
 version: !ruby/object:Gem::Version 
-  hash: 23
+  hash: 21
   prerelease: 
   segments: 
   - 0
   - 2
-  - 0
-  version: 0.2.0
+  - 1
+  version: 0.2.1
 platform: ruby
 authors: 
 - Tyson Tate