Function evalDependencyLanguage

scripts/parse_dependency.py:232–260

Evaluate an expression stack, returning an English equivalent - stack - the stack - leafMarkup, opMarkup, parenthesize - same as dependencyLanguage - root - True only if this is the outer (root) expression level - parent_op - the parent operator ('+' or ','), used to avoid unnec

(stack, leafMarkup, opMarkup, parenthesize, root, parent_op = None)

    return val

def evalDependencyLanguage(stack, leafMarkup, opMarkup, parenthesize, root, parent_op = None):
    """Evaluate an expression stack, returning an English equivalent

     - stack - the stack
     - leafMarkup, opMarkup, parenthesize - same as dependencyLanguage
     - root - True only if this is the outer (root) expression level
     - parent_op - the parent operator ('+' or ','), used to avoid unnecessary parentheses"""

    op, num_args = stack.pop(), 0
    if isinstance(op, tuple):
        op, num_args = op
    if op in '+,':
        # Recursively evaluate left and right sides, passing current op as parent
        rhs = evalDependencyLanguage(stack, leafMarkup, opMarkup, parenthesize, root = False, parent_op = op)
        opname = opMarkup(op)
        lhs = evalDependencyLanguage(stack, leafMarkup, opMarkup, parenthesize, root = False, parent_op = op)
        # Only add parentheses if:
        # 1. parenthesize is True, AND
        # 2. not at root level, AND
        # 3. the current operator differs from parent operator (mixed precedence)
        if parenthesize and not root and parent_op is not None and parent_op != op:
            return f'({lhs} {opname} {rhs})'
        else:
            return f'{lhs} {opname} {rhs}'
    elif op[0].isalpha() or (op.startswith('!') and len(op) > 1 and op[1].isalpha()):
        # This is an extension or feature name (optionally negated with '!' for protect expressions)
        return leafMarkup(op)
    else:
        raise Exception(f'invalid op: {op}')

def dependencyLanguage(dependency, leafMarkup, opMarkup, parenthesize):
    """Return an API dependency expression translated to a form suitable for