Class Haml::Exec::Sass
In: lib/haml/exec.rb
Parent: HamlSass

The `sass` executable.

Methods

Public Class methods

@param args [Array<String>] The command-line arguments

[Source]

     # File lib/haml/exec.rb, line 271
271:       def initialize(args)
272:         super
273:         @name = "Sass"
274:         @options[:for_engine][:load_paths] = ['.'] + (ENV['SASSPATH'] || '').split(File::PATH_SEPARATOR)
275:       end

Protected Instance methods

Processes the options set by the command-line arguments, and runs the Sass compiler appropriately.

[Source]

     # File lib/haml/exec.rb, line 340
340:       def process_result
341:         if !@options[:update] && !@options[:watch] &&
342:             @args.first && colon_path?(@args.first)
343:           if @args.size == 1
344:             @args = split_colon_path(@args.first)
345:           else
346:             @options[:update] = true
347:           end
348:         end
349: 
350:         return interactive if @options[:interactive]
351:         return watch_or_update if @options[:watch] || @options[:update]
352:         super
353: 
354:         begin
355:           input = @options[:input]
356:           output = @options[:output]
357: 
358:           @options[:syntax] ||= :scss if input.is_a?(File) && input.path =~ /\.scss$/
359:           tree =
360:             if input.is_a?(File) && !@options[:check_syntax]
361:               ::Sass::Files.tree_for(input.path, @options[:for_engine])
362:             else
363:               # We don't need to do any special handling of @options[:check_syntax] here,
364:               # because the Sass syntax checking happens alongside evaluation
365:               # and evaluation doesn't actually evaluate any code anyway.
366:               ::Sass::Engine.new(input.read(), @options[:for_engine]).to_tree
367:             end
368: 
369:           input.close() if input.is_a?(File)
370: 
371:           output.write(tree.render)
372:           output.close() if output.is_a? File
373:         rescue ::Sass::SyntaxError => e
374:           raise e if @options[:trace]
375:           raise e.sass_backtrace_str("standard input")
376:         end
377:       end

Tells optparse how to parse the arguments.

@param opts [OptionParser]

[Source]

     # File lib/haml/exec.rb, line 282
282:       def set_opts(opts)
283:         super
284: 
285:         opts.on('--scss',
286:                 'Use the CSS-superset SCSS syntax.') do
287:           @options[:for_engine][:syntax] = :scss
288:         end
289:         opts.on('--watch', 'Watch files or directories for changes.',
290:                            'The location of the generated CSS can be set using a colon:',
291:                            '  sass --watch input.sass:output.css',
292:                            '  sass --watch input-dir:output-dir') do
293:           @options[:watch] = true
294:         end
295:         opts.on('--update', 'Compile files or directories to CSS.',
296:                             'Locations are set like --watch.') do
297:           @options[:update] = true
298:         end
299:         opts.on('-t', '--style NAME',
300:                 'Output style. Can be nested (default), compact, compressed, or expanded.') do |name|
301:           @options[:for_engine][:style] = name.to_sym
302:         end
303:         opts.on('-q', '--quiet', 'Silence warnings during compilation.') do
304:           @options[:for_engine][:quiet] = true
305:         end
306:         opts.on('-g', '--debug-info',
307:                 'Emit extra information in the generated CSS that can be used by the FireSass Firebug plugin.') do
308:           @options[:for_engine][:debug_info] = true
309:         end
310:         opts.on('-l', '--line-numbers', '--line-comments',
311:                 'Emit comments in the generated CSS indicating the corresponding sass line.') do
312:           @options[:for_engine][:line_numbers] = true
313:         end
314:         opts.on('-i', '--interactive',
315:                 'Run an interactive SassScript shell.') do
316:           @options[:interactive] = true
317:         end
318:         opts.on('-I', '--load-path PATH', 'Add a sass import path.') do |path|
319:           @options[:for_engine][:load_paths] << path
320:         end
321:         opts.on('-r', '--require LIB', 'Require a Ruby library before running Sass.') do |lib|
322:           require lib
323:         end
324:         opts.on('--cache-location PATH', 'The path to put cached Sass files. Defaults to .sass-cache.') do |loc|
325:           @options[:for_engine][:cache_location] = loc
326:         end
327:         opts.on('-C', '--no-cache', "Don't cache to sassc files.") do
328:           @options[:for_engine][:cache] = false
329:         end
330: 
331:         unless ::Haml::Util.ruby1_8?
332:           opts.on('-E encoding', 'Specify the default encoding for Sass files.') do |encoding|
333:             Encoding.default_external = encoding
334:           end
335:         end
336:       end

