Plan 9 from Bell Labs’s /usr/web/sources/contrib/stallion/root/sys/lib/python2.7/codeop.pyo

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


�`^c@s�dZddlZgejD]Zeee�^qZdddgZdZd�Zd�Z	d	d
d�Z
ddd��YZddd
��YZdS(s[Utilities to compile possibly incomplete Python source code.

This module provides two interfaces, broadly similar to the builtin
function compile(), which take program text, a filename and a 'mode'
and:

- Return code object if the command is complete and valid
- Return None if the command is incomplete
- Raise SyntaxError, ValueError or OverflowError if the command is a
  syntax error (OverflowError and ValueError can be produced by
  malformed literals).

Approach:

First, check if the source consists entirely of blank lines and
comments; if so, replace it with 'pass', because the built-in
parser doesn't always do the right thing for these.

Compile three times: as is, with \n, and with \n\n appended.  If it
compiles as is, it's complete.  If it compiles with one \n appended,
we expect more.  If it doesn't compile either way, we compare the
error we get when compiling with \n or \n\n appended.  If the errors
are the same, the code is broken.  But if the errors are different, we
expect more.  Not intuitive; not even guaranteed to hold in future
releases; but this matches the compiler's behavior from Python 1.4
through 2.2, at least.

Caveat:

It is possible (but not likely) that the parser stops parsing with a
successful outcome before reaching the end of the source; in this
case, trailing symbols may be ignored instead of causing an error.
For example, a backslash followed by two newlines may be followed by
arbitrary garbage.  This will be fixed once the API for the parser is
better.

The two interfaces are:

compile_command(source, filename, symbol):

    Compiles a single command in the manner described above.

CommandCompiler():

    Instances of this class have __call__ methods identical in
    signature to compile_command; the difference is that if the
    instance compiles program text containing a __future__ statement,
    the instance 'remembers' and compiles all subsequent program texts
    with the statement in force.

The module also provides another class:

Compile():

    Instances of this class act like the built-in function compile,
    but with 'memory' in the sense described above.
i�Ntcompile_commandtCompiletCommandCompilericCs6xR|jd�D],}|j�}|r|ddkrPqqW|dkrUd}nd}}}d}}	}
y||||�}Wntk
r�}nXy||d||�}	Wntk
r�}nXy||d||�}
Wntk
r�nX|r|S|	r2t|�t|�kr2t|�ndS(Ns
it#tevaltpasss

(tsplittstriptNonetSyntaxErrortrepr(tcompilertsourcetfilenametsymboltlineterrterr1terr2tcodetcode1tcode2((s/sys/lib/python2.7/codeop.pyt_maybe_compileDs0	cCst|||t�S(N(tcompiletPyCF_DONT_IMPLY_DEDENT(RR
R((s/sys/lib/python2.7/codeop.pyt_compileess<input>tsinglecCstt|||�S(ssCompile a command and determine whether it is incomplete.

    Arguments:

    source -- the source string; may contain \n characters
    filename -- optional filename from which source was read; default
                "<input>"
    symbol -- optional grammar start symbol; "single" (default) or "eval"

    Return value / exceptions raised:

    - Return a code object if the command is complete and valid
    - Return None if the command is incomplete
    - Raise SyntaxError, ValueError or OverflowError if the command is a
      syntax error (OverflowError and ValueError can be produced by
      malformed literals).
    (RR(RR
R((s/sys/lib/python2.7/codeop.pyRhscBs eZdZd�Zd�ZRS(s�Instances of this class behave much like the built-in compile
    function, but if one is used to compile text containing a future
    statement, it "remembers" and compiles all subsequent program texts
    with the statement in force.cCs
t|_dS(N(Rtflags(tself((s/sys/lib/python2.7/codeop.pyt__init__�scCsUt||||jd�}x3tD]+}|j|j@r"|j|jO_q"q"W|S(Ni(RRt	_featurestco_flagst
compiler_flag(RRR
Rtcodeobtfeature((s/sys/lib/python2.7/codeop.pyt__call__�s

(t__name__t
__module__t__doc__RR#(((s/sys/lib/python2.7/codeop.pyR|s	cBs&eZdZd�Zddd�ZRS(s(Instances of this class have __call__ methods identical in
    signature to compile_command; the difference is that if the
    instance compiles program text containing a __future__ statement,
    the instance 'remembers' and compiles all subsequent program texts
    with the statement in force.cCst�|_dS(N(RR(R((s/sys/lib/python2.7/codeop.pyR�ss<input>RcCst|j|||�S(s�Compile a command and determine whether it is incomplete.

        Arguments:

        source -- the source string; may contain \n characters
        filename -- optional filename from which source was read;
                    default "<input>"
        symbol -- optional grammar start symbol; "single" (default) or
                  "eval"

        Return value / exceptions raised:

        - Return a code object if the command is complete and valid
        - Return None if the command is incomplete
        - Raise SyntaxError, ValueError or OverflowError if the command is a
          syntax error (OverflowError and ValueError can be produced by
          malformed literals).
        (RR(RRR
R((s/sys/lib/python2.7/codeop.pyR#�s(R$R%R&RR#(((s/sys/lib/python2.7/codeop.pyR�s	(((
R&t
__future__tall_feature_namestfnametgetattrRt__all__RRRRRR(((s/sys/lib/python2.7/codeop.pyt<module>9s"	!	

Bell Labs OSI certified Powered by Plan 9

(Return to Plan 9 Home Page)

Copyright © 2021 Plan 9 Foundation. All Rights Reserved.
Comments to [email protected].