ꦫꦣꦺꦤ꧀ꦄꦤ꧀ꦠꦱꦺꦤ

PATH: opt / alt / python311 / lib64 / python3.11

r"""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).

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.
"""

import __future__
import warnings

_features = [getattr(__future__, fname)
             for fname in __future__.all_feature_names]

__all__ = ["compile_command", "Compile", "CommandCompiler"]

# The following flags match the values from Include/cpython/compile.h
# Caveat emptor: These flags are undocumented on purpose and depending
# on their effect outside the standard library is **unsupported**.
PyCF_DONT_IMPLY_DEDENT = 0x200
PyCF_ALLOW_INCOMPLETE_INPUT = 0x4000

def _maybe_compile(compiler, source, filename, symbol):
    # Check for source consisting of only blank lines and comments.
    for line in source.split("\n"):
        line = line.strip()
        if line and line[0] != '#':
            break               # Leave it alone.
    else:
        if symbol != "eval":
            source = "pass"     # Replace it with a 'pass' statement

# Disable compiler warnings when checking for incomplete input.
    with warnings.catch_warnings():
        warnings.simplefilter("ignore", (SyntaxWarning, DeprecationWarning))
        try:
            compiler(source, filename, symbol)
        except SyntaxError:  # Let other compile() errors propagate.
            try:
                compiler(source + "\n", filename, symbol)
                return None
            except SyntaxError as e:
                if "incomplete input" in str(e):
                    return None
                # fallthrough

return compiler(source, filename, symbol, incomplete_input=False)

def _is_syntax_error(err1, err2):
    rep1 = repr(err1)
    rep2 = repr(err2)
    if "was never closed" in rep1 and "was never closed" in rep2:
        return False
    if rep1 == rep2:
        return True
    return False

def _compile(source, filename, symbol, incomplete_input=True):
    flags = 0
    if incomplete_input:
        flags |= PyCF_ALLOW_INCOMPLETE_INPUT
        flags |= PyCF_DONT_IMPLY_DEDENT
    return compile(source, filename, symbol, flags)

def compile_command(source, filename="<input>", symbol="single"):
    r"""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), "exec"
              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).
    """
    return _maybe_compile(_compile, source, filename, symbol)

class Compile:
    """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."""
    def __init__(self):
        self.flags = PyCF_DONT_IMPLY_DEDENT | PyCF_ALLOW_INCOMPLETE_INPUT

def __call__(self, source, filename, symbol, **kwargs):
        flags = self.flags
        if kwargs.get('incomplete_input', True) is False:
            flags &= ~PyCF_DONT_IMPLY_DEDENT
            flags &= ~PyCF_ALLOW_INCOMPLETE_INPUT
        codeob = compile(source, filename, symbol, flags, True)
        for feature in _features:
            if codeob.co_flags & feature.compiler_flag:
                self.flags |= feature.compiler_flag
        return codeob

