Class: Sass::Tree::Visitors::CheckNesting

Inherits:
Base
  • Object
show all
Defined in:
lib/sass/tree/visitors/check_nesting.rb

Overview

A visitor for checking that all nodes are properly nested.

Constant Summary collapse

CONTROL_NODES =
[Sass::Tree::EachNode, Sass::Tree::ForNode, Sass::Tree::IfNode,
Sass::Tree::WhileNode, Sass::Tree::TraceNode]
SCRIPT_NODES =
[Sass::Tree::ImportNode] + CONTROL_NODES
VALID_EXTEND_PARENTS =
[Sass::Tree::RuleNode, Sass::Tree::MixinDefNode, Sass::Tree::MixinNode]
INVALID_IMPORT_PARENTS =
CONTROL_NODES +
[Sass::Tree::MixinDefNode, Sass::Tree::MixinNode]
VALID_FUNCTION_CHILDREN =
[
  Sass::Tree::CommentNode,  Sass::Tree::DebugNode, Sass::Tree::ReturnNode,
  Sass::Tree::VariableNode, Sass::Tree::WarnNode, Sass::Tree::ErrorNode
] + CONTROL_NODES
VALID_PROP_CHILDREN =
CONTROL_NODES + [Sass::Tree::CommentNode,
Sass::Tree::PropNode,
Sass::Tree::MixinNode]
VALID_PROP_PARENTS =
[Sass::Tree::RuleNode, Sass::Tree::KeyframeRuleNode, Sass::Tree::PropNode,
Sass::Tree::MixinDefNode, Sass::Tree::DirectiveNode, Sass::Tree::MixinNode]

Instance Method Summary collapse

Methods inherited from Base

node_name, visit, #visit_if

Constructor Details

#initializeCheckNesting (protected)

Returns a new instance of CheckNesting


5
6
7
# File 'lib/sass/tree/visitors/check_nesting.rb', line 5

def initialize
  @parents = []
end

Instance Method Details

#invalid_charset_parent?(parent, child) ⇒ Boolean (protected)

Returns:

  • (Boolean)

87
88
89
# File 'lib/sass/tree/visitors/check_nesting.rb', line 87

def invalid_charset_parent?(parent, child)
  "@charset may only be used at the root of a document." unless parent.is_a?(Sass::Tree::RootNode)
end

#invalid_content_parent?(parent, child) ⇒ Boolean (protected)

Returns:

  • (Boolean)

78
79
80
81
82
83
84
85
# File 'lib/sass/tree/visitors/check_nesting.rb', line 78

def invalid_content_parent?(parent, child)
  if @current_mixin_def
    @current_mixin_def.has_content = true
    nil
  else
    "@content may only be used within a mixin."
  end
end

#invalid_extend_parent?(parent, child) ⇒ Boolean (protected)

Returns:

  • (Boolean)

92
93
94
95
96
# File 'lib/sass/tree/visitors/check_nesting.rb', line 92

def invalid_extend_parent?(parent, child)
  unless is_any_of?(parent, VALID_EXTEND_PARENTS)
    return "Extend directives may only be used within rules."
  end
end

#invalid_function_child?(parent, child) ⇒ Boolean (protected)

Returns:

  • (Boolean)

128
129
130
131
132
# File 'lib/sass/tree/visitors/check_nesting.rb', line 128

def invalid_function_child?(parent, child)
  unless is_any_of?(child, VALID_FUNCTION_CHILDREN)
    "Functions can only contain variable declarations and control directives."
  end
end

#invalid_function_parent?(parent, child) ⇒ Boolean (protected)

Returns:

  • (Boolean)

118
119
120
121
122
# File 'lib/sass/tree/visitors/check_nesting.rb', line 118

def invalid_function_parent?(parent, child)
  unless (@parents.map {|p| p.class} & INVALID_IMPORT_PARENTS).empty?
    return "Functions may not be defined within control directives or other mixins."
  end
end

#invalid_import_parent?(parent, child) ⇒ Boolean (protected)

Returns:

  • (Boolean)

100
101
102
103
104
105
106
107
108
109
110
# File 'lib/sass/tree/visitors/check_nesting.rb', line 100

def invalid_import_parent?(parent, child)
  unless (@parents.map {|p| p.class} & INVALID_IMPORT_PARENTS).empty?
    return "Import directives may not be used within control directives or mixins."
  end
  return if parent.is_a?(Sass::Tree::RootNode)
  return "CSS import directives may only be used at the root of a document." if child.css_import?
