sprockets-helpers 0.5.0 → 0.6.0

data/README.md

@@ -1,16 +1,16 @@
 sprockets-helpers
 =================
 
-**Asset path helpers for Sprockets 2.0 applications**
+**Asset path helpers for Sprockets 2.x applications**
 
-Sprockets::Helpers adds the asset_path helpers, familiar to Rails developers, to Sprockets 2.0 assets and application.
+Sprockets::Helpers adds the asset_path helpers, familiar to Rails developers, to Sprockets 2.x assets and applications.
 
 ### Features
 
-* Includes image_path, javascript_path, & stylesheet_path helpers.
+* Includes helpers for image, javascript, stylesheet, font, video, & audio assets.
 * Automatically appends extension if necessary.
 * Optionally outputs digest paths.
-* Falls back to file paths in the public directory.
+* Falls back to file paths in the public directory & adds cache busting timestamp.
 
 
 Installation

data/lib/sprockets/helpers.rb

@@ -107,6 +107,78 @@ module Sprockets
     end
     alias_method :path_to_asset, :asset_path
     
+    # Computes the path to a audio asset either in the Sprockets environment
+    # or the public directory. External URIs are untouched.
+    #
+    # ==== Examples
+    #
+    # With files within Sprockets:
+    #
+    #   audio_path 'audio.mp3'            # => '/assets/audio.mp3'
+    #   audio_path 'subfolder/audio.mp3'  # => '/assets/subfolder/audio.mp3'
+    #   audio_path '/subfolder/audio.mp3' # => '/assets/subfolder/audio.mp3'
+    #
+    # With files outside of Sprockets:
+    #
+    #   audio_path 'audio'                                # => '/audios/audio'
+    #   audio_path 'audio.mp3'                            # => '/audios/audio.mp3'
+    #   audio_path 'subfolder/audio.mp3'                  # => '/audios/subfolder/audio.mp3'
+    #   audio_path '/subfolder/audio.mp3                  # => '/subfolder/audio.mp3'
+    #   audio_path 'http://www.example.com/img/audio.mp3' # => 'http://www.example.com/img/audio.mp3'
+    #
+    def audio_path(source, options = {})
+      asset_path source, { :dir => 'audios' }.merge(options)
+    end
+    alias_method :path_to_audio, :audio_path
+    
+    # Computes the path to a font asset either in the Sprockets environment
+    # or the public directory. External URIs are untouched.
+    #
+    # ==== Examples
+    #
+    # With files within Sprockets:
+    #
+    #   font_path 'font.ttf'            # => '/assets/font.ttf'
+    #   font_path 'subfolder/font.ttf'  # => '/assets/subfolder/font.ttf'
+    #   font_path '/subfolder/font.ttf' # => '/assets/subfolder/font.ttf'
+    #
+    # With files outside of Sprockets:
+    #
+    #   font_path 'font'                                # => '/fonts/font'
+    #   font_path 'font.ttf'                            # => '/fonts/font.ttf'
+    #   font_path 'subfolder/font.ttf'                  # => '/fonts/subfolder/font.ttf'
+    #   font_path '/subfolder/font.ttf                  # => '/subfolder/font.ttf'
+    #   font_path 'http://www.example.com/img/font.ttf' # => 'http://www.example.com/img/font.ttf'
+    #
+    def font_path(source, options = {})
+      asset_path source, { :dir => 'fonts' }.merge(options)
+    end
+    alias_method :path_to_font, :font_path
+    
+    # Computes the path to an image asset either in the Sprockets environment
+    # or the public directory. External URIs are untouched.
+    #
+    # ==== Examples
+    #
+    # With files within Sprockets:
+    #
+    #   image_path 'edit.png'        # => '/assets/edit.png'
+    #   image_path 'icons/edit.png'  # => '/assets/icons/edit.png'
+    #   image_path '/icons/edit.png' # => '/assets/icons/edit.png'
+    #
+    # With files outside of Sprockets:
+    #
+    #   image_path 'edit'                                # => '/images/edit'
+    #   image_path 'edit.png'                            # => '/images/edit.png'
+    #   image_path 'icons/edit.png'                      # => '/images/icons/edit.png'
+    #   image_path '/icons/edit.png'                     # => '/icons/edit.png'
+    #   image_path 'http://www.example.com/img/edit.png' # => 'http://www.example.com/img/edit.png'
+    #
+    def image_path(source, options = {})
+      asset_path source, { :dir => 'images' }.merge(options)
+    end
+    alias_method :path_to_image, :image_path
+    
     # Computes the path to a javascript asset either in the Sprockets
     # environment or the public directory. If the +source+ filename has no extension,
     # <tt>.js</tt> will be appended. External URIs are untouched.
