Class: Sass::Script::Parser

Inherits:
Object
  • Object
show all
Defined in:
/Users/ceppstei/Projects/sass-lang/.sass/lib/sass/script/parser.rb

Overview

The parser for SassScript. It parses a string of code into a tree of Tree::Nodes.

Direct Known Subclasses

CssParser

Constant Summary

Class Method Summary (collapse)

Instance Method Summary (collapse)

Constructor Details

- (Parser) initialize(str, line, offset, options = {})

Returns a new instance of Parser

Parameters:

  • str (String, StringScanner)

    The source text to parse

  • line (Fixnum)

    The line on which the SassScript appears. Used for error reporting and sourcemap building

  • offset (Fixnum)

    The character (not byte) offset where the script starts in the line. Used for error reporting and sourcemap building

  • options ({Symbol => Object}) (defaults to: {})

    An options hash; see the Sass options documentation



29
30
31
32
# File '/Users/ceppstei/Projects/sass-lang/.sass/lib/sass/script/parser.rb', line 29

def initialize(str, line, offset, options = {})
  @options = options
  @lexer = lexer_class.new(str, line, offset, options)
end

Class Method Details

+ (Script::Tree::Node) parse(str, line, offset, filename = nil)

Parses a SassScript expression.

Returns:

See Also:



222
223
224
# File '/Users/ceppstei/Projects/sass-lang/.sass/lib/sass/script/parser.rb', line 222

def self.parse(*args)
  new(*args).parse
end

Instance Method Details

- (Fixnum) line

The line number of the parser’s current position.

Returns:

  • (Fixnum)


11
12
13
# File '/Users/ceppstei/Projects/sass-lang/.sass/lib/sass/script/parser.rb', line 11

def line
  @lexer.line
end

- (Fixnum) offset

The column number of the parser’s current position.

Returns:

  • (Fixnum)


18
19
20
# File '/Users/ceppstei/Projects/sass-lang/.sass/lib/sass/script/parser.rb', line 18

def offset
  @lexer.offset
end

- (Script::Tree::Node) parse

Parses a SassScript expression.

Returns:

Raises:



62
63
64
65
66
67
68
69
70
71
# File '/Users/ceppstei/Projects/sass-lang/.sass/lib/sass/script/parser.rb', line 62

def parse
  expr = assert_expr :expr
  assert_done
  expr.options = @options
  check_for_interpolation expr
  expr
rescue Sass::SyntaxError => e
  e.modify_backtrace :line => @lexer.line, :filename => @options[:filename]
  raise e
end

- ((Array<Script::Tree::Node>, Script::Tree::Node)) parse_function_definition_arglist

Parses the argument list for a function definition.

Returns:

Raises:



169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
# File '/Users/ceppstei/Projects/sass-lang/.sass/lib/sass/script/parser.rb', line 169

def parse_function_definition_arglist
  args, splat = defn_arglist!(true)
  assert_done

  args.each do |k, v|
    check_for_interpolation k
    k.options = @options

    if v
      check_for_interpolation v
      v.options = @options
    end
  end

  if splat
    check_for_interpolation splat
    splat.options = @options
  end

  return args, splat
rescue Sass::SyntaxError => e
  e.modify_backtrace :line => @lexer.line, :filename => @options[:filename]
  raise e
end

- (Script::Tree::Node) parse_interpolated(warn_for_color = false)

