Plan 9 from Bell Labs’s /usr/web/sources/contrib/jas/root/sys/lib/python2.7/lib2to3/pgen2/parse.pyc

Copyright © 2021 Plan 9 Foundation.
Distributed under the MIT License.
Download the Plan 9 distribution.


��Qc@sFdZddlmZdefd��YZdefd��YZdS(s�Parser engine for the grammar tables generated by pgen.

The grammar table must be loaded first.

See Parser/parser.c in the Python distribution for additional info on
how this parsing engine works.

i(ttokent
ParseErrorcBseZdZd�ZRS(s(Exception to signal the parser is stuck.cCsHtj|d||||f�||_||_||_||_dS(Ns!%s: type=%r, value=%r, context=%r(t	Exceptiont__init__tmsgttypetvaluetcontext(tselfRRRR((s)/sys/lib/python2.7/lib2to3/pgen2/parse.pyRs			(t__name__t
__module__t__doc__R(((s)/sys/lib/python2.7/lib2to3/pgen2/parse.pyRstParsercBsSeZdZdd�Zdd�Zd�Zd�Zd�Zd�Z	d�Z
RS(	s5Parser engine.

    The proper usage sequence is:

    p = Parser(grammar, [converter])  # create instance
    p.setup([start])                  # prepare for parsing
    <for each input token>:
        if p.addtoken(...):           # parse a token; may raise ParseError
            break
    root = p.rootnode                 # root of abstract syntax tree

    A Parser instance may be reused by calling setup() repeatedly.

    A Parser instance contains state pertaining to the current token
    sequence, and should not be used concurrently by different threads
    to parse separate token sequences.

    See driver.py for how to get input tokens by tokenizing a file or
    string.

    Parsing is complete when addtoken() returns True; the root of the
    abstract syntax tree can then be retrieved from the rootnode
    instance variable.  When a syntax error occurs, addtoken() raises
    the ParseError exception.  There is no error recovery; the parser
    cannot be used after a syntax error was reported (but it can be
    reinitialized by calling setup()).

    cCs||_|pd�|_dS(s�Constructor.

        The grammar argument is a grammar.Grammar instance; see the
        grammar module for more information.

        The parser is not ready yet for parsing; you must call the
        setup() method to get it started.

        The optional convert argument is a function mapping concrete
        syntax tree nodes to abstract syntax tree nodes.  If not
        given, no conversion is done and the syntax tree produced is
        the concrete syntax tree.  If given, it must be a function of
        two arguments, the first being the grammar (a grammar.Grammar
        instance), and the second being the concrete syntax tree node
        to be converted.  The syntax tree is converted from the bottom
        up.

        A concrete syntax tree node is a (type, value, context, nodes)
        tuple, where type is the node type (a token or symbol number),
        value is None for symbols and a string for tokens, context is
        None or an opaque value used for error reporting (typically a
        (lineno, offset) pair), and nodes is a list of children for
        symbols, and None for tokens.

        An abstract syntax tree node may be anything; this is entirely
        up to the converter function.

        cSs|S(N((tgrammartnode((s)/sys/lib/python2.7/lib2to3/pgen2/parse.pyt<lambda>WsN(R
tconvert(RR
R((s)/sys/lib/python2.7/lib2to3/pgen2/parse.pyR9s	cCsk|dkr|jj}n|ddgf}|jj|d|f}|g|_d|_t�|_dS(s�Prepare for parsing.

        This *must* be called before starting to parse.

        The optional argument is an alternative start symbol; it
        defaults to the grammar's start symbol.

        You can use a Parser instance to parse any number of programs;
        each time you call setup() the parser is reset to an initial
        state determined by the (implicit or explicit) start symbol.

        iN(tNoneR
tstarttdfaststacktrootnodetsett
used_names(RRtnewnodet
stackentry((s)/sys/lib/python2.7/lib2to3/pgen2/parse.pytsetupYs
	cCs�|j|||�}x�tr�|jd\}}}|\}}	||}
xq|
D]\}}|jj|\}
}||kr
|
dks�t�|j||||�|}xV||d|fgkr|j�|js�S|jd\}}}|\}}	q�WtS|
dkrQ|jj	|
}|\}}||kre|j
|
|jj	|
||�PqeqQqQWd|f|
kr�|j�|js�td|||��q�qtd|||��qWdS(s<Add a token; return True iff this is the end of the program.i�iistoo much inputs	bad inputN(tclassifytTrueRR
tlabelstAssertionErrortshifttpoptFalseRtpushR(RRRRtilabeltdfatstateRtstatestfirsttarcstitnewstatetttvtitsdfat	itsstatestitsfirst((s)/sys/lib/python2.7/lib2to3/pgen2/parse.pytaddtokenqs<	

	 
	cCs�|tjkrG|jj|�|jjj|�}|dk	rG|Sn|jjj|�}|dkr�t	d|||��n|S(s&Turn a token into a label.  (Internal)s	bad tokenN(
RtNAMERtaddR
tkeywordstgetRttokensR(RRRRR#((s)/sys/lib/python2.7/lib2to3/pgen2/parse.pyR�sc	Csw|jd\}}}|||df}|j|j|�}|dk	r]|dj|�n|||f|jd<dS(sShift a token.  (Internal)i�N(RRRR
tappend(	RRRR*RR$R%RR((s)/sys/lib/python2.7/lib2to3/pgen2/parse.pyR�sc	Cs[|jd\}}}|d|gf}|||f|jd<|jj|d|f�dS(sPush a nonterminal.  (Internal)i�iN(RRR6(	RRtnewdfaR*RR$R%RR((s)/sys/lib/python2.7/lib2to3/pgen2/parse.pyR"�scCs�|jj�\}}}|j|j|�}|dk	r�|jrl|jd\}}}|dj|�q�||_|j|j_ndS(sPop a nonterminal.  (Internal)i�N(RR RR
RR6RR(RtpopdfatpopstatetpopnodeRR$R%R((s)/sys/lib/python2.7/lib2to3/pgen2/parse.pyR �s		N(R	R
RRRRR0RRR"R (((s)/sys/lib/python2.7/lib2to3/pgen2/parse.pyRs 	0				N(RtRRRtobjectR(((s)/sys/lib/python2.7/lib2to3/pgen2/parse.pyt<module>s

Bell Labs OSI certified Powered by Plan 9

(Return to Plan 9 Home Page)

Copyright © 2021 Plan 9 Foundation. All Rights Reserved.
Comments to webmaster@9p.io.