Private Instance methods

[Source]

     # File lib/haml/exec.rb, line 443
443:       def colon_path?(path)
444:         !split_colon_path(path)[1].nil?
445:       end

[Source]

     # File lib/haml/exec.rb, line 381
381:       def interactive
382:         require 'sass'
383:         require 'sass/repl'
384:         ::Sass::Repl.new(@options).run
385:       end

[Source]

     # File lib/haml/exec.rb, line 447
447:       def split_colon_path(path)
448:         one, two = path.split(':', 2)
449:         if one && two && ::Haml::Util.windows? &&
450:             one =~ /\A[A-Za-z]\Z/ && two =~ /\A[\/\\]/
451:           # If we're on Windows and we were passed a drive letter path,
452:           # don't split on that colon.
453:           one2, two = two.split(':', 2)
454:           one = one + ':' + one2
455:         end
456:         return one, two
457:       end

[Source]

     # File lib/haml/exec.rb, line 387
387:       def watch_or_update
388:         require 'sass'
389:         require 'sass/plugin'
390:         ::Sass::Plugin.options.merge! @options[:for_engine]
391:         ::Sass::Plugin.options[:unix_newlines] = @options[:unix_newlines]
392: 
393:         if @args[1] && !colon_path?(@args[0])
394:           flag = @options[:update] ? "--update" : "--watch"
395:           err =
396:             if !File.exist?(@args[1])
397:               "doesn't exist"
398:             elsif @args[1] =~ /\.css$/
399:               "is a CSS file"
400:             end
401:           raise "File \#{@args[1]} \#{err}.\n  Did you mean: sass \#{flag} \#{@args[0]}:\#{@args[1]}\n" if err
402:         end
403: 
404:         dirs, files = @args.map {|name| split_colon_path(name)}.
405:           partition {|i, _| File.directory? i}
406:         files.map! {|from, to| [from, to || from.gsub(/\..*?$/, '.css')]}
407:         dirs.map! {|from, to| [from, to || from]}
408:         ::Sass::Plugin.options[:template_location] = dirs
409: 
410:         ::Sass::Plugin.on_updating_stylesheet do |_, css|
411:           if File.exists? css
412:             puts_action :overwrite, :yellow, css
413:           else
414:             puts_action :create, :green, css
415:           end
416:         end
417: 
418:         ::Sass::Plugin.on_creating_directory {|dirname| puts_action :directory, :green, dirname}
419:         ::Sass::Plugin.on_deleting_css {|filename| puts_action :delete, :yellow, filename}
420:         ::Sass::Plugin.on_compilation_error do |error, _, _|
421:           raise error unless error.is_a?(::Sass::SyntaxError)
422:           puts_action :error, :red, "#{error.sass_filename} (Line #{error.sass_line}: #{error.message})"
423:         end
424: 
425:         if @options[:update]
426:           ::Sass::Plugin.update_stylesheets(files)
427:           return
428:         end
429: 
430:         puts ">>> Sass is watching for changes. Press Ctrl-C to stop."
431: 
432:         ::Sass::Plugin.on_template_modified {|template| puts ">>> Change detected to: #{template}"}
433:         ::Sass::Plugin.on_template_created {|template| puts ">>> New template detected: #{template}"}
434:         ::Sass::Plugin.on_template_deleted {|template| puts ">>> Deleted template detected: #{template}"}
435: 
436:         ::Sass::Plugin.watch(files)
437:       end

[Validate]