module SyntaxTree::Parentheses

If you have a modifier statement (for instance a modifier if statement or a modifier while loop) there are times when you need to wrap the entire statement in parentheses. This occurs when you have something like:

foo[:foo] =
  if bar?
    baz
  end

Normally we would shorten this to an inline version, which would result in:

foo[:foo] = baz if bar?

but this actually has different semantic meaning. The first example will result in a nil being inserted into the hash for the :foo key, whereas the second example will result in an empty hash because the if statement applies to the entire assignment.

We can fix this in a couple of ways. We can use the then keyword, as in:

foo[:foo] = if bar? then baz end

But this isn’t used very often. We can also just leave it as is with the multi-line version, but for a short predicate and short value it looks verbose. The last option and the one used here is to add parentheses on both sides of the expression, as in:

foo[:foo] = (baz if bar?)

This approach maintains the nice conciseness of the inline version, while keeping the correct semantic meaning.

Constants

NODES

Public Class Methods

break(q) { || ... } click to toggle source

# File lib/syntax_tree/node.rb, line 8175
def self.break(q)
  return yield unless NODES.include?(q.parent.class)

  q.text("(")
  q.indent do
    q.breakable_empty
    yield
  end
  q.breakable_empty
  q.text(")")
end

flat(q) { || ... } click to toggle source

# File lib/syntax_tree/node.rb, line 8167
def self.flat(q)
  return yield unless NODES.include?(q.parent.class)

  q.text("(")
  yield
  q.text(")")
end