Module: Sass::Plugin
- Extended by:
- Plugin
- Includes:
- Haml::Util, Callbacks
- Included in:
- Plugin
- Defined in:
- lib/sass/plugin.rb,
lib/sass/plugin/rack.rb
Overview
This module handles the compilation of Sass 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.sass to public/stylesheets/screen.css #=> Compiling app/sass/print.sass to public/stylesheets/print.css #=> Compiling app/sass/ie.sass to public/stylesheets/ie.css
Defined Under Namespace
Classes: Rack
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.
-
#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 files change.
Methods included from Callbacks
Methods included from Haml::Util
#ap_geq_3?, #assert_html_safe!, #av_template_class, #caller_info, #check_encoding, #def_static_method, #enum_with_index, #has?, #html_safe, #map_hash, #map_keys, #map_vals, #merge_adjacent_strings, #ord, #powerset, #rails_env, #rails_root, #rails_safe_buffer_class, #rails_xss_safe?, #restrict, #ruby1_8?, #scope, #silence_warnings, #static_method_name, #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).
156 157 158 |
# File 'lib/sass/plugin.rb', line 156
def checked_for_updates
@checked_for_updates
end
|
#options ⇒ {Symbol => Object}
An options hash. See the Sass options documentation.
162 163 164 |
# File 'lib/sass/plugin.rb', line 162
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.
187 188 189 190 191 |
# File 'lib/sass/plugin.rb', line 187
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.
176 177 178 179 180 |
# File 'lib/sass/plugin.rb', line 176
def engine_options(additional_options = {})
opts = options.dup.merge(additional_options)
opts[:load_paths] = load_paths(opts)
opts
end
|
#update_stylesheets(individual_files = [])
Updates out-of-date stylesheets.
Checks each Sass 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.
206 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 |
# File 'lib/sass/plugin.rb', line 206
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
template_locations.zip(css_locations).each do |template_location, css_location|
Dir.glob(File.join(template_location, "**", "*.sass")).each do |file|
# Get the relative path to the file with no extension
name = file.sub(template_location.sub(/\/*$/, '/'), "")[0...-5]
next if forbid_update?(name)
filename = template_filename(name, template_location)
css = css_filename(name, css_location)
if options[:always_update] || stylesheet_needs_update?(name, template_location, css_location)
update_stylesheet filename, css
else
run_not_updating_stylesheet filename, css
end
end
end
end
|
#watch(individual_files = [])
Watches the template directory (or directories)
and updates the CSS files whenever the related Sass files change.
watch
never returns.
Whenever a change is detected to a Sass file in
:template_location
,
the corresponding CSS file in :css_location
will be recompiled.
The CSS files of any Sass 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.
257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 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 |
# File 'lib/sass/plugin.rb', line 257
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
# 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 '**/*.sass'
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(/\.sass$/, '.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
|