class 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."""

def __init__(self,):
        self.compiler = Compile()

def __call__(self, source, filename="<input>", symbol="single"):
        r"""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).
        """
        return _maybe_compile(self.compiler, source, filename, symbol)

[+] ..
[-] zipfile.py [edit]
[-] signal.py [edit]
[-] tabnanny.py [edit]
[-] cmd.py [edit]
[-] cProfile.py [edit]
[-] tempfile.py [edit]
[-] __hello__.py [edit]
[-] argparse.py [edit]
[-] platform.py [edit]
[-] antigravity.py [edit]
[+] curses
[-] _compat_pickle.py [edit]
[-] statistics.py [edit]
[-] inspect.py [edit]
[-] ipaddress.py [edit]
[-] sunau.py [edit]
[-] imghdr.py [edit]
[-] random.py [edit]
[-] hmac.py [edit]
[-] base64.py [edit]
[-] cgitb.py [edit]
[-] stringprep.py [edit]
[-] ast.py [edit]
[-] textwrap.py [edit]
[-] zipimport.py [edit]
[-] enum.py [edit]
[-] _compression.py [edit]
[-] dis.py [edit]
[+] venv
[-] chunk.py [edit]
[-] this.py [edit]
[-] py_compile.py [edit]
[-] fnmatch.py [edit]
[+] xml
[-] opcode.py [edit]
[+] site-packages
[-] sre_compile.py [edit]
[-] _pyio.py [edit]
[-] graphlib.py [edit]
[-] LICENSE.txt [edit]
[-] pty.py [edit]
[-] datetime.py [edit]
[+] lib2to3
[+] wsgiref
[-] heapq.py [edit]
[-] keyword.py [edit]
[-] codecs.py [edit]
[+] ensurepip
[-] pickletools.py [edit]
[-] compileall.py [edit]
[-] nturl2path.py [edit]
[-] warnings.py [edit]
[-] shutil.py [edit]
[-] socket.py [edit]
[-] pdb.py [edit]
[-] dataclasses.py [edit]
[-] zipapp.py [edit]
[-] _sitebuiltins.py [edit]
[+] zoneinfo
[-] _markupbase.py [edit]
[-] types.py [edit]
[-] runpy.py [edit]
[-] uu.py [edit]
[-] typing.py [edit]
[-] pathlib.py [edit]
[-] _threading_local.py [edit]
[-] mailcap.py [edit]
[+] config-3.11-x86_64-linux-gnu
[-] bisect.py [edit]
[-] linecache.py [edit]
[+] tomllib
[-] colorsys.py [edit]
[+] __phello__
[-] glob.py [edit]
[-] sndhdr.py [edit]
[-] ssl.py [edit]
[-] _strptime.py [edit]
[-] imp.py [edit]
[-] contextlib.py [edit]
[-] contextvars.py [edit]
[-] copyreg.py [edit]
[-] filecmp.py [edit]
[+] logging
[-] _sysconfigdata_d_linux_x86_64-linux-gnu.py [edit]
[-] operator.py [edit]
[-] token.py [edit]
[-] gzip.py [edit]
[-] string.py [edit]
[-] genericpath.py [edit]
[-] _osx_support.py [edit]
[-] stat.py [edit]
[-] lzma.py [edit]
[-] __future__.py [edit]
[+] distutils
[+] asyncio
[-] webbrowser.py [edit]
[-] symtable.py [edit]
[+] lib-dynload
[-] getopt.py [edit]
[-] wave.py [edit]
[-] _bootsubprocess.py [edit]
[-] codeop.py [edit]
[-] abc.py [edit]
[+] pydoc_data
[-] telnetlib.py [edit]
[-] _aix_support.py [edit]
[+] unittest
[-] fileinput.py [edit]
[-] ftplib.py [edit]
[+] ctypes
[-] pipes.py [edit]
[-] aifc.py [edit]
[-] pprint.py [edit]
[-] queue.py [edit]
[-] difflib.py [edit]
[+] __pycache__
[-] uuid.py [edit]
[-] reprlib.py [edit]
[-] threading.py [edit]
[+] http
[-] sre_parse.py [edit]
[-] subprocess.py [edit]
[+] importlib
[-] selectors.py [edit]
[-] getpass.py [edit]
[-] trace.py [edit]
[-] struct.py [edit]
[-] tracemalloc.py [edit]
[-] plistlib.py [edit]
[-] asynchat.py [edit]
[-] fractions.py [edit]
[-] shlex.py [edit]
[-] bdb.py [edit]
[-] locale.py [edit]
[-] calendar.py [edit]
[-] poplib.py [edit]
[-] posixpath.py [edit]
[-] imaplib.py [edit]
[+] concurrent
[-] pickle.py [edit]
[-] timeit.py [edit]
[+] json
[-] traceback.py [edit]
[+] multiprocessing
[-] shelve.py [edit]
[-] csv.py [edit]
[-] tarfile.py [edit]
[-] numbers.py [edit]
[-] optparse.py [edit]
[-] cgi.py [edit]
[-] pstats.py [edit]
[-] crypt.py [edit]
[+] collections
[-] site.py [edit]
[-] pkgutil.py [edit]
[-] pyclbr.py [edit]
[-] socketserver.py [edit]
[-] _pydecimal.py [edit]
[-] pydoc.py [edit]
[-] sre_constants.py [edit]
[-] xdrlib.py [edit]
[-] nntplib.py [edit]
[-] mimetypes.py [edit]
[+] email
[-] quopri.py [edit]
[-] doctest.py [edit]
[-] profile.py [edit]
[-] sched.py [edit]
[-] hashlib.py [edit]
[+] urllib
[-] secrets.py [edit]
[-] _sysconfigdata__linux_x86_64-linux-gnu.py [edit]
[-] functools.py [edit]
[-] smtplib.py [edit]
[-] copy.py [edit]
[+] dbm
[-] tty.py [edit]
[-] os.py [edit]
[-] _collections_abc.py [edit]
[-] configparser.py [edit]
[-] _weakrefset.py [edit]
[-] netrc.py [edit]
[-] code.py [edit]
[-] asyncore.py [edit]
[-] _py_abc.py [edit]
[-] tokenize.py [edit]
[+] re
[+] encodings
[-] io.py [edit]
[-] smtpd.py [edit]
[-] sysconfig.py [edit]
[-] decimal.py [edit]
[+] sqlite3
[-] rlcompleter.py [edit]
[-] ntpath.py [edit]
[-] weakref.py [edit]
[-] modulefinder.py [edit]
[+] xmlrpc
[-] bz2.py [edit]
[-] gettext.py [edit]
[-] mailbox.py [edit]
[+] html