Class: Sass::Engine

Inherits:

Object

• Object
• Sass::Engine

show all

Includes:

Util

Defined in:

/var/www/sass-pages/.sass/lib/sass/engine.rb

Overview

template = File.load('stylesheets/sassy.sass')
sass_engine = Sass::Engine.new(template)
output = sass_engine.render
puts output

Constant Summary

DEFAULT_OPTIONS = The default options for Sass::Engine.

{
  :style => :nested,
  :load_paths => ['.'],
  :cache => true,
  :cache_location => './.sass-cache',
  :syntax => :sass,
  :filesystem_importer => Sass::Importers::Filesystem
}.freeze

Constants included from Util

RUBY_ENGINE, RUBY_VERSION

Instance Attribute Summary

• - ({Symbol => Object}) options readonly The options for the Sass engine.

Class Method Summary

• + (Sass::Engine) for_file(filename, options) Returns the Sass::Engine for the given file.

Instance Method Summary

• - ([Sass::Engine]) dependencies Gets a set of all the documents that are (transitive) dependencies of this document, not including the document itself.
• - (Engine) initialize(template, options = {}) constructor Creates a new Engine.
• - (String) render (also: #to_css) Render the template to CSS.
• - (Encoding^?) source_encoding Returns the original encoding of the document, or nil under Ruby 1.8.
• - (Sass::Tree::Node) to_tree Parses the document into its parse tree.

Methods included from Util

#abstract, #ap_geq?, #ap_geq_3?, #array_minus, #av_template_class, #caller_info, #check_encoding, #check_range, #check_sass_encoding, #destructure, #enum_cons, #enum_slice, #enum_with_index, #extract!, #extract_values, #flatten, #glob, #group_by_to_a, #has?, #hash_to_a, #inject_values, #inspect_obj, #intersperse, #ironruby?, #jruby1_6?, #jruby?, #jruby_version, #lcs, #macruby?, #map_hash, #map_keys, #map_vals, #merge_adjacent_strings, #ord, #paths, #powerset, #rails_env, #rails_root, #rbx?, #restrict, #ruby1?, #ruby1_8?, #ruby1_8_6?, #sass_warn, #scope, #set_eql?, #set_hash, #silence_sass_warnings, #silence_warnings, #strip_string_array, #subsequence?, #substitute, #to_hash, #undefined_conversion_error_char, #version_geq, #version_gt, #windows?, #with_extracted_values

249
250
251
252

# File '/var/www/sass-pages/.sass/lib/sass/engine.rb', line 249

def initialize(template, options={})
  @options = self.class.normalize_options(options)
  @template = template
end

230
231
232

# File '/var/www/sass-pages/.sass/lib/sass/engine.rb', line 230

def options
  @options
end

212
213
214
215
216
217
218
219
220
221
222
223
224

# File '/var/www/sass-pages/.sass/lib/sass/engine.rb', line 212

def self.for_file(filename, options)
  had_syntax = options[:syntax]

  if had_syntax
    # Use what was explicitly specificed
  elsif filename =~ /\.scss$/
    options.merge!(:syntax => :scss)
  elsif filename =~ /\.sass$/
    options.merge!(:syntax => :sass)
  end

  Sass::Engine.new(File.read(filename), options.merge(:filename => filename))
end

294
295
296
297

# File '/var/www/sass-pages/.sass/lib/sass/engine.rb', line 294

def dependencies
  _dependencies(Set.new, engines = Set.new)
  Sass::Util.array_minus(engines, [self])
end

261
262
263
264

# File '/var/www/sass-pages/.sass/lib/sass/engine.rb', line 261

def render
  return _render unless @options[:quiet]
  Sass::Util.silence_sass_warnings {_render}
end

284
285
286
287

# File '/var/www/sass-pages/.sass/lib/sass/engine.rb', line 284

def source_encoding
  check_encoding!
  @original_encoding
end

271
272
273
274
275

# File '/var/www/sass-pages/.sass/lib/sass/engine.rb', line 271

def to_tree
  @tree ||= @options[:quiet] ?
    Sass::Util.silence_sass_warnings {_to_tree} :
    _to_tree
end