require 'sprockets'
require 'sprockets/helpers/version'
require 'sprockets/helpers/base_path'
require 'sprockets/helpers/asset_path'
require 'sprockets/helpers/file_path'
require 'sprockets/helpers/manifest_path'
require 'uri'
module Sprockets
module Helpers
class << self
# Link to assets from a dedicated server.
attr_accessor :asset_host
# When true, the asset paths will return digest paths.
attr_accessor :digest
# Set the Sprockets environment to search for assets.
# This defaults to the context's #environment method.
attr_accessor :environment
# The manifest file used for lookup
attr_accessor :manifest
# The base URL the Sprocket environment is mapped to.
# This defaults to '/assets'.
def prefix
@prefix ||= '/assets'
end
attr_writer :prefix
# Customize the protocol when using asset hosts.
# If the value is :relative, A relative protocol ('//')
# will be used.
def protocol
@protocol ||= 'http://'
end
attr_writer :protocol
# The path to the public directory, where the assets
# not managed by Sprockets will be located.
# Defaults to './public'
def public_path
@public_path ||= './public'
end
attr_writer :public_path
# Convience method for configuring Sprockets::Helpers.
def configure
yield self
end
end
end
class Context
# Returns the path to an asset either in the Sprockets environment
# or the public directory. External URIs are untouched.
#
# ==== Options
#
# * :ext - The extension to append if the source does not have one.
# * :dir - The directory to prepend if the file is in the public directory.
# * :digest - Wether or not use the digest paths for assets. Set Sprockets::Helpers.digest for global configuration.
# * :prefix - Use a custom prefix for the Sprockets environment. Set Sprockets::Helpers.prefix for global configuration.
# * :body - Adds a ?body=1 flag that tells Sprockets to return only the body of the asset.
#
# ==== Examples
#
# For files within Sprockets:
#
# asset_path 'xmlhr.js' # => '/assets/xmlhr.js'
# asset_path 'xmlhr', :ext => 'js' # => '/assets/xmlhr.js'
# asset_path 'xmlhr.js', :digest => true # => '/assets/xmlhr-27a8f1f96afd8d4c67a59eb9447f45bd.js'
# asset_path 'xmlhr.js', :prefix => '/themes' # => '/themes/xmlhr.js'
#
# For files outside of Sprockets:
#
# asset_path 'xmlhr' # => '/xmlhr'
# asset_path 'xmlhr', :ext => 'js' # => '/xmlhr.js'
# asset_path 'dir/xmlhr.js', :dir => 'javascripts' # => '/javascripts/dir/xmlhr.js'
# asset_path '/dir/xmlhr.js', :dir => 'javascripts' # => '/dir/xmlhr.js'
# asset_path 'http://www.example.com/js/xmlhr' # => 'http://www.example.com/js/xmlhr'
# asset_path 'http://www.example.com/js/xmlhr.js' # => 'http://www.example.com/js/xmlhr.js'
#
def asset_path(source, options = {})
uri = URI.parse(source)
# Return fast if the URI is absolute
return source if uri.absolute?
# When debugging return paths without digests, asset_hosts, etc.
if options[:debug]
options[:manifest] = false
options[:digest] = false
options[:asset_host] = false
end
# Append extension if necessary
source_ext = File.extname(source)
if options[:ext] && source_ext != ".#{options[:ext]}"
uri.path << ".#{options[:ext]}"
end
# If a manifest is present, try to grab the path from the manifest first
# Don't try looking in manifest in the first place if we're not looking for digest version
if options[:manifest] != false && Helpers.manifest && Helpers.manifest.assets[uri.path]
return Helpers::ManifestPath.new(uri, Helpers.manifest.assets[uri.path], options).to_s
end
# If the source points to an asset in the Sprockets
# environment use AssetPath to generate the full path.
assets_environment.resolve(uri.path) do |path|
return Helpers::AssetPath.new(uri, assets_environment[path], options).to_s
end
# Use FilePath for normal files on the file system
return Helpers::FilePath.new(uri, options).to_s
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,
# .js will be appended. External URIs are untouched.
#
# ==== Examples
#
# For files within Sprockets:
#
# javascript_path 'xmlhr' # => '/assets/xmlhr.js'
# javascript_path 'dir/xmlhr.js' # => '/assets/dir/xmlhr.js'
# javascript_path '/dir/xmlhr' # => '/assets/dir/xmlhr.js'
#
# For files outside of Sprockets:
#
# javascript_path 'xmlhr' # => '/javascripts/xmlhr.js'
# javascript_path 'dir/xmlhr.js' # => '/javascripts/dir/xmlhr.js'
# javascript_path '/dir/xmlhr' # => '/dir/xmlhr.js'
# javascript_path 'http://www.example.com/js/xmlhr' # => 'http://www.example.com/js/xmlhr'
# javascript_path 'http://www.example.com/js/xmlhr.js' # => 'http://www.example.com/js/xmlhr.js'
#
def javascript_path(source, options = {})
asset_path source, { :dir => 'javascripts', :ext => 'js' }.merge(options)
end
alias_method :path_to_javascript, :javascript_path
# Computes the path to a stylesheet asset either in the Sprockets
# environment or the public directory. If the +source+ filename has no extension,
# .css will be appended. External URIs are untouched.
#
# ==== Examples
#
# For files within Sprockets:
#
# stylesheet_path 'style' # => '/assets/style.css'
# stylesheet_path 'dir/style.css' # => '/assets/dir/style.css'
# stylesheet_path '/dir/style.css' # => '/assets/dir/style.css'
#
# For files outside of Sprockets:
#
# stylesheet_path 'style' # => '/stylesheets/style.css'
# stylesheet_path 'dir/style.css' # => '/stylesheets/dir/style.css'
# stylesheet_path '/dir/style.css' # => '/dir/style.css'
# stylesheet_path 'http://www.example.com/css/style' # => 'http://www.example.com/css/style'
# stylesheet_path 'http://www.example.com/css/style.css' # => 'http://www.example.com/css/style.css'
#
def stylesheet_path(source, options = {})
asset_path source, { :dir => 'stylesheets', :ext => 'css' }.merge(options)
end
alias_method :path_to_stylesheet, :stylesheet_path
# 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:
#
# 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:
#
# 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 video_path(source, options = {})
asset_path source, { :dir => 'videos' }.merge(options)
end
alias_method :path_to_video, :video_path
protected
# Returns the Sprockets environment #asset_path uses to search for
# assets. This can be overridden for more control, if necessary.
# Defaults to Sprockets::Helpers.environment or the envrionment
# returned by #environment.
def assets_environment
Helpers.environment || environment
end
end
end