Function parse_shell

src/packagedcode/bashparse.py:379–405

Return a pygmars parse Tree built from a ``text`` string.

(text, grammar=variables_grammar, loop=1, trace=TRACE, validate=VALIDATE)

def parse_shell(text, grammar=variables_grammar, loop=1, trace=TRACE, validate=VALIDATE):
    """
    Return a pygmars parse Tree built from a ``text`` string.
    """
    tokens = get_tokens(text)

    # then build a parse parse_tree based on tagged tokens
    parser = parse.Parser(
        grammar=grammar,
        trace=trace,
        validate=validate,
        loop=loop,
    )

    if TRACE:
        tokens = list(tokens)
        logger_debug(f'parse_shell: parsing tokens #: {len(tokens)}')

    if TRACE:
        logger_debug(f'parse_shell: calling parser.parse')

    parse_tree = parser.parse(tokens)

    if TRACE:
        logger_debug(f'parse_shell: got parse_tree: {parse_tree}')

    return parse_tree


if __name__ == '__main__':