@@ -157,29 +229,29 @@ module Sprockets
     end
     alias_method :path_to_stylesheet, :stylesheet_path
     
-    # Computes the path to an image asset either in the Sprockets environment
+    # Computes the path to a video asset either in the Sprockets environment
     # or the public directory. External URIs are untouched.
     #
     # ==== Examples
     #
     # With files within Sprockets:
     #
-    #   image_path 'edit.png'        # => '/assets/edit.png'
-    #   image_path 'icons/edit.png'  # => '/assets/icons/edit.png'
-    #   image_path '/icons/edit.png' # => '/assets/icons/edit.png'
+    #   video_path 'video.mp4'            # => '/assets/video.mp4'
+    #   video_path 'subfolder/video.mp4'  # => '/assets/subfolder/video.mp4'
+    #   video_path '/subfolder/video.mp4' # => '/assets/subfolder/video.mp4'
     #
     # With files outside of Sprockets:
     #
-    #   image_path 'edit'                                # => '/images/edit'
-    #   image_path 'edit.png'                            # => '/images/edit.png'
-    #   image_path 'icons/edit.png'                      # => '/images/icons/edit.png'
-    #   image_path '/icons/edit.png'                     # => '/icons/edit.png'
-    #   image_path 'http://www.example.com/img/edit.png' # => 'http://www.example.com/img/edit.png'
+    #   video_path 'video'                                # => '/videos/video'
+    #   video_path 'video.mp4'                            # => '/videos/video.mp4'
+    #   video_path 'subfolder/video.mp4'                  # => '/videos/subfolder/video.mp4'
+    #   video_path '/subfolder/video.mp4                  # => '/subfolder/video.mp4'
+    #   video_path 'http://www.example.com/img/video.mp4' # => 'http://www.example.com/img/video.mp4'
     #
-    def image_path(source, options = {})
-      asset_path source, { :dir => 'images' }.merge(options)
+    def video_path(source, options = {})
+      asset_path source, { :dir => 'videos' }.merge(options)
     end
-    alias_method :path_to_image, :image_path
+    alias_method :path_to_video, :video_path
     
     protected
     

data/lib/sprockets/helpers/version.rb

@@ -1,5 +1,5 @@
 module Sprockets
   module Helpers
-    VERSION = '0.5.0'
+    VERSION = '0.6.0'
   end
 end

data/spec/sprockets-helpers_spec.rb

@@ -298,4 +298,28 @@ describe Sprockets::Helpers do
       end
     end
   end
+  
+  describe '#font_path' do
+    context 'with regular files' do
+      it 'prepends the fonts dir' do
+        context.font_path('font.ttf').should == '/fonts/font.ttf'
+      end
+    end
+  end
+  
+  describe '#video_path' do
+    context 'with regular files' do
+      it 'prepends the videos dir' do
+        context.video_path('video.mp4').should == '/videos/video.mp4'
+      end
+    end
+  end
+  
+  describe '#audio_path' do
+    context 'with regular files' do
+      it 'prepends the audios dir' do
+        context.audio_path('audio.mp3').should == '/audios/audio.mp3'
+      end
+    end
+  end
 end

metadata

@@ -1,103 +1,107 @@
---- !ruby/object:Gem::Specification
+--- !ruby/object:Gem::Specification 
 name: sprockets-helpers
-version: !ruby/object:Gem::Version
-  version: 0.5.0
+version: !ruby/object:Gem::Version 
+  hash: 7
   prerelease: 
+  segments: 
+  - 0
+  - 6
+  - 0
+  version: 0.6.0
 platform: ruby
-authors:
+authors: 
 - Pete Browne
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-06-21 00:00:00.000000000 Z
-dependencies:
-- !ruby/object:Gem::Dependency
-  name: sprockets
-  requirement: !ruby/object:Gem::Requirement
+
+date: 2012-06-24 00:00:00 -05:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  requirement: &id001 !ruby/object:Gem::Requirement 
     none: false
