/usr/lib/ruby/vendor_ruby/sass/tree/visitors/base.rb is in ruby-sass 3.1.15-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 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 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 | # Visitors are used to traverse the Sass parse tree.
# Visitors should extend {Visitors::Base},
# which provides a small amount of scaffolding for traversal.
module Sass::Tree::Visitors
# The abstract base class for Sass visitors.
# Visitors should extend this class,
# then implement `visit_*` methods for each node they care about
# (e.g. `visit_rule` for {RuleNode} or `visit_for` for {ForNode}).
# These methods take the node in question as argument.
# They may `yield` to visit the child nodes of the current node.
#
# *Note*: due to the unusual nature of {Sass::Tree::IfNode},
# special care must be taken to ensure that it is properly handled.
# In particular, there is no built-in scaffolding
# for dealing with the return value of `@else` nodes.
#
# @abstract
class Base
# Runs the visitor on a tree.
#
# @param root [Tree::Node] The root node of the Sass tree.
# @return [Object] The return value of \{#visit} for the root node.
def self.visit(root)
new.send(:visit, root)
end
protected
# Runs the visitor on the given node.
# This can be overridden by subclasses that need to do something for each node.
#
# @param node [Tree::Node] The node to visit.
# @return [Object] The return value of the `visit_*` method for this node.
def visit(node)
method = "visit_#{node_name node}"
if self.respond_to?(method)
self.send(method, node) {visit_children(node)}
else
visit_children(node)
end
end
# Visit the child nodes for a given node.
# This can be overridden by subclasses that need to do something
# with the child nodes' return values.
#
# This method is run when `visit_*` methods `yield`,
# and its return value is returned from the `yield`.
#
# @param parent [Tree::Node] The parent node of the children to visit.
# @return [Array<Object>] The return values of the `visit_*` methods for the children.
def visit_children(parent)
parent.children.map {|c| visit(c)}
end
NODE_NAME_RE = /.*::(.*?)Node$/
# Returns the name of a node as used in the `visit_*` method.
#
# @param [Tree::Node] node The node.
# @return [String] The name.
def node_name(node)
@@node_names ||= {}
@@node_names[node.class.name] ||= node.class.name.gsub(NODE_NAME_RE, '\\1').downcase
end
# `yield`s, then runs the visitor on the `@else` clause if the node has one.
# This exists to ensure that the contents of the `@else` clause get visited.
def visit_if(node)
yield
visit(node.else) if node.else
node
end
end
end
|