Module: Sass::Plugin
- Extended by:
- Plugin
- Includes:
- Haml::Util, Callbacks
- Included in:
- Plugin
- Defined in:
- lib/sass/plugin.rb,
lib/sass/plugin/rack.rb,
lib/sass/plugin/staleness_checker.rb
Overview
This module handles the compilation of Sass/SCSS files. It provides global options and checks whether CSS files need to be updated.
This module is used as the primary interface with Sass when it's used as a plugin for various frameworks. All Rack-enabled frameworks are supported out of the box. The plugin is automatically activated for Rails and Merb. Other frameworks must enable it explicitly; see Rack.
This module has a large set of callbacks available
to allow users to run code (such as logging) when certain things happen.
All callback methods are of the form on_#{name}
,
and they all take a block that's called when the given action occurs.
Sass::Plugin.on_updating_stylesheet do |template, css| puts "Compiling #template to #css" end Sass::Plugin.update_stylesheets #=> Compiling app/sass/screen.scss to public/stylesheets/screen.css #=> Compiling app/sass/print.scss to public/stylesheets/print.css #=> Compiling app/sass/ie.scss to public/stylesheets/ie.css
Defined Under Namespace
Classes: Rack, StalenessChecker
Constant Summary
Constants included from Haml::Util
Instance Attribute Summary collapse
-
#checked_for_updates ⇒ Boolean
readonly
Whether or not Sass has ever checked if the stylesheets need to be updated (in this Ruby instance).
-
#options ⇒ {Symbol => Object}
An options hash.
Instance Method Summary collapse
-
#check_for_updates
Same as #update_stylesheets, but respects #checked_for_updates and the
:always_update
and:always_check
options. -
#engine_options(additional_options = {}) ⇒ {Symbol => Object}
Non-destructively modifies #options so that default values are properly set.
-
#force_update_stylesheets(individual_files = [])
Updates all stylesheets, even those that aren't out-of-date.
-
#update_stylesheets(individual_files = [])
Updates out-of-date stylesheets.
-
#watch(individual_files = [])
Watches the template directory (or directories) and updates the CSS files whenever the related Sass/SCSS files change.
Methods included from Callbacks
Methods included from Haml::Util
#ap_geq_3?, #ap_geq_3_beta_3?, #assert_html_safe!, #av_template_class, #caller_info, #check_encoding, #def_static_method, #enum_cons, #enum_slice, #enum_with_index, #flatten, #haml_warn, #has?, #html_safe, #intersperse, #map_hash, #map_keys, #map_vals, #merge_adjacent_strings, #ord, #paths, #powerset, #rails_env, #rails_root, #rails_safe_buffer_class, #rails_xss_safe?, #restrict, #ruby1_8?, #ruby1_8_6?, #scope, #set_eql?, #set_hash, #silence_haml_warnings, #silence_warnings, #static_method_name, #strip_string_array, #substitute, #to_hash
Instance Attribute Details
#checked_for_updates ⇒ Boolean (readonly)
Whether or not Sass has ever checked if the stylesheets need to be updated (in this Ruby instance).
157 158 159 |
# File 'lib/sass/plugin.rb', line 157
def checked_for_updates
@checked_for_updates
end
|
#options ⇒ {Symbol => Object}
An options hash. See the Sass options documentation.
163 164 165 |
# File 'lib/sass/plugin.rb', line 163
def options
@options
end
|
Instance Method Details
#check_for_updates
Same as #update_stylesheets, but respects #checked_for_updates
and the :always_update
and :always_check
options.
188 189 190 191 192 |
# File 'lib/sass/plugin.rb', line 188
def check_for_updates
return unless !Sass::Plugin.checked_for_updates ||
Sass::Plugin.options[:always_update] || Sass::Plugin.options[:always_check]
update_stylesheets
end
|
#engine_options(additional_options = {}) ⇒ {Symbol => Object}
Non-destructively modifies #options so that default values are properly set.
177 178 179 180 181 |
# File 'lib/sass/plugin.rb', line 177
def engine_options(additional_options = {})
opts = options.dup.merge(additional_options)
opts[:load_paths] = load_paths(opts)
opts
end
|
#force_update_stylesheets(individual_files = [])
Updates all stylesheets, even those that aren't out-of-date. Ignores the cache.
244 245 246 247 248 249 250 251 252 253 |
# File 'lib/sass/plugin.rb', line 244
def force_update_stylesheets(individual_files = [])
old_options = options
self.options = options.dup
options[:never_update] = false
options[:always_update] = true
options[:cache] = false
update_stylesheets(individual_files)
ensure
self.options = old_options
end
|
#update_stylesheets(individual_files = [])
Updates out-of-date stylesheets.
Checks each Sass/SCSS file in :template_location
to see if it's been modified more recently than the corresponding CSS file
in :css_location
.
If it has, it updates the CSS file.
207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 |
# File 'lib/sass/plugin.rb', line 207
def update_stylesheets(individual_files = [])
return if options[:never_update]
run_updating_stylesheets individual_files
individual_files.each {|t, c| update_stylesheet(t, c)}
@checked_for_updates = true
staleness_checker = StalenessChecker.new
template_locations.zip(css_locations).each do |template_location, css_location|
Dir.glob(File.join(template_location, "**", "*.s[ca]ss")).each do |file|
# Get the relative path to the file
name = file.sub(template_location.sub(/\/*$/, '/'), "")
css = css_filename(name, css_location)
next if forbid_update?(name)
if options[:always_update] || staleness_checker.stylesheet_needs_update?(css, file)
update_stylesheet file, css
else
run_not_updating_stylesheet file, css
end
end
end
end
|
#watch(individual_files = [])
Watches the template directory (or directories)
and updates the CSS files whenever the related Sass/SCSS files change.
watch
never returns.
Whenever a change is detected to a Sass/SCSS file in
:template_location
,
the corresponding CSS file in :css_location
will be recompiled.
The CSS files of any Sass/SCSS files that import the changed file will also be recompiled.
Before the watching starts in earnest, watch
calls #update_stylesheets.
Note that watch
uses the FSSM library
to monitor the filesystem for changes.
FSSM isn't loaded until watch
is run.
The version of FSSM distributed with Sass is loaded by default,
but if another version has already been loaded that will be used instead.
279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 |
# File 'lib/sass/plugin.rb', line 279
def watch(individual_files = [])
update_stylesheets(individual_files)
begin
require 'fssm'
rescue LoadError => e
e.message << "\n" <<
if File.exists?(scope(".git"))
'Run "git submodule update --init" to get the recommended version.'
else
'Run "gem install fssm" to get it.'
end
raise e
end
unless individual_files.empty? && FSSM::Backends::Default.name == "FSSM::Backends::FSEvents"
# As of FSSM 0.1.4, it doesn't support FSevents on individual files,
# but it also isn't smart enough to switch to polling itself.
require 'fssm/backends/polling'
Haml::Util.silence_warnings do
FSSM::Backends.const_set(:Default, FSSM::Backends::Polling)
end
end
# TODO: Keep better track of what depends on what
# so we don't have to run a global update every time anything changes.
FSSM.monitor do |mon|
template_locations.zip(css_locations).each do |template_location, css_location|
mon.path template_location do |path|
path.glob '**/*.s[ac]ss'
path.update do |base, relative|
run_template_modified File.join(base, relative)
update_stylesheets(individual_files)
end
path.create do |base, relative|
run_template_created File.join(base, relative)
update_stylesheets(individual_files)
end
path.delete do |base, relative|
run_template_deleted File.join(base, relative)
css = File.join(css_location, relative.gsub(/\.s[ac]ss$/, '.css'))
try_delete_css css
update_stylesheets(individual_files)
end
end
end
individual_files.each do |template, css|
mon.file template do |path|
path.update do
run_template_modified template
update_stylesheets(individual_files)
end
path.create do
run_template_created template
update_stylesheets(individual_files)
end
path.delete do
run_template_deleted template
try_delete_css css
update_stylesheets(individual_files)
end
end
end
end
end
|