Parses a SassScript expression within an interpolated segment (#{}). This means that it stops when it comes across an unmatched }, which signals the end of an interpolated segment, it returns rather than throwing an error.

Parameters:

  • warn_for_color (Boolean) (defaults to: false)

    Whether raw color values passed to interoplation should cause a warning.

Returns:

Raises:



43
44
45
46
47
48
49
50
51
52
53
54
55
56
# File '/Users/ceppstei/Projects/sass-lang/.sass/lib/sass/script/parser.rb', line 43

def parse_interpolated(warn_for_color = false)
  # Start two characters back to compensate for #{
  start_pos = Sass::Source::Position.new(line, offset - 2)
  expr = assert_expr :expr
  assert_tok :end_interpolation
  expr = Sass::Script::Tree::Interpolation.new(
    nil, expr, nil, !:wb, !:wa, :warn_for_color => warn_for_color)
  check_for_interpolation expr
  expr.options = @options
  node(expr, start_pos)
rescue Sass::SyntaxError => e
  e.modify_backtrace :line => @lexer.line, :filename => @options[:filename]
  raise e
end

- ((Array<Script::Tree::Node>, Script::Tree::Node)) parse_mixin_definition_arglist

Parses the argument list for a mixin definition.

Returns:

Raises:



139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
# File '/Users/ceppstei/Projects/sass-lang/.sass/lib/sass/script/parser.rb', line 139

def parse_mixin_definition_arglist
  args, splat = defn_arglist!(false)
  assert_done

  args.each do |k, v|
    check_for_interpolation k
    k.options = @options

    if v
      check_for_interpolation v
      v.options = @options
    end
  end

  if splat
    check_for_interpolation splat
    splat.options = @options
  end

  return args, splat
rescue Sass::SyntaxError => e
  e.modify_backtrace :line => @lexer.line, :filename => @options[:filename]
  raise e
end

- ((Array<Script::Tree::Node>, {String => Script::Tree::Node}, Script::Tree::Node, Script::Tree::Node)) parse_mixin_include_arglist

Parses the argument list for a mixin include.

The root nodes of the positional arguments, keyword arguments, and splat argument(s). Keyword arguments are in a hash from names to values.

Returns:

Raises:



100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
# File '/Users/ceppstei/Projects/sass-lang/.sass/lib/sass/script/parser.rb', line 100

def parse_mixin_include_arglist
  args, keywords = [], {}
  if try_tok(:lparen)
    args, keywords, splat, kwarg_splat = mixin_arglist
    assert_tok(:rparen)
  end
  assert_done

  args.each do |a|
    check_for_interpolation a
    a.options = @options
  end

  keywords.each do |_k, v|
    check_for_interpolation v
    v.options = @options
  end

  if splat
    check_for_interpolation splat
    splat.options = @options
  end

  if kwarg_splat
    check_for_interpolation kwarg_splat
    kwarg_splat.options = @options
  end

  return args, keywords, splat, kwarg_splat
rescue Sass::SyntaxError => e
  e.modify_backtrace :line => @lexer.line, :filename => @options[:filename]
  raise e
end

- (Script::Tree::Node) parse_string

Parse a single string value, possibly containing interpolation. Doesn’t assert that the scanner is finished after parsing.

Returns:

Raises:



199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
# File '/Users/ceppstei/Projects/sass-lang/.sass/lib/sass/script/parser.rb', line 199

def parse_string
  unless (peek = @lexer.peek) &&
      (peek.type == :string ||
      (peek.type == :funcall && peek.value.downcase == 'url'))
    lexer.expected!("string")
  end

  expr = assert_expr :funcall
  check_for_interpolation expr
  expr.options = @options
  @lexer.unpeek!
  expr
rescue Sass::SyntaxError => e
  e.modify_backtrace :line => @lexer.line, :filename => @options[:filename]
  raise e
end

- (Script::Tree::Node) parse_until(tokens)

Parses a SassScript expression, ending it when it encounters one of the given identifier tokens.

Parameters:

  • tokens (#include?(String))

    A set of strings that delimit the expression.

Returns:

Raises:



79
80
81
82
83
84
85
86
87
88
89
# File '/Users/ceppstei/Projects/sass-lang/.sass/lib/sass/script/parser.rb', line 79

def parse_until(tokens)
  @stop_at = tokens
  expr = assert_expr :expr
  assert_done
  expr.options = @options
  check_for_interpolation expr
  expr
rescue Sass::SyntaxError => e
  e.modify_backtrace :line => @lexer.line, :filename => @options[:filename]
  raise e
end