module Sprockets::Rails::Helper
Constants
- VIEW_ACCESSORS
Public Class Methods
# File lib/sprockets/rails/helper.rb, line 60 def self.extended(obj) obj.class_eval do attr_accessor(*VIEW_ACCESSORS) remove_method :assets_environment def assets_environment if env = @assets_environment @assets_environment = env.cached else nil end end end end
# File lib/sprockets/rails/helper.rb, line 43 def self.included(klass) klass.class_attribute(*VIEW_ACCESSORS) klass.class_eval do remove_method :assets_environment def assets_environment if instance_variable_defined?(:@assets_environment) @assets_environment = @assets_environment.cached elsif env = self.class.assets_environment @assets_environment = env.cached else nil end end end end
Public Instance Methods
Expand asset path to digested form.
path - String path options - Hash options
Returns String path or nil if no asset was found.
# File lib/sprockets/rails/helper.rb, line 99 def asset_digest_path(path, options = {}) resolve_asset do |resolver| resolver.digest_path path, options[:debug] end end
Experimental: Get integrity for asset path.
path - String path options - Hash options
Returns String integrity attribute or nil if no asset was found.
# File lib/sprockets/rails/helper.rb, line 111 def asset_integrity(path, options = {}) path = path_with_extname(path, options) resolve_asset do |resolver| resolver.integrity path end end
# File lib/sprockets/rails/helper.rb, line 48 def assets_environment if instance_variable_defined?(:@assets_environment) @assets_environment = @assets_environment.cached elsif env = self.class.assets_environment @assets_environment = env.cached else nil end end
# File lib/sprockets/rails/helper.rb, line 75 def compute_asset_path(path, options = {}) debug = options[:debug] if asset_path = resolve_asset_path(path, debug) File.join(assets_prefix || "/", legacy_debug_path(asset_path, debug)) else super end end
Override javascript tag helper to provide debugging support.
Eventually will be deprecated and replaced by source maps.
# File lib/sprockets/rails/helper.rb, line 122 def javascript_include_tag(*sources) options = sources.extract_options!.stringify_keys integrity = compute_integrity?(options) if options["debug"] != false && request_debug_assets? sources.map { |source| if asset = lookup_debug_asset(source, type: :javascript) if asset.respond_to?(:to_a) asset.to_a.map do |a| super(path_to_javascript(a.logical_path, debug: true), options) end else super(path_to_javascript(asset.logical_path, debug: true), options) end else super(source, options) end }.flatten.uniq.join("\n").html_safe else sources.map { |source| options = options.merge('integrity' => asset_integrity(source, type: :javascript)) if integrity super source, options }.join("\n").html_safe end end
Override stylesheet tag helper to provide debugging support.
Eventually will be deprecated and replaced by source maps.
# File lib/sprockets/rails/helper.rb, line 151 def stylesheet_link_tag(*sources) options = sources.extract_options!.stringify_keys integrity = compute_integrity?(options) if options["debug"] != false && request_debug_assets? sources.map { |source| if asset = lookup_debug_asset(source, type: :stylesheet) if asset.respond_to?(:to_a) asset.to_a.map do |a| super(path_to_stylesheet(a.logical_path, debug: true), options) end else super(path_to_stylesheet(asset.logical_path, debug: true), options) end else super(source, options) end }.flatten.uniq.join("\n").html_safe else sources.map { |source| options = options.merge('integrity' => asset_integrity(source, type: :stylesheet)) if integrity super source, options }.join("\n").html_safe end end
Protected Instance Methods
List of resolvers in `config.assets.resolve_with` order.
# File lib/sprockets/rails/helper.rb, line 236 def asset_resolver_strategies @asset_resolver_strategies ||= Array(resolve_assets_with).map do |name| HelperAssetResolvers[name].new(self) end end
This is awkward: `integrity` is a boolean option indicating whether we want to include or omit the subresource integrity hash, but the options hash is also passed through as literal tag attributes. That means we have to delete the shortcut boolean option so it doesn't bleed into the tag attributes, but also check its value if it's boolean-ish.
# File lib/sprockets/rails/helper.rb, line 184 def compute_integrity?(options) if secure_subresource_integrity_context? case options['integrity'] when nil, false, true options.delete('integrity') == true end else options.delete 'integrity' false end end
Append ?body=1 if debug is on and we're on old Sprockets.
# File lib/sprockets/rails/helper.rb, line 244 def legacy_debug_path(path, debug) if debug && !using_sprockets4? "#{path}?body=1" else path end end
Internal method to support multifile debugging. Will eventually be removed w/ Sprockets 3.x.
# File lib/sprockets/rails/helper.rb, line 212 def lookup_debug_asset(path, options = {}) path = path_with_extname(path, options) resolve_asset do |resolver| resolver.find_debug_asset path end end
compute_asset_extname is in AV::Helpers::AssetUrlHelper
# File lib/sprockets/rails/helper.rb, line 221 def path_with_extname(path, options) path = path.to_s "#{path}#{compute_asset_extname(path, options)}" end
Enable split asset debugging. Eventually will be deprecated and replaced by source maps in Sprockets 3.x.
# File lib/sprockets/rails/helper.rb, line 204 def request_debug_assets? debug_assets || (defined?(controller) && controller && params[:debug_assets]) rescue # FIXME: what exactly are we rescuing? false end
Try each asset resolver and return the first non-nil result.
# File lib/sprockets/rails/helper.rb, line 227 def resolve_asset asset_resolver_strategies.detect do |resolver| if result = yield(resolver) break result end end end
Only serve integrity metadata for HTTPS requests:
http://www.w3.org/TR/SRI/#non-secure-contexts-remain-non-secure
# File lib/sprockets/rails/helper.rb, line 198 def secure_subresource_integrity_context? respond_to?(:request) && self.request && self.request.ssl? end