class Sprockets::SassProcessor
Processor engine class for the SASS/SCSS compiler. Depends on the ‘sass` gem.
For more information see:
https://github.com/sass/sass https://github.com/rails/sass-rails
Attributes
cache_key[R]
Public Class Methods
cache_key()
click to toggle source
# File lib/sprockets/sass_processor.rb, line 35 def self.cache_key instance.cache_key end
call(input)
click to toggle source
# File lib/sprockets/sass_processor.rb, line 31 def self.call(input) instance.call(input) end
instance()
click to toggle source
Public: Return singleton instance with default options.
Returns SassProcessor
object.
# File lib/sprockets/sass_processor.rb, line 27 def self.instance @instance ||= new end
new(options = {}, &block)
click to toggle source
Public: Initialize template with custom options.
options - Hash cache_version - String custom cache version. Used to force a cache
change after code changes are made to Sass Functions.
# File lib/sprockets/sass_processor.rb, line 47 def initialize(options = {}, &block) @cache_version = options[:cache_version] @cache_key = "#{self.class.name}:#{VERSION}:#{Autoload::Sass::VERSION}:#{@cache_version}".freeze @importer_class = options[:importer] || Sass::Importers::Filesystem @sass_config = options[:sass_config] || {} @functions = Module.new do include Functions include options[:functions] if options[:functions] class_eval(&block) if block_given? end end
syntax()
click to toggle source
Internal: Defines default sass syntax to use. Exposed so the ScssProcessor
may override it.
# File lib/sprockets/sass_processor.rb, line 20 def self.syntax :sass end
Public Instance Methods
call(input)
click to toggle source
# File lib/sprockets/sass_processor.rb, line 59 def call(input) context = input[:environment].context_class.new(input) engine_options = merge_options({ filename: input[:filename], syntax: self.class.syntax, cache_store: build_cache_store(input, @cache_version), load_paths: context.environment.paths.map { |p| @importer_class.new(p.to_s) }, importer: @importer_class.new(Pathname.new(context.filename).to_s), sprockets: { context: context, environment: input[:environment], dependencies: context.metadata[:dependencies] } }) engine = Autoload::Sass::Engine.new(input[:data], engine_options) css, map = Utils.module_include(Autoload::Sass::Script::Functions, @functions) do engine.render_with_sourcemap('') end css = css.sub("\n/*# sourceMappingURL= */\n", '') map = SourceMapUtils.format_source_map(JSON.parse(map.to_json(css_uri: '')), input) map = SourceMapUtils.combine_source_maps(input[:metadata][:map], map) # Track all imported files sass_dependencies = Set.new([input[:filename]]) engine.dependencies.map do |dependency| sass_dependencies << dependency.options[:filename] context.metadata[:dependencies] << URIUtils.build_file_digest_uri(dependency.options[:filename]) end context.metadata.merge(data: css, sass_dependencies: sass_dependencies, map: map) end
Private Instance Methods
build_cache_store(input, version)
click to toggle source
Public: Build the cache store to be used by the Sass engine.
input - the input hash. version - the cache version.
Override this method if you need to use a different cache than the Sprockets
cache.
# File lib/sprockets/sass_processor.rb, line 105 def build_cache_store(input, version) CacheStore.new(input[:cache], version) end
merge_options(options)
click to toggle source
# File lib/sprockets/sass_processor.rb, line 109 def merge_options(options) defaults = @sass_config.dup if load_paths = defaults.delete(:load_paths) options[:load_paths] += load_paths end options.merge!(defaults) options end