-    requirements:
+    requirements: 
     - - ~>
-      - !ruby/object:Gem::Version
-        version: '2.0'
-  type: :runtime
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 2
+        - 0
+        version: "2.0"
+  version_requirements: *id001
+  name: sprockets
   prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
+  type: :runtime
+- !ruby/object:Gem::Dependency 
+  requirement: &id002 !ruby/object:Gem::Requirement 
     none: false
-    requirements:
+    requirements: 
     - - ~>
-      - !ruby/object:Gem::Version
-        version: '2.0'
-- !ruby/object:Gem::Dependency
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        - 4
+        version: "0.4"
+  version_requirements: *id002
   name: appraisal
-  requirement: !ruby/object:Gem::Requirement
-    none: false
-    requirements:
-    - - ~>
-      - !ruby/object:Gem::Version
-        version: '0.4'
-  type: :development
   prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
+  type: :development
+- !ruby/object:Gem::Dependency 
+  requirement: &id003 !ruby/object:Gem::Requirement 
     none: false
-    requirements:
+    requirements: 
     - - ~>
-      - !ruby/object:Gem::Version
-        version: '0.4'
-- !ruby/object:Gem::Dependency
+      - !ruby/object:Gem::Version 
+        hash: 15
+        segments: 
+        - 2
+        - 6
+        version: "2.6"
+  version_requirements: *id003
   name: rspec
-  requirement: !ruby/object:Gem::Requirement
-    none: false
-    requirements:
-    - - ~>
-      - !ruby/object:Gem::Version
-        version: '2.6'
-  type: :development
   prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
+  type: :development
+- !ruby/object:Gem::Dependency 
+  requirement: &id004 !ruby/object:Gem::Requirement 
     none: false
-    requirements:
+    requirements: 
     - - ~>
-      - !ruby/object:Gem::Version
-        version: '2.6'
-- !ruby/object:Gem::Dependency
+      - !ruby/object:Gem::Version 
+        hash: 11
+        segments: 
+        - 1
+        - 2
+        version: "1.2"
+  version_requirements: *id004
   name: test-construct
-  requirement: !ruby/object:Gem::Requirement
-    none: false
-    requirements:
-    - - ~>
-      - !ruby/object:Gem::Version
-        version: '1.2'
-  type: :development
   prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
+  type: :development
+- !ruby/object:Gem::Dependency 
+  requirement: &id005 !ruby/object:Gem::Requirement 
     none: false
-    requirements:
-    - - ~>
-      - !ruby/object:Gem::Version
-        version: '1.2'
-- !ruby/object:Gem::Dependency
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  version_requirements: *id005
   name: rake
-  requirement: !ruby/object:Gem::Requirement
-    none: false
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
   prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    none: false
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: '0'
+  type: :development
 description: Asset path helpers for Sprockets 2.x applications
-email:
+email: 
 - me@petebrowne.com
 executables: []
+
 extensions: []
+
 extra_rdoc_files: []
-files:
+
+files: 
 - .gitignore
 - Appraisals
 - Gemfile
@@ -119,36 +123,40 @@ files:
 - spec/spec_helper.rb
 - spec/sprockets-helpers_spec.rb
 - sprockets-helpers.gemspec
+has_rdoc: true
 homepage: https://github.com/petebrowne/sprockets-helpers
 licenses: []
+
 post_install_message: 
 rdoc_options: []
-require_paths:
+
+require_paths: 
 - lib
-required_ruby_version: !ruby/object:Gem::Requirement
+required_ruby_version: !ruby/object:Gem::Requirement 
   none: false
-  requirements:
-  - - ! '>='
-    - !ruby/object:Gem::Version
-      version: '0'
-      segments:
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
       - 0
-      hash: -831447907
-required_rubygems_version: !ruby/object:Gem::Requirement
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
   none: false
-  requirements:
-  - - ! '>='
-    - !ruby/object:Gem::Version
-      version: '0'
-      segments:
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
       - 0
-      hash: -831447907
+      version: "0"
 requirements: []
+
 rubyforge_project: sprockets-helpers
-rubygems_version: 1.8.23
+rubygems_version: 1.6.2
 signing_key: 
 specification_version: 3
 summary: Asset path helpers for Sprockets 2.x applications
-test_files:
+test_files: 
 - spec/spec_helper.rb
 - spec/sprockets-helpers_spec.rb