rescue Sass::SyntaxError => e
  e.modify_backtrace(:filename => child.imported_file.options[:filename])
  e.add_backtrace(:filename => child.filename, :line => child.line)
  raise e
end

#invalid_mixindef_parent?(parent, child) ⇒ Boolean (protected)

Returns:

  • (Boolean)

112
113
114
115
116
# File 'lib/sass/tree/visitors/check_nesting.rb', line 112

def invalid_mixindef_parent?(parent, child)
  unless (@parents.map {|p| p.class} & INVALID_IMPORT_PARENTS).empty?
    return "Mixins may not be defined within control directives or other mixins."
  end
end

#invalid_prop_child?(parent, child) ⇒ Boolean (protected)

Returns:

  • (Boolean)

137
138
139
140
141
# File 'lib/sass/tree/visitors/check_nesting.rb', line 137

def invalid_prop_child?(parent, child)
  unless is_any_of?(child, VALID_PROP_CHILDREN)
    "Illegal nesting: Only properties may be nested beneath properties."
  end
end

#invalid_prop_parent?(parent, child) ⇒ Boolean (protected)

Returns:

  • (Boolean)

145
146
147
148
149
150
# File 'lib/sass/tree/visitors/check_nesting.rb', line 145

def invalid_prop_parent?(parent, child)
  unless is_any_of?(parent, VALID_PROP_PARENTS)
    "Properties are only allowed within rules, directives, mixin includes, or other properties." +
      child.pseudo_class_selector_message
  end
end

#invalid_return_parent?(parent, child) ⇒ Boolean (protected)

Returns:

  • (Boolean)

152
153
154
# File 'lib/sass/tree/visitors/check_nesting.rb', line 152

def invalid_return_parent?(parent, child)
  "@return may only be used within a function." unless parent.is_a?(Sass::Tree::FunctionNode)
end

#visit(node) (protected)


9
10
11
12
13
14
15
16
17
18
19
# File 'lib/sass/tree/visitors/check_nesting.rb', line 9

def visit(node)
  if (error = @parent && (
      try_send(@parent.class.invalid_child_method_name, @parent, node) ||
      try_send(node.class.invalid_parent_method_name, @parent, node)))
    raise Sass::SyntaxError.new(error)
  end
  super
rescue Sass::SyntaxError => e
  e.modify_backtrace(:filename => node.filename, :line => node.line)
  raise e
end

#visit_children(parent) (protected)


24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
# File 'lib/sass/tree/visitors/check_nesting.rb', line 24

def visit_children(parent)
  old_parent = @parent

  # When checking a static tree, resolve at-roots to be sure they won't send
  # nodes where they don't belong.
  if parent.is_a?(Sass::Tree::AtRootNode) && parent.resolved_value
    old_parents = @parents
    @parents = @parents.reject {|p| parent.exclude_node?(p)}
    @parent = Sass::Util.enum_with_index(@parents.reverse).
      find {|p, i| !transparent_parent?(p, @parents[-i - 2])}.first

    begin
      return super
    ensure
      @parents = old_parents
      @parent = old_parent
    end
  end

  unless transparent_parent?(parent, old_parent)
    @parent = parent
  end

  @parents.push parent
  begin
    super
  ensure
    @parent = old_parent
    @parents.pop
  end
end

#visit_import(node) (protected)


63
64
65
66
67
68
69
# File 'lib/sass/tree/visitors/check_nesting.rb', line 63

def visit_import(node)
  yield
rescue Sass::SyntaxError => e
  e.modify_backtrace(:filename => node.children.first.filename)
  e.add_backtrace(:filename => node.filename, :line => node.line)
  raise e
end

#visit_mixindef(node) (protected)


71
72
73
74
75
76
# File 'lib/sass/tree/visitors/check_nesting.rb', line 71

def visit_mixindef(node)
  @current_mixin_def, old_mixin_def = node, @current_mixin_def
  yield
ensure
  @current_mixin_def = old_mixin_def
end

#visit_root(node) (protected)


56
57
58
59
60
61
# File 'lib/sass/tree/visitors/check_nesting.rb', line 56

def visit_root(node)
  yield
rescue Sass::SyntaxError => e
  e.sass_template ||= node.template
